Megosztás a következőn keresztül:


A MedTech szolgáltatásnaplókkal kapcsolatos hibák elhárítása

Megjegyzés

A Fast Healthcare Interoperability Resources (FHIR®) egy nyílt egészségügyi specifikáció.

Ez a cikk hibaelhárítási lépéseket és javításokat tartalmaz a MedTech szolgáltatásnaplókban található hibákhoz.

Tipp

A MedTech szolgáltatás naplóihoz való hozzáférés elengedhetetlen a MedTech szolgáltatás általános állapotának és teljesítményének hibaelhárításához és értékeléséhez.

A MedTech szolgáltatásnaplókhoz való hozzáférésről további információt a Diagnosztikai beállítások engedélyezése a MedTech szolgáltatáshoz című témakörben talál.

A MedTech szolgáltatás hibájának súlyossága

Ez a tulajdonság a bekövetkezett hiba súlyosságát jelöli. Íme a tulajdonság lehetséges értékeinek listája:

Súlyosság Leírás
Nem blokkoló Probléma merült fel az adatfolyam-folyamatban, de az eszközüzenetek feldolgozása nem áll le.
Blokkolás Probléma merült fel az adatfolyam-folyamatban, és az eszközüzenetek feldolgozása nem várható.

A MedTech szolgáltatás által végrehajtott művelet

Ez a tulajdonság azt a műveletet jelöli, amelyet a MedTech szolgáltatás a hiba bekövetkezésekor hajt végre. A műveletek általában azt az adatfolyam-szakaszt jelölik, amelyben az eszközüzenetek feldolgozása történik. Az adatfolyam-szakasz OperationName néven jelenik meg a hibanaplókban. Íme a tulajdonság lehetséges értékeinek listája:

OperationName Description
Normalizálás Az adatfolyam-szakasz, ahol az eszközüzenet normalizálódik.
FHIRConversion Az adatfolyam-szakasz, amelyben a csoportosított-normalizált adatok megfigyelési erőforrássá alakulnak.

Megjegyzés

A MedTech szolgáltatás eszközüzenet-adatátalakításával kapcsolatos további információkért lásd : A MedTech szolgáltatás eszközadatok feldolgozási fázisainak áttekintése.

A MedTech szolgáltatás állapot-ellenőrzési kivételei és javításai

A rendszer automatikusan és rendszeres időközönként ellenőrzi, hogy a MedTech szolgáltatás képes-e normalizálni és átalakítani az eszközüzeneteket. Ha egy állapot-ellenőrzés nem sikerült, akkor a Rendszer HealthCheckException kivételt jelez, és naplózza.

A MedTech szolgáltatás naplóiban a rendszer állapot-ellenőrzési hibát naplóz a HealthCheckExceptionLogType típusával, a sikertelen állapot-ellenőrzés nevét pedig az üzenetben naplózza.

Az állapot-ellenőrzések nevei az alábbi táblázatban szerepelnek, és a hibák javításait az alábbi táblázat ismerteti:

Állapotellenőrzés
CredentialStore:IsCustomerFacingMiCredentialBundlePresent
ExternalEventHub:IsAuthenticated
FhirService:IsAuthenticated

Megjegyzés

Bár a HealthCheckException egy blokkolási probléma, átmeneti is lehet, és beavatkozás nélkül megoldhatja magát.

CredentialStore:IsCustomerFacingMiCredentialBundlePresent

Leírás: Ellenőrzi, hogy a MedTech szolgáltatás rendszer által hozzárendelt felügyelt identitása engedélyezve van-e, vagy felhasználó által hozzárendelt felügyelt identitás van-e konfigurálva.

Súlyosság: Blokkolás

Javítás: Kövesse a ManagedIdentityCredentialNotFound című cikkben leírt javítást.

ExternalEventHub:IsAuthenticated

Leírás: Ellenőrzi, hogy az eseményközpont érvényes-e, és hogy a MedTech szolgáltatás hozzáfér-e hozzá.

