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:
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
correlationIdExpressioneszkö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ó
correlationIdExpressionsort.
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
templateTypetulajdonság jelöl) hiányzik, vagy üres értékkel rendelkezik.A gyökérgyűjtemény-sablon alatt lévő (a
templatetulajdonsá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
typeNametulajdonsá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:
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
identityolyan tulajdonságtal, amelytypeaz értékét"SystemAssigned"tartalmazza (lásd a gitHubazuredeploy.json fájljában található ARM-sablont).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:
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.
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
identityolyan tulajdonságtal, amely 1)typeaz értéke"userAssigned"és 2) egyuserAssignedIdentitiesolyan é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).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).
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
languagetulajdonsá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
valueké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.