Behandeln von Fehlern mithilfe der MedTech-Dienstprotokolle
Hinweis
Fast Healthcare Interoperability Resources (FHIR®) ist eine offene Spezifikation für das Gesundheitswesen.
Dieser Artikel enthält Schritte zur Problembehandlung und Fehlerbehebungen für Fehler, die in den MedTech-Dienstprotokollen gefunden wurden.
Tipp
Zugriff auf MedTech-Dienstprotokolle ist für die Problembehandlung und die Bewertung der Allgemeinen Integrität und Leistung Ihres MedTech-Diensts von entscheidender Bedeutung.
Informationen zum Zugreifen auf die MedTech-Dienstprotokolle finden Sie unter Aktivieren von Diagnoseeinstellungen für den MedTech-Dienst.
Schweregrad des MedTech-Dienstfehlers
Diese Eigenschaft stellt den Schweregrad des aufgetretenen Fehlers dar. Im Folgenden finden Sie eine Liste der möglichen Werte für diese Eigenschaft:
severity | BESCHREIBUNG |
---|---|
Nicht blockierend | Im Datenflussprozess liegt ein Problem vor, die Verarbeitung von Gerätenachrichten wird jedoch nicht beendet. |
Blockierung | Im Datenflussprozess liegt ein Problem vor, und es wird erwartet, dass keine Gerätenachrichten verarbeitet werden. |
Der Betrieb wird vom MedTech-Dienst ausgeführt
Diese Eigenschaft stellt den Vorgang dar, der vom MedTech-Dienst ausgeführt wird, wenn der Fehler aufgetreten ist. Ein Vorgang stellt im Allgemeinen die Datenflussphase dar, in der eine Gerätenachricht verarbeitet wird. Die Datenflussphase wird in den Fehlerprotokollen als OperationName angezeigt. Im Folgenden finden Sie eine Liste der möglichen Werte für diese Eigenschaft:
Vorgangsname | BESCHREIBUNG |
---|---|
Normalisierung | Die Datenflussphase, in der die Gerätenachricht normalisiert wird. |
FHIRConversion | Die Datenflussphase, in der die gruppierten normalisierten Daten in eine Observation-Ressource transformiert werden. |
Hinweis
Weitere Informationen zur Transformation von Nachrichtendaten für MedTech-Dienstgeräte finden Sie unter Übersicht über die Datenverarbeitungsphasen für MedTech-Dienstgeräte.
Ausnahmen und Fehlerbehebungen bei der Integritätsprüfung des MedTech-Diensts
Integritätsprüfungen werden automatisch und regelmäßig durchgeführt, um zu überprüfen, ob ein MedTech-Dienst Gerätenachrichten normalisieren und transformieren kann. Wenn eine Integritätsprüfung nicht bestanden wurde, tritt eine HealthCheckException auf und wird protokolliert.
In den MedTech-Dienstprotokollen wird ein Fehler bei der Integritätsprüfung mit dem ProtokolltypHealthCheckException protokolliert, und der Name der fehlerhaften Integritätsprüfung wird in der Nachricht protokolliert.
Die Namen der Integritätsprüfungen sind in der folgenden Tabelle aufgeführt, und die Fehlerbehebungen für alle fehler werden unten in der Tabelle beschrieben:
HealthCheck |
---|
CredentialStore:IsCustomerFacingMiCredentialBundlePresent |
ExternalEventHub:IsAuthenticated |
FhirService:IsAuthenticated |
Hinweis
Während eine HealthCheckException ein blockierende Problem ist, kann es vorübergehend sein und sich ohne Intervention selbst lösen.
CredentialStore:IsCustomerFacingMiCredentialBundlePresent
Beschreibung: Überprüft, ob die systemseitig zugewiesene verwaltete Identität eines MedTech-Diensts aktiviert wurde oder ob eine benutzerseitig zugewiesene verwaltete Identität konfiguriert ist.
Schweregrad: Blockieren
Fix: Befolgen Sie die unter ManagedIdentityCredentialNotFound beschriebene Korrektur.
ExternalEventHub:IsAuthenticated
Beschreibung: Überprüft, ob der Event Hub gültig ist und ob der MedTech-Dienst Zugriff darauf hat.
Schweregrad: Blockieren
Fix: Stellen Sie sicher, dass Ihr Event Hub gültig ist, indem Sie die unter InvalidEventHubException beschriebene Korrektur ausführen. Stellen Sie dann sicher, dass Ihr MedTech-Dienst Zugriff auf Ihren Event Hub erhält, indem Sie die unter UnauthorizedAccessEventHubException beschriebene Korrektur ausführen.
FhirService:IsAuthenticated
Beschreibung: Überprüft, ob das FHIR-Ziel gültig ist und ob der MedTech-Dienst Schreibzugriff darauf hat.
Schweregrad: Blockieren
Fix: Stellen Sie sicher, dass Ihr FHIR-Ziel gültig ist, indem Sie die unter InvalidFhirServiceException beschriebene Korrektur ausführen. Stellen Sie dann sicher, dass Ihr MedTech-Dienst über Schreibzugriff auf Ihr FHIR-Ziel verfügt, indem Sie die unter UnauthorizedAccessFhirServiceException beschriebene Korrektur ausführen.
MedTech-Dienstfehler und Fehlerbehebungen
Wenn beim Normalisieren oder Transformieren von Gerätemeldungen ein Fehler auftritt, wird er protokolliert.
In den MedTech-Dienstprotokollen wird der Name des Fehlers in LogType protokolliert.
Die Fehlernamen sind in der folgenden Tabelle aufgeführt, und die Fehlerbehebungen für sie werden unter der Tabelle angegeben:
CorrelationIdNotDefinedException
Beschreibung: Wenn ein CorrelationIdExpression (der Ausdruck zum Analysieren des Korrelationsbezeichners aus der Gerätenachricht) in der Gerätezuordnung angegeben wird, tritt dieser Fehler auf, wenn der Korrelationsbezeichner in einer Gerätenachricht nicht vorhanden ist oder wenn CorrelationIdExpression in der Gerätezuordnung nicht ordnungsgemäß konfiguriert ist. Hinweis: CorrelationIdExpression ist optional. Dieser Fehler tritt auf, wenn Messungen, die denselben Geräte-, Typ- und Korrelationsbezeichner verwenden, in einer einzelnen FHIR-Beobachtungsressource gruppiert werden.
Schweregrad: Blockieren
Korrektur:
Wenn CorrelationIdExpression benötigt wird: Stellen Sie sicher, dass Ihre Gerätenachrichten den Korrelationsbezeichner enthalten. Navigieren Sie außerdem auf der Azure-Portal zum Blatt Gerätezuordnung Ihres MedTech-Diensts, und stellen Sie sicher, dass der
correlationIdExpression
Wert in der Gerätezuordnung vorhanden ist und ordnungsgemäß auf den Schlüssel des Korrelationsbezeichners in Ihren Gerätenachrichten verweist.Wenn CorrelationIdExpression nicht benötigt wird: Navigieren Sie auf der Azure-Portal zum Blatt Gerätezuordnung Ihres MedTech-Diensts, und entfernen Sie die Zeile, die in der Gerätezuordnung enthalten ist
correlationIdExpression
.
FhirDataMappingException
Beschreibung: Fehler beim Transformieren normalisierter Daten mit der FHIR-Zielzuordnung. Dieser Fehler tritt auf, wenn eine Vorlage, die den normalisierten Daten entspricht, nicht in der FHIR-Zielzuordnung definiert ist.
Schweregrad: Blockieren
Behebung: Wechseln Sie auf der Azure-Portal zum Blatt Gerätezuordnung und Zum Blatt Ziel Ihres MedTech-Diensts, und stellen Sie sicher, dass für jede Vorlage in der Gerätezuordnung eine Vorlage mit demselben typeName
Wert in der FHIR-Zielzuordnung vorhanden ist. Beheben Sie außerdem alle Validierungsfehler, die beim Bearbeiten und Speichern der FHIR-Zielzuordnung auf dem Blatt Ziel angezeigt werden.
FhirResourceNotFoundException
Beschreibung: Dieser Fehler tritt auf, wenn eine FHIR-Ressource mit dem in der Gerätenachricht angegebenen Bezeichner im FHIR-Ziel nicht gefunden werden kann. Wenn der Typ der FHIR-Ressource Patient lautet, kann der Fehler darin bestehen, dass die Device FHIR-Ressource mit dem in der Gerätenachricht angegebenen Gerätebezeichner nicht auf eine Patient FHIR-Ressource verweist. Der Typ der FHIR-Ressource (z. B. Gerät, Patient, Begegnung oder Beobachtung) wird in der Fehlermeldung angegeben. Hinweis: Dieser Fehler kann nur auftreten, wenn der Auflösungstyp des MedTech-Diensts auf Suchen festgelegt ist.
Schweregrad: Nicht blockierend
Fix: Stellen Sie sicher, dass Ihre Gerätemeldungen den Bezeichner für die FHIR-Ressource enthalten, die den in der Fehlermeldung angegebenen Typ aufweist. Navigieren Sie außerdem auf der Azure-Portal zum Blatt Gerätezuordnung Ihres MedTech-Diensts, und stellen Sie sicher, deviceIdExpression
dass der {FHIR resource’s type specified in the error message}IdExpression
Wert (z. B. ) in der Gerätezuordnung vorhanden ist und ordnungsgemäß auf den Schlüssel des Bezeichners in Ihren Gerätenachrichten verweist.
IncompatibleDataException
Beschreibung: Es besteht eine Inkompatibilität zwischen der Gerätenachricht und der Gerätezuordnung (z. B. kann eine erforderliche Eigenschaft in der Gerätenachricht und/oder in der Gerätezuordnung fehlen oder leer sein). Die Gerätezuordnungseigenschaft mit dem Fehler wird in der Fehlermeldung angegeben.
Schweregrad: Nicht blockierend
Fix: Stellen Sie sicher, dass Ihre Gerätenachrichten Folgendes enthalten:
Der Schlüssel, auf den durch die in der Fehlermeldung angegebene Gerätezuordnungseigenschaft verwiesen wird.
Ein nicht leerer Wert für den Schlüssel.
Navigieren Sie außerdem auf der Azure-Portal zum Blatt Gerätezuordnung Ihres MedTech-Diensts, und stellen Sie sicher, dass die in der Fehlermeldung angegebene Gerätezuordnungseigenschaft einen Wert aufweist, der ordnungsgemäß auf den entsprechenden Schlüssel in Ihren Gerätenachrichten verweist.
InvalidDataFormatException
Beschreibung: Eine Gerätenachricht hat kein Format, das in ein JSON-Objekt analysiert werden kann.
Schweregrad: Nicht blockierend
Fix: Stellen Sie sicher, dass Ihre Gerätenachrichten im JSON-Format vorliegen. Eine Möglichkeit zum Bestätigen des JSON-Formats ist die Verwendung eines JSON-Online-Validierungssteuerelements.
InvalidEventHubException
Beschreibung: Der Event Hub ist aus einem der folgenden Gründe ungültig:
Mindestens eine der Event Hub-Details (Event Hubs-Namespace, Event Hub-Name oder Consumergruppe) ist falsch formatiert oder nicht vorhanden. Der Event Hubs-Namespace sollte den Event Hub enthalten, und der Event Hub sollte die Consumergruppe enthalten.
Mehr als ein Dienst liest aus der Event Hub-Consumergruppe.
Schweregrad: Blockieren
Behebung: Navigieren Sie auf der Azure-Portal zum Blatt Event Hubs Ihres MedTech-Diensts, und stellen Sie sicher, dass alle Felder für die Event Hub-Details ausgefüllt sind. Um sicherzustellen, dass nur Ihr MedTech-Dienst aus der Consumergruppe liest, führen Sie eine der folgenden Aktionen aus:
Gehen Sie Ihre Dienste durch, und stellen Sie sicher, dass Ihr MedTech-Dienst der einzige Dienst ist, der auf die Consumergruppe zugreift.
Wechseln Sie zu Ihrem Event Hub im Azure-Portal, erstellen Sie eine neue Consumergruppe, auf die nur Ihr MedTech-Dienst zugreift, wechseln Sie zum Blatt Event Hubs Ihres MedTech-Diensts, und wählen Sie im Feld Consumergruppe Ihre neue Consumergruppe aus.
InvalidFhirServiceException
Beschreibung: Das FHIR-Ziel ist ungültig, da es falsch formatiert ist, nicht vorhanden ist oder kein FHIR-Dienst in Azure Health Data Services ist.
Schweregrad: Blockieren
Behebung: Navigieren Sie auf der Azure-Portal zum Blatt Ziel Ihres MedTech-Diensts, und stellen Sie sicher, dass das Feld FHIR-Server ordnungsgemäß ausgefüllt ist.
InvalidQuantityFhirValueException
Beschreibung: Der Wert mit einem Quantity-Ressourcendatentyp ist ungültig (z. B. in einem Format, das nicht unterstützt wird). Der Wert mit dem Fehler wird in der Fehlermeldung angegeben.
Schweregrad: Nicht blockierend
Fix: Stellen Sie sicher, dass die Werte in Ihren Gerätenachrichten gemäß den FHIR Quantity.value-Spezifikationen in unterstützten Datentypen enthalten sind.
InvalidTemplateException
Beschreibung: Es gibt einen Fehler mit einer Vorlage in der Gerätezuordnung oder der FHIR-Zielzuordnung. Zu den Fehlern gehören:
Der Vorlagentyp einer Vorlage (dargestellt durch die
templateType
-Eigenschaft) fehlt oder weist einen leeren Wert auf.Eine Vorlage (dargestellt durch die
template
-Eigenschaft) unter der Stammsammlungsvorlage verfügt nicht über ein JSON-Objekt, das durch geschweifte Klammern{}
als Wert identifiziert wird.Der Typ einer Vorlage (dargestellt durch die
typeName
-Eigenschaft) fehlt oder weist einen leeren Wert auf.Mehrere Vorlagen in einer Zuordnung haben denselben Typ (hat denselben Wert für ihre
typeName
Eigenschaft).
Der Typ und die Zeile der Vorlage mit dem Fehler werden in der Fehlermeldung angegeben.
Schweregrad: Blockieren
Behebung: Navigieren Sie auf der Azure-Portal zum Blatt Gerätezuordnung (wenn fehler in der Gerätezuordnung vorhanden ist) oder zum Blatt Ziel (wenn der Fehler in der FHIR-Zielzuordnung liegt) Ihres MedTech-Diensts, und korrigieren Sie die in der Fehlermeldung angegebene Vorlage.
ManagedIdentityCredentialNotFound
Beschreibung: Wenn der MedTech-Dienst eine Verbindung mit dem Event Hub herstellt, ist die systemseitig zugewiesene verwaltete Identität des MedTech-Diensts deaktiviert oder nicht vorhanden, oder eine benutzerseitig zugewiesene verwaltete Identität ist für den MedTech-Dienst nicht konfiguriert. Hinweis: Dieser Fehler kann auftreten, wenn der MedTech-Dienst mithilfe einer falsch konfigurierten ARM-Vorlage (Azure Resource Manager) bereitgestellt wurde.
Schweregrad: Blockieren
Fix: Der Fix hängt vom Typ der verwalteten Identität ab, die Sie verwenden möchten. Der Unterschied zwischen einer systemseitig zugewiesenen und einer benutzerseitig zugewiesenen verwalteten Identität kann unter Verwaltete Identitätstypen überprüft werden. Hinweis: Der MedTech-Dienst unterstützt nur eine Identität: entweder eine systemseitig zugewiesene verwaltete Identität oder eine einzelne benutzerseitig zugewiesene verwaltete Identität.
Wenn Sie eine systemseitig zugewiesene verwaltete Identität verwenden möchten:
Wenn Sie einen MedTech-Dienst mithilfe einer ARM-Vorlage bereitstellen, stellen Sie sicher, dass Ihre MedTech-Dienstressource in der ARM-Vorlage über eine
identity
Eigenschaft mit demtype
Wert von"SystemAssigned"
verfügt (siehe ARM-Beispielvorlage in der Datei azuredeploy.json auf GitHub).Wechseln Sie auf der Azure-Portal zum Blatt Identität Ihres MedTech-Diensts, wechseln Sie zur Registerkarte Systemseitig zugewiesen, und stellen Sie Folgendes sicher:
- Der Status ist auf Ein festgelegt.
- Die Azure-Rollenzuweisungen zeigen, dass Ihr Event Hub über eine Azure Event Hubs Datenempfängerrolle verfügt, die der systemseitig zugewiesenen verwalteten Identität Ihres MedTech-Diensts zugewiesen ist. Falls nicht, befolgen Sie diese Anweisungen.
Wenn Sie eine benutzerseitig zugewiesene verwaltete Identität verwenden möchten:
Stellen Sie sicher, dass Sie über eine benutzerseitig zugewiesene verwaltete Identität verfügen. Falls nicht, erstellen Sie eine mit dem Azure-Portal oder einer ARM-Vorlage.
Wenn Sie einen MedTech-Dienst mithilfe einer ARM-Vorlage bereitstellen, stellen Sie sicher, dass Ihre MedTech-Dienstressource in der ARM-Vorlage über eine
identity
Eigenschaft verfügt, die 1) den Wert und 2) einenuserAssignedIdentities
Wert enthält, dertype
"userAssigned"
den Namen Ihrer benutzerseitig zugewiesenen verwalteten Identität enthält (siehe Beispiel unter Zuweisen einer benutzerseitig zugewiesenen verwalteten Identität zu einer Azure-VM).Wechseln Sie auf der Azure-Portal zum Blatt Identität Ihres MedTech-Diensts, navigieren Sie zur Registerkarte Benutzerseitig zugewiesen, und stellen Sie sicher, dass Ihre benutzerseitig zugewiesene verwaltete Identität angezeigt wird. Wenn nicht, fügen Sie Ihre benutzerseitig zugewiesene verwaltete Identität hinzu (siehe Beispiel unter Zuweisen einer benutzerseitig zugewiesenen verwalteten Identität zu einer vorhandenen VM).
Wechseln Sie auf der Azure-Portal zu Ihrem Event Hub, und weisen Sie die Rolle Azure Event Hubs Datenempfänger der benutzerseitig zugewiesenen verwalteten Identität Ihres MedTech-Diensts zu (siehe Anweisungen, aber verwenden Sie die benutzerseitig zugewiesene verwaltete Identität anstelle der systemseitig zugewiesenen verwalteten Identität).
MultipleResourceFoundException
Beschreibung: Mehrere FHIR-Ressourcen mit demselben Bezeichner, der aus der Gerätenachricht stammt, werden im FHIR-Ziel gefunden, aber es sollte nur eine FHIR-Ressource gefunden worden sein. Der Typ der FHIR-Ressource (z. B. Gerät, Patient, Begegnung oder Beobachtung) wird in der Fehlermeldung angegeben.
Schweregrad: Nicht blockierend
Fix: Stellen Sie sicher, dass ein Bezeichner nicht mehr als einer FHIR-Ressource zugewiesen ist, deren Typ in der Fehlermeldung angegeben ist.
NormalizationDataMappingException
Beschreibung: Fehler beim Normalisieren einer Gerätenachricht mit der Gerätezuordnung.
Schweregrad: Blockieren
Behebung: Wechseln Sie auf der Azure-Portal zum Blatt Gerätezuordnung Ihres MedTech-Diensts, und beheben Sie alle Validierungsfehler, die beim Bearbeiten und Speichern der Gerätezuordnung angezeigt werden.
PatientDeviceMismatchException
Beschreibung: Eine Geräteressource im FHIR-Ziel verweist auf eine Patient FHIR-Ressource mit einem Bezeichner, der nicht mit dem in der Gerätenachricht angegebenen Patientenbezeichner übereinstimmt (d. h., das Gerät ist mit einem anderen Patienten verknüpft).
Schweregrad: Nicht blockierend
Fix: Stellen Sie sicher, dass ein Patientenbezeichner nicht mehr als einem Gerät zugewiesen ist.
ResourceIdentityNotDefinedException
Beschreibung: Dieser Fehler tritt auf, wenn der Bezeichner der FHIR-Ressource in einer Gerätenachricht nicht vorhanden ist oder wenn der Ausdruck zum Analysieren des Bezeichners der FHIR-Ressource aus der Gerätemeldung nicht in der Gerätezuordnung konfiguriert ist. Der Typ der FHIR-Ressource (z. B. Gerät, Patient, Begegnung oder Beobachtung) wird in der Fehlermeldung angegeben. Hinweis: Dieser Fehler kann nur auftreten, wenn der Auflösungstyp des MedTech-Diensts auf Erstellen festgelegt ist.
Schweregrad: Nicht blockierend
Fix: Stellen Sie sicher, dass Ihre Gerätemeldungen den Bezeichner für die FHIR-Ressource enthalten, die den in der Fehlermeldung angegebenen Typ aufweist. Navigieren Sie außerdem auf der Azure-Portal zum Blatt Gerätezuordnung Ihres MedTech-Diensts, und stellen Sie sicher, deviceIdExpression
dass der {FHIR resource’s type specified in the error message}IdExpression
Wert (z. B. ) in der Gerätezuordnung vorhanden ist und ordnungsgemäß auf den Schlüssel des Bezeichners in Ihren Gerätenachrichten verweist.
TemplateExpressionException
Beschreibung: Es gibt einen Fehler mit einem Ausdruck in einer Vorlage innerhalb der Gerätezuordnung. Zu den Fehlern gehören:
Ein erforderlicher Ausdruck fehlt.
Die Sprache eines Ausdrucks (dargestellt durch die
language
-Eigenschaft) wird nicht unterstützt. Alle Vorlagentypen unterstützen Ausdrücke in JSONPath. nur der Vorlagentyp CalculatedContent unterstützt Ausdrücke in JMESPath.Der Wert eines Ausdrucks (dargestellt durch die
value
-Eigenschaft) ist gemäß der Syntax der Sprache des Ausdrucks falsch formatiert.
Der Ausdruck und die Zeile mit dem Fehler werden in der Fehlermeldung angegeben.
Schweregrad: Blockieren
Behebung: Navigieren Sie auf der Azure-Portal zum Blatt Gerätezuordnung Ihres MedTech-Diensts, und korrigieren Sie den in der Fehlermeldung angegebenen Ausdruck innerhalb der Gerätezuordnung.
TemplateNotFoundException
Beschreibung: Eine Vorlage in der Gerätezuordnung verfügt nicht über eine übereinstimmende Vorlage mit demselben Typ innerhalb der FHIR-Zielzuordnung. Der Typ der Vorlage wird in der Fehlermeldung angegeben.
Schweregrad: Nicht blockierend
Behebung: Navigieren Sie auf der Azure-Portal zum Blatt Gerätezuordnung und Zum Blatt Ziel Ihres MedTech-Diensts, und stellen Sie sicher, dass für jede Vorlage in der Gerätezuordnung eine Vorlage mit demselben typeName
Wert innerhalb der FHIR-Zielzuordnung vorhanden ist.
UnauthorizedAccessEventHubException
Beschreibung: Dem MedTech-Dienst fehlt der Zugriff auf den Event Hub.
Schweregrad: Blockieren
Behebung: Wechseln Sie auf der Azure-Portal zu Ihrem Event Hub, und weisen Sie Ihrem MedTech-Dienst die Rolle Azure Event Hubs Datenempfänger zu (siehe Anleitung).
UnauthorizedAccessFhirServiceException
Beschreibung: Dem MedTech-Dienst fehlt schreibzugriff auf das FHIR-Ziel.
Schweregrad: Blockieren
Behebung: Wechseln Sie auf der Azure-Portal zu Ihrem FHIR-Dienst, und weisen Sie Ihrem MedTech-Dienst die Rolle FHIR Data Writer zu (siehe Anweisungen).
Hinweis
Wenn Sie Ihr MedTech-Dienstproblem nicht mithilfe dieses Leitfadens zur Problembehandlung beheben können, können Sie ein Azure Technical Support-Ticket öffnen, das Kopien Ihrer Gerätenachricht und ihrer Geräte- und FHIR-Zielzuordnungen an Ihre Anfrage anfügt, um besser bei der Problemermittlung zu helfen.
Nächste Schritte
In diesem Artikel haben Sie erfahren, wie Sie Fehler mithilfe der MedTech-Dienstprotokolle beheben und beheben.
Informationen zu den häufig gestellten Fragen (FAQ) des MedTech-Diensts finden Sie unter
FHIR® ist eine eingetragene Marke von Health Level Seven International, eingetragen im U.S. Trademark Office und wird mit deren Genehmigung verwendet.