Súlyosság: Blokkolás

Javítás: Győződjön meg arról, hogy az eseményközpont érvényes, kövesse az InvalidEventHubException című cikkben ismertetett javítást. Ezután az UnauthorizedAccessEventHubException című cikkben ismertetett javítást követve győződjön meg arról, hogy a MedTech szolgáltatás hozzáfér az eseményközponthoz.

FhirService:IsAuthenticated

Leírás: Ellenőrzi, hogy az FHIR célhelye érvényes-e, és hogy a MedTech szolgáltatás rendelkezik-e írási hozzáféréssel.

Súlyosság: Blokkolás

Javítás: Győződjön meg arról, hogy az FHIR célhelye érvényes az InvalidFhirServiceException kivételben leírt javítást követve. Ezután győződjön meg arról, hogy a MedTech szolgáltatás írási hozzáféréssel rendelkezik az FHIR-célhelyhez az UnauthorizedAccessFhirServiceException kivételben leírt javítást követve.

A MedTech szolgáltatás hibái és javításai

Ha hiba történik az eszközüzenetek normalizálása vagy átalakítása során, akkor a rendszer naplózza.

A MedTech szolgáltatás naplóiban a hiba neve a LogType-ban van naplózva.

A hibák nevei az alábbi táblázatban szerepelnek, és a javításokat a táblázat alatt találja:

LogType
CorrelationIdNotDefinedException
FhirDataMappingException
FhirResourceNotFoundException
IncompatibleDataException
InvalidDataFormatException
InvalidEventHubException
InvalidFhirServiceException
InvalidQuantityFhirValueException
InvalidTemplateException
ManagedIdentityCredentialNotFound
MultipleResourceFoundException
NormalizationDataMappingException
PatientDeviceMismatchException
ResourceIdentityNotDefinedException
TemplateExpressionException
TemplateNotFoundException
UnauthorizedAccessEventHubException
UnauthorizedAccessFhirServiceException

CorrelationIdNotDefinedException

Leírás: Ha az eszközleképezésben meg van adva egy CorrelationIdExpression (az eszközüzenet korrelációs azonosítójának elemzésére szolgáló kifejezés), akkor ez a hiba akkor fordul elő, ha a korrelációs azonosító nincs jelen egy eszközüzenetben, vagy ha a CorrelationIdExpression nincs megfelelően konfigurálva az eszközleképezésben. Megjegyzés: A CorrelationIdExpression nem kötelező. Ez a hiba akkor fordul elő, ha az azonos eszközzel, típussal és korrelációs azonosítóval rendelkező méréseket egyetlen FHIR-megfigyelési erőforrásba csoportosítja.

Súlyosság: Blokkolás

Javítás:

  • Ha szükség van a CorrelationIdExpression kifejezésre: Győződjön meg arról, hogy az eszközüzenetek tartalmazzák a korrelációs azonosítót. A Azure Portal lépjen a MedTech szolgáltatás Eszközleképezés paneljére, és győződjön meg arról, hogy az correlationIdExpression eszközleképezés értéke létezik, és helyesen hivatkozik a korrelációs azonosító kulcsára az eszközüzenetekben.

  • Ha nincs szükség a CorrelationIdExpression kifejezésre: A Azure Portal lépjen a MedTech szolgáltatás Eszközleképezés paneljére, és távolítsa el az eszközleképezésben található correlationIdExpression sort.

FhirDataMappingException

Leírás: Hiba történt a normalizált adatok FHIR-célleképezéssel való átalakítása során. Ez a hiba akkor fordul elő, ha a normalizált adatoknak megfelelő sablon nincs definiálva az FHIR-célleképezésben.

Súlyosság: Blokkolás

Javítás: A Azure Portal lépjen az Eszközleképezés panelre és a MedTech szolgáltatás Cél paneljére, és győződjön meg arról, hogy az eszközleképezés minden sablonjához azonos typeName értékű sablon található az FHIR-célleképezésben. Emellett javítsa ki az FHIR-célleképezés a Cél panelen történő szerkesztésekor és mentésekor megjelenő érvényesítési hibákat.

