Řešení potíží s chybovými zprávami a podmínkami služby MedTech
Tento článek popisuje kroky pro řešení potíží a opravy chybových zpráv a podmínek služby MedTech.
Důležité
Přístup k metrikám služby MedTech je nezbytný pro monitorování a řešení potíží. Služba MedTech vám pomůže provádět tyto akce prostřednictvím metrik.
Tip
Podívejte se na nástroj IoMT Connector data Mapper pro úpravy, testování a odstraňování potíží s mapováním zařízení služby MEDTECH a FHIR cíli. Exportujte mapování pro nahrávání do služby MedTech ve Azure Portal nebo použijte s Open Source verzí služby MedTech.
Poznámka
Při otevírání lístku technické podpory Azure pro službu MedTech přidejte kopie vašeho zařízení a mapování cíle FHIR na pomoc při procesu řešení potíží.
Chybové zprávy a podmínky
Operace prováděná službou MedTech
Tato vlastnost představuje operaci prováděnou službou MedTech, pokud došlo k chybě. Operace obvykle představuje fázi toku dat při zpracování zprávy zařízení. Níže je uveden seznam možných hodnot pro tuto vlastnost.
Poznámka
Informace o různých fázích toku dat ve službě MedTech najdete v tématu tok dat služby MedTech.
| Fáze toku dat | Description |
|---|---|
| Nastavení | Fáze toku dat nastavení je operace specifická pro nastavení instance služby MedTech. |
| Normalizace | Normalizace je fáze toku dat, kde se data zařízení normalizují. |
| Seskupování | Fáze toku dat seskupení, kde se seskupují normalizovaná data |
| FHIRConversion | FHIRConversion je fáze toku dat, kde se seskupená normalizovaná data transformují do prostředku FHIR. |
| Neznámý | Neznámý je typ operace, která je neznámá, když dojde k chybě. |
Závažnost chyby
Tato vlastnost představuje závažnost chyby, která došlo k chybě. Níže je uveden seznam možných hodnot pro tuto vlastnost.
| Závažnost | Popis |
|---|---|
| Upozornění | Některé drobné problémy v procesu toku dat existují, ale zpracování zprávy zařízení se nezastaví. |
| Chyba | Tato zpráva se objeví v případě, že zpracování konkrétní zprávy zařízení narazí na chybu a další zprávy mohou být nadále provedeny podle očekávání. |
| Kritické | Tato chyba je v případě, že u služby MedTech existuje nějaký problém na úrovni systému a neočekává se, že se budou zpracovávat žádné zprávy. |
Typ chyby
Tato vlastnost označuje kategorii pro danou chybu, která v podstatě představuje logické seskupení pro podobné typy chyb. Níže je uveden seznam možných hodnot pro tuto vlastnost.
| Typ chyby | Description |
|---|---|
DeviceTemplateError |
Tento typ chyby se vztahuje k mapování zařízení. |
DeviceMessageError |
Tento typ chyby nastane při zpracování konkrétní zprávy zařízení. |
FHIRTemplateError |
Tento typ chyby se vztahuje na mapování cíle FHIR. |
FHIRConversionError |
Tento typ chyby nastane při transformaci zprávy na prostředek FHIR. |
FHIRResourceError |
Tento typ chyby se vztahuje ke stávajícím prostředkům ve službě FHIR, na kterou odkazuje služba MedTech. |
FHIRServerError |
Tento typ chyby nastane při komunikaci se službou FHIR. |
GeneralError |
Tento typ chyby je o všech dalších typech chyb. |
Název chyby
Tato vlastnost poskytuje název konkrétní chyby. Níže je uveden seznam všech názvů chyb s popisem a přidružených typů chyb, závažnosti a fází toku dat.
| Název chyby | Description | Typy chyb | Závažnost chyby | Fáze toku dat |
|---|---|---|---|---|
MultipleResourceFoundException |
K této chybě dochází, pokud je ve službě FHIR nalezeno více prostředků pacienta nebo zařízení pro příslušné identifikátory, které jsou součástí zprávy zařízení. | FHIRResourceError |
Chyba | FHIRConversion |
TemplateNotFoundException |
Mapování cílového zařízení nebo FHIR, které není nakonfigurované s instancí služby MedTech. | DeviceTemplateError, FHIRTemplateError |
Kritické | Normalization, FHIRConversion |
CorrelationIdNotDefinedException |
ID korelace není zadané v mapování zařízení. CorrelationIdNotDefinedException je podmíněná chyba, ke které dochází pouze v případě, že sledování FHIR musí seskupit měření zařízení pomocí ID korelace, protože není správně nakonfigurováno. |
DeviceMessageError |
Chyba | Normalizace |
PatientDeviceMismatchException |
K této chybě dochází, pokud prostředek zařízení ve službě FHIR odkazuje na prostředek pacienta. Tento typ chyby znamená, že se neshoduje s identifikátorem pacienta uvedeným ve zprávě. | FHIRResourceError |
Chyba | FHIRConversionError |
PatientNotFoundException |
Na prostředek FHIR zařízení přidružený k identifikátoru zařízení, který se nachází ve zprávě zařízení, neodkazuje žádný prostředek FHIR pacienta. Poznámka: Tato chyba se objeví jenom v případě, že je instance služby MedTech nakonfigurovaná s typem rozlišení vyhledávání . | FHIRConversionError |
Chyba | FHIRConversion |
DeviceNotFoundException |
Ve službě FHIR přidružené k identifikátoru zařízení, který se nachází ve zprávě zařízení, neexistuje žádný prostředek zařízení. | DeviceMessageError |
Chyba | Normalizace |
PatientIdentityNotDefinedException |
K této chybě dochází, pokud výraz pro rozbor identifikátoru pacienta ze zprávy zařízení není nakonfigurován na mapování zařízení nebo identifikátorem pacientům ve zprávě zařízení chybí. Poznámka k této chybě dochází pouze v případě, že typ řešení služby MedTech je nastaven na hodnotu vytvořit. | DeviceTemplateError |
Kritické | Normalizace |
DeviceIdentityNotDefinedException |
K této chybě dochází, pokud výraz pro analýzu identifikátoru zařízení ze zprávy zařízení není nakonfigurován na mapování zařízení nebo identifikátorem zařízení není přítomna ve zprávě zařízení. | DeviceTemplateError |
Kritické | Normalizace |
NotSupportedException |
Při přijetí zprávy zařízení s nepodporovaným formátem došlo k chybě. | DeviceMessageError |
Chyba | Normalizace |
Prostředek služby MedTech
| Zpráva | Zobrazit | Podmínka | Oprava |
|---|---|---|---|
Bylo dosaženo maximálního počtu typů iotconnectors prostředků. |
Rozhraní API a Azure Portal | Dosáhlo se kvóty předplatného služby MedTech (výchozí je 10 MedTech služeb na pracovní prostor a 10 pracovních prostorů na předplatné). | Odstraňte jednu z existujících instancí služby MedTech. Použijte jiné předplatné, které nedosáhlo kvóty předplatného. Vyžádejte si zvýšení kvóty předplatného. |
Neplatné deviceMapping mapování. Chyby ověřování: {List of errors} |
Rozhraní API a Azure Portal | Hodnota properties.deviceMapping poskytnutá v žádosti o zřízení prostředku služby MedTech je neplatná. |
Opravte chyby v souboru JSON mapování, který je k dispozici ve properties.deviceMapping vlastnosti . |
fullyQualifiedEventHubNamespace má hodnotu null, je prázdná nebo nesprávně formátovaná. |
Rozhraní API a Azure Portal | Žádost o zřízení služby properties.ingestionEndpointConfiguration.fullyQualifiedEventHubNamespace MedTech není platná. |
Aktualizujte službu MedTech properties.ingestionEndpointConfiguration.fullyQualifiedEventHubNamespace ve správném formátu. Měla by být {YOUR_NAMESPACE}.servicebus.windows.net. |
| Nadřazené prostředky musí být před zřízením podřízeného prostředku plně zřízeny. | rozhraní API | Nadřazený pracovní prostor se stále zřizová. | Počkejte na dokončení zřizování nadřazeného pracovního prostoru a znovu odešlete žádost o zřízení. |
Location Vlastnost podřízených prostředků musí odpovídat vlastnosti Location nadřazených prostředků. |
rozhraní API | Vlastnost žádosti o zřízení služby location MedTech se liší od vlastnosti nadřazeného pracovního location prostoru. |
Nastavte location vlastnost služby MedTech v žádosti o zřízení na stejnou hodnotu jako vlastnost nadřazeného pracovního location prostoru. |
Cílový prostředek
| Zpráva | Zobrazí | Podmínka | Oprava |
|---|---|---|---|
Bylo dosaženo maximálního počtu iotconnectors/destinations typů prostředků. |
Rozhraní API a Azure Portal | Dosáhla se kvóta cílového prostředku služby MedTech a výchozí hodnota je 1 na službu MedTech). | Odstraňte existující instanci cílového prostředku služby MedTech. Pro každou službu MedTech je povolený pouze jeden cílový prostředek. |
Zadané fhirServiceResourceId je neplatné. |
Rozhraní API a Azure Portal | Hodnota properties.fhirServiceResourceId poskytnutá v žádosti o zřízení cílového prostředku není platné ID prostředku pro instanci služby Azure Health Data Services FHIR. |
Ujistěte se, že je ID prostředku správně naformátované, a ujistěte se, že je ID prostředku pro instanci služby Azure Health Data Services FHIR. Formát by měl být následující: /subscriptions/{SUBSCRIPTION_ID}/resourceGroups/{RESOURCE_GROUP_NAME}/providers/Microsoft.HealthcareApis/workspaces/{workspace_NAME}/fhirservices/{FHIR_SERVICE_NAME} |
| Nadřazené prostředky musí být před zřízením podřízeného prostředku plně zřízeny. | rozhraní API | Nadřazený pracovní prostor nebo nadřazená služba MedTech se stále zřizují. | Počkejte na dokončení zřizování nadřazeného pracovního prostoru nebo nadřazené služby MedTech a pak znovu odešlete žádost o zřízení. |
Location Vlastnost podřízených prostředků musí odpovídat vlastnosti Location nadřazených prostředků. |
rozhraní API | Vlastnost destination provisioning request location se liší od nadřazené vlastnosti služby MedTech location . |
Nastavte location vlastnost Destination v žádosti o zřízení na stejnou hodnotu jako nadřazená vlastnost služby MedTech location . |
Proč se ve službě FHIR nezobrazují data služby MedTech?
| Potenciální problémy | Opravy |
|---|---|
| Data se stále zpracovávají. | Data se službě FHIR předá v dávkách (každých 5 minut). Je možné, že se data stále zpracovávají a je potřeba čas navíc, aby se data ve službě FHIR uchová. |
| Mapování zařízení není nakonfigurované. | Nakonfigurujte a uložte vyhovující mapování zařízení. |
| Mapování cíle FHIR není nakonfigurované. | Nakonfigurujte a uložte vyhovující mapování cíle FHIR. |
| Zpráva zařízení neobsahuje očekávaný výraz definovaný v mapování zařízení. | Ověřte JsonPath , že výrazy definované v mapování zařízení odpovídají tokenům definovaným ve zprávě zařízení. |
| Prostředek zařízení nebyl vytvořen ve službě FHIR (Typ řešení: Pouze vyhledávání)*. | Vytvořte platný prostředek zařízení ve službě FHIR. Ujistěte se, že prostředek zařízení obsahuje identifikátor, který odpovídá identifikátoru zařízení zadanému v příchozí zprávě. |
| Prostředek pacienta nebyl vytvořen ve službě FHIR (typ řešení: pouze vyhledávání)*. | Vytvořte platný prostředek pacienta ve službě FHIR. |
Odkaz Device.patient není nastavený nebo je neplatný (typ řešení: pouze vyhledávání)*. |
Ujistěte se, že prostředek zařízení obsahuje platný odkaz na prostředek pacienta. |
*Referenční rychlý start: Nasazení služby MedTech pomocí Azure Portal pro funkční popis typů řešení služby MedTech (například: Vyhledávání nebo vytvoření).
Další kroky
V tomto článku jste zjistili, jak řešit potíže s chybovou zprávou a podmínkami služby MedTech. Informace o řešení potíží s mapováním cílů zařízení a FHIR služby MedTech najdete v tématu
(FHIR®) je registrovaná ochranná známka HL7 a používá se se souhlasem HL7.