FhirResourceNotFoundException

Leírás: Ez a hiba akkor fordul elő, ha az eszközüzenetben megadott azonosítójú FHIR-erőforrás nem található az FHIR célhelyén. Ha az FHIR-erőforrás típusa Patient, akkor a hiba az lehet, hogy az eszközüzenetben megadott eszközazonosítóval rendelkező Eszköz FHIR-erőforrás nem hivatkozik patient FHIR-erőforrásra. Az FHIR-erőforrás típusa (például Eszköz, Páciens, Találkozás vagy Megfigyelés) a hibaüzenetben van megadva. Megjegyzés: Ez a hiba csak akkor fordulhat elő, ha a MedTech szolgáltatás felbontástípusa Keresési értékre van állítva.

Súlyosság: Nem blokkoló

Javítás: Győződjön meg arról, hogy az eszközüzenetek tartalmazzák a hibaüzenetben megadott típusú FHIR-erőforrás azonosítóját. Emellett a Azure Portal lépjen a MedTech szolgáltatás Eszközleképezés paneljére, és győződjön meg arról, hogy az {FHIR resource’s type specified in the error message}IdExpression eszközleképezésben szereplő (például ) érték létezik, deviceIdExpressionés helyesen hivatkozik az azonosító kulcsára az eszközüzenetekben.

InkompatibilisDataException

Leírás: Inkompatibilitás áll fenn az eszközüzenet és az eszközleképezés között (előfordulhat például, hogy egy szükséges tulajdonság hiányzik vagy üres az eszközüzenetben és/vagy az eszközleképezésben). A hibával rendelkező eszközleképezési tulajdonság a hibaüzenetben van megadva.

Súlyosság: Nem blokkoló

Javítás: Győződjön meg arról, hogy az eszközüzenetei a következőt tartalmazzák:

  • A hibaüzenetben megadott eszközleképezési tulajdonság által hivatkozott kulcs.

  • A kulcs nem üres értéke.

Emellett a Azure Portal lépjen a MedTech szolgáltatás Eszközleképezés paneljére, és győződjön meg arról, hogy a hibaüzenetben megadott eszközleképezési tulajdonság olyan értékkel rendelkezik, amely helyesen hivatkozik az eszközüzenetek megfelelő kulcsára.

InvalidDataFormatException

Leírás: Az eszközüzenetek nem JSON-objektumba elemezhető formátumban vannak.

Súlyosság: Nem blokkoló

Javítás: Győződjön meg arról, hogy az eszközüzenetek JSON formátumban vannak. A JSON formátum megerősítésének egyik módja egy online JSON-érvényesítő használata.

InvalidEventHubException

Leírás: Az eseményközpont az alábbi okok valamelyike miatt érvénytelen:

  • Az eseményközpont legalább egyik részlete (Event Hubs-névtér, eseményközpont neve vagy fogyasztói csoport) helytelenül van formázva, vagy nem létezik. Az Event Hubs-névtérnek tartalmaznia kell az eseményközpontot, az eseményközpontnak pedig a fogyasztói csoportot.

  • Egynél több szolgáltatás olvas az eseményközpont fogyasztói csoportjából.

Súlyosság: Blokkolás

Javítás: A Azure Portal lépjen a MedTech szolgáltatás Event Hubs paneljére, és győződjön meg arról, hogy az eseményközpont adatainak összes mezője ki van töltve. Annak biztosítása érdekében, hogy csak a MedTech szolgáltatás olvassa be a fogyasztói csoportból a következőt:

  • Tekintse át a szolgáltatásokat, és győződjön meg arról, hogy a MedTech szolgáltatás az egyetlen olyan szolgáltatás, amely hozzáfér a fogyasztói csoporthoz.

  • Lépjen az eseményközpontba a Azure Portal, hozzon létre egy új fogyasztói csoportot, amelyhez csak a MedTech szolgáltatás fér hozzá, lépjen a MedTech szolgáltatás Event Hubs paneljére, és válassza ki az új fogyasztói csoportot a Fogyasztói csoport mezőben.

InvalidFhirServiceException

Leírás: Az FHIR-cél érvénytelen, mert helytelenül van formázva, nem létezik, vagy nem FHIR-szolgáltatás az Azure Health Data Servicesben.

Súlyosság: Blokkolás

Javítás: A Azure Portal lépjen a MedTech szolgáltatás Cél paneljére, és győződjön meg arról, hogy az FHIR-kiszolgáló mező helyesen van kitöltve.

InvalidQuantityFhirValueException

Leírás: A Quantity erőforrás adattípusú érték érvénytelen (például nem támogatott formátumban). A hibát tartalmazó érték a hibaüzenetben van megadva.

Súlyosság: Nem blokkoló

Javítás: Győződjön meg arról, hogy az eszközüzenetekben lévő értékek támogatott adattípusokban találhatók az FHIR Quantity.value specifikációinak megfelelően.

InvalidTemplateException

Leírás: Hiba történt egy sablonnal az eszközleképezésben vagy az FHIR-célleképezésben. A hibák közé tartoznak a következők:

  • A sablon sablontípusa (amelyet a templateType tulajdonság jelöl) hiányzik, vagy üres értékkel rendelkezik.

  • A gyökérgyűjtemény-sablon alatt lévő (a template tulajdonság által képviselt) sablon nem rendelkezik JSON-objektummal, amelyet a kapcsos zárójelek {}azonosítanak értékként.

  • A sablon típusa (amelyet a typeName tulajdonság jelöl) hiányzik, vagy üres értékkel rendelkezik.

  • Egy leképezés több sablonja is ugyanazzal a típussal rendelkezik (a tulajdonsága ugyanazzal az értékkel rendelkezik typeName ).

A sablon típusa és a hibával egy sor a hibaüzenetben van megadva.

Súlyosság: Blokkolás

Javítás: A Azure Portal lépjen az Eszközleképezés panelre (ha hiba van az eszközleképezésben) vagy a MedTech szolgáltatás Cél paneljén (ha a hiba az FHIR célleképezésében szerepel), és javítsa ki a hibaüzenetben megadott sablont.

ManagedIdentityCredentialNotFound

Leírás: Amikor a MedTech szolgáltatás csatlakozik az eseményközponthoz, a MedTech szolgáltatás rendszer által hozzárendelt felügyelt identitása le van tiltva, vagy nem létezik, vagy a felhasználó által hozzárendelt felügyelt identitás nincs konfigurálva a MedTech szolgáltatáshoz. Megjegyzés: Ez a hiba akkor fordulhat elő, ha a MedTech szolgáltatást helytelenül konfigurált Azure Resource Manager (ARM) sablonnal helyezték üzembe.

Súlyosság: Blokkolás

Javítás: A javítás a használni kívánt felügyelt identitás típusától függ. A rendszer által hozzárendelt és a felhasználó által hozzárendelt felügyelt identitások közötti különbség a felügyelt identitástípusokban tekinthető meg. Megjegyzés: A MedTech szolgáltatás csak egy identitást támogat: rendszer által hozzárendelt felügyelt identitást vagy egyetlen felhasználó által hozzárendelt felügyelt identitást.  

Ha rendszer által hozzárendelt felügyelt identitást szeretne használni:

  1. Ha egy MedTech-szolgáltatást ARM-sablonnal helyez üzembe, győződjön meg arról, hogy az ARM-sablonban lévő MedTech szolgáltatás erőforrása rendelkezik egy identity olyan tulajdonságtal, amely type az értékét "SystemAssigned" tartalmazza (lásd a gitHubazuredeploy.json fájljában található ARM-sablont).

  2. A Azure Portal lépjen a MedTech szolgáltatás Identitás paneljére, lépjen a Rendszerhez rendelt lapra, és győződjön meg arról, hogy a következők:

    • Az Állapot beállítás értéke Be.
    • Az Azure-szerepkör-hozzárendelések azt mutatják, hogy az eseményközpont egy Azure Event Hubs Data Receiver szerepkörrel rendelkezik, amely a MedTech szolgáltatás rendszer által hozzárendelt felügyelt identitásához van hozzárendelve. Ha nem, kövesse ezeket az utasításokat

Ha felhasználó által hozzárendelt felügyelt identitást szeretne használni:

  1. Győződjön meg arról, hogy rendelkezik felhasználó által hozzárendelt felügyelt identitással. Ha nem, hozzon létre egyet a Azure Portal vagy egy ARM-sablon használatával.

  2. Ha EGY ARM-sablonnal helyez üzembe egy MedTech szolgáltatást, győződjön meg arról, hogy az ARM-sablonban lévő MedTech szolgáltatás erőforrása rendelkezik egy identity olyan tulajdonságtal, amely 1) type az értéke "userAssigned" és 2) egy userAssignedIdentities olyan értékkel rendelkezik, amely tartalmazza a felhasználó által hozzárendelt felügyelt identitás nevét (lásd a felhasználó által hozzárendelt felügyelt identitás azure-beli virtuális géphez való hozzárendelését ismertető példát).

  3. A Azure Portal lépjen a MedTech szolgáltatás Identitás paneljére, lépjen a Felhasználó által hozzárendelt lapra, és győződjön meg arról, hogy megjelenik a felhasználó által hozzárendelt felügyelt identitás. Ha nem, adja hozzá a felhasználó által hozzárendelt felügyelt identitást (lásd: Felhasználó által hozzárendelt felügyelt identitás hozzárendelése meglévő virtuális géphez).

  4. A Azure Portal nyissa meg az eseményközpontot, és rendelje hozzá a Azure Event Hubs Adatfogadó szerepkört a MedTech szolgáltatás felhasználó által hozzárendelt felügyelt identitásához (lásd az utasításokat, de a rendszer által hozzárendelt felügyelt identitás helyett használja a felhasználó által hozzárendelt felügyelt identitást).

MultipleResourceFoundException

Leírás: Az FHIR-célhelyen több, azonos azonosítójú FHIR-erőforrás található, amelyek az eszközüzenetből származnak, de csak egy FHIR-erőforrást kellett volna megtalálni. Az FHIR-erőforrás típusa (például Eszköz, Beteg, Találkozás vagy Megfigyelés) meg van adva a hibaüzenetben.

Súlyosság: Nem blokkoló

Javítás: Győződjön meg arról, hogy egy azonosító nincs hozzárendelve egynél több FHIR-erőforráshoz, amely a hibaüzenetben megadott típussal rendelkezik.

NormalizationDataMappingException

Leírás: Hiba történt egy eszközüzenet normalizálása közben az eszközleképezéssel.

Súlyosság: Blokkolás

Javítás: A Azure Portal lépjen a MedTech szolgáltatás Eszközleképezés paneljére, és javítsa ki az eszközleképezés szerkesztésekor és mentésekor megjelenő érvényesítési hibákat.

PatientDeviceMismatchException

Leírás: Az FHIR-célhely eszközerőforrása egy beteg FHIR-erőforrásra hivatkozik olyan azonosítóval, amely nem egyezik meg az eszközüzenetben megadott betegazonosítóval (vagyis az eszköz egy másik beteghez van csatolva).

Súlyosság: Nem blokkoló

Javítás: Győződjön meg arról, hogy egy betegazonosító nincs hozzárendelve egynél több eszközhöz.

ResourceIdentityNotDefinedException

Leírás: Ez a hiba akkor fordul elő, ha az FHIR-erőforrás azonosítója nem szerepel egy eszközüzenetben, vagy ha az eszközleképezésben nincs konfigurálva az FHIR-erőforrás azonosítójának az eszközüzenetből való elemzésére vonatkozó kifejezés. Az FHIR-erőforrás típusa (például Eszköz, Beteg, Találkozás vagy Megfigyelés) meg van adva a hibaüzenetben. Megjegyzés: Ez a hiba csak akkor fordulhat elő, ha a MedTech szolgáltatás felbontástípusa Létrehozás értékre van állítva.

Súlyosság: Nem blokkoló

Javítás: Győződjön meg arról, hogy az eszközüzenetek tartalmazzák a hibaüzenetben megadott típusú FHIR-erőforrás azonosítóját. Emellett a Azure Portal lépjen a MedTech szolgáltatás Eszközleképezés paneljére, és győződjön meg arról, hogy az {FHIR resource’s type specified in the error message}IdExpression eszközleképezésben szereplő (például ) érték létezik, deviceIdExpressionés helyesen hivatkozik az azonosító kulcsára az eszközüzenetekben.

TemplateExpressionException

Leírás: Hiba történt egy kifejezéssel egy sablonban az eszközleképezésen belül. A hibák közé tartoznak a következők:

  • Hiányzik egy kötelező kifejezés.

  • A kifejezés nyelve (amelyet a language tulajdonság jelöl) nem támogatott. Minden sablontípus támogatja a JSONPath-kifejezéseket; csak a CalculatedContent sablontípus támogatja a JMESPath-kifejezések használatát.

  • A kifejezés (a tulajdonság által value képviselt) értéke helytelenül van formázva a kifejezés nyelvének szintaxisa szerint.

A hibaüzenetben meg van adva a kifejezés és a hibasor.

Súlyosság: Blokkolás

Javítás: A Azure Portal lépjen a MedTech szolgáltatás Eszközleképezés paneljére, és javítsa ki a hibaüzenetben megadott kifejezést az eszközleképezésen belül.

TemplateNotFoundException

Leírás: Az eszközleképezés egyik sablonja nem rendelkezik azonos típusú sablonnal az FHIR-célleképezésen belül. A sablon típusa a hibaüzenetben van megadva.

Súlyosság: Nem blokkoló

Javítás: A Azure Portal lépjen az Eszközleképezés panelre és a MedTech szolgáltatás Cél paneljére, és győződjön meg arról, hogy az eszközleképezés minden sablonjához ugyanazzal typeName az értékkel rendelkező sablon található az FHIR célleképezésben.

UnauthorizedAccessEventHubException

Leírás: A MedTech szolgáltatás nem kap hozzáférést az eseményközponthoz.

Súlyosság: Blokkolás

Javítás: A Azure Portal lépjen az eseményközpontba, és rendelje hozzá a Azure Event Hubs Adatfogadó szerepkört a MedTech szolgáltatáshoz (lásd az utasításokat).

UnauthorizedAccessFhirServiceException

Leírás: A MedTech szolgáltatás nem rendelkezik írási hozzáféréssel az FHIR célhelyéhez.

Súlyosság: Blokkolás

Javítás: A Azure Portal lépjen az FHIR szolgáltatáshoz, és rendelje hozzá az FHIR adatíró szerepkört a MedTech szolgáltatáshoz (lásd az utasításokat).

Megjegyzés

Ha ezzel a hibaelhárítási útmutatóval nem tudja kijavítani a MedTech szolgáltatással kapcsolatos problémát, megnyithat egy Azure műszaki támogatási jegyet, amely az eszközüzenet és az eszköz és az FHIR célleképezéseinek másolatait csatolja a kéréséhez, hogy jobban segítsen a probléma meghatározásában.

Következő lépések

Ebben a cikkben megtanulta, hogyan háríthatja el és háríthatja el a hibákat a MedTech szolgáltatásnaplók használatával.

A MedTech szolgáltatással kapcsolatos gyakori kérdésekről (GYIK) lásd:

Az FHIR® a Health Level Seven International bejegyzett védjegye, amelyet az Egyesült Államok Védjegyhivatalában regisztráltak, és engedélyükkel használják.