Řešení chybových zpráv a podmínek služby MedTech

Tento článek obsahuje postup řešení potíží a opravy chybových zpráv a podmínek služby MedTech.

Tip

Přístup k metrikám a protokolům jsou základními nástroji, které vám pomůžou při řešení potíží a hodnocení celkového výkonu vaší služby MedTech. Další informace o povolení, konfiguraci a používání těchto funkcí monitorování najdete v těchto článcích o službě MedTech:

Jak používat kartu Monitorování služby MedTech

Konfigurace metrik služby MedTech

Povolení nastavení diagnostiky pro službu MedTech

Poznámka

Když otevřete lístek technické podpory Azure pro službu MedTech, připojte kopie vašeho zařízení a mapování cílů FHIR , které vám pomůžou s procesem řešení potíží.

Chybové zprávy a podmínky

Operace prováděná službou MedTech

Tato vlastnost představuje operaci, kterou provádí služba MedTech, když došlo k chybě. Operace obvykle představuje fázi toku dat při zpracování zprávy zařízení. Níže je 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 nastavení toku dat je operace specifická pro nastavení vaší instance služby MedTech.
Normalizace Normalizace je fáze toku dat, ve které se data zařízení normalizují.
Seskupování Fáze seskupování toku dat, ve které se normalizovaná data seskupí.
FHIRConversion FHIRConversion je fáze toku dat, ve které se seskupená normalizovaná data transformují na prostředek 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, ke které došlo. Níže je seznam možných hodnot pro tuto vlastnost.

Závažnost Popis
Upozornění V procesu toku dat existuje nějaký menší problém, ale zpracování zprávy zařízení se nezastaví.
Chyba Tato zpráva se zobrazí v případě, že zpracování zprávy konkrétního zařízení narazilo na chybu a jiné zprávy se můžou dál spouštět podle očekávání.
Kritické K této chybě dochází v případě, že existuje problém na úrovni systému se službou MedTech a neočekává se, že by se zpracovávaly žá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 seznam možných hodnot pro tuto vlastnost.

Typ chyby Description
DeviceTemplateError Tento typ chyby souvisí s mapováním zařízení.
DeviceMessageError K tomuto typu chyby dochází při zpracování zprávy konkrétního zařízení.
FHIRTemplateError Tento typ chyby souvisí s mapováním cíle FHIR.
FHIRConversionError K tomuto typu chyby dochází při transformaci zprávy na prostředek FHIR.
FHIRResourceError Tento typ chyby souvisí s existujícími prostředky ve službě FHIR, na které odkazuje služba MedTech.
FHIRServerError K tomuto typu chyby dochází při komunikaci se službou FHIR.
GeneralError Tento typ chyby se týká všech ostatních typů chyb.

Název chyby

Tato vlastnost poskytuje název konkrétní chyby. Níže je seznam všech názvů chyb s jejich popisem a souvisejícími typy chyb, závažností a fázemi toku dat.

Název chyby Description Typy chyb Závažnost chyby Fáze toku dat
MultipleResourceFoundException K této chybě dochází v případě, že se ve službě FHIR najde více prostředků pacientů nebo zařízení pro příslušné identifikátory ve zprávě zařízení. FHIRResourceError Chyba FHIRConversion
TemplateNotFoundException Mapování zařízení nebo cíle FHIR, které není nakonfigurované s instancí služby MedTech. DeviceTemplateError, FHIRTemplateError Kritické Normalization, FHIRConversion
CorrelationIdNotDefinedException ID korelace není v mapování zařízení zadané. CorrelationIdNotDefinedException je podmíněná chyba, ke které dochází pouze v případě, že pozorování FHIR musí seskupovat měření zařízení pomocí ID korelace, protože není správně nakonfigurované. DeviceMessageError Chyba Normalizace
PatientDeviceMismatchException K této chybě dochází v případě, že prostředek zařízení ve službě FHIR obsahuje odkaz na prostředek pacienta. Tento typ chyby znamená, že neodpovídá identifikátoru pacienta, který je ve zprávě. FHIRResourceError Chyba FHIRConversionError
PatientNotFoundException Prostředek Device FHIR přidružený k identifikátoru zařízení, který je ve zprávě zařízení, odkazuje na žádný prostředek Patient FHIR. Poznámka: K této chybě dojde pouze v případě, že je instance služby MedTech nakonfigurovaná s typem řešení vyhledávání . FHIRConversionError Chyba FHIRConversion
DeviceNotFoundException Ve službě FHIR neexistuje žádný prostředek zařízení přidružený k identifikátoru zařízení, který je ve zprávě zařízení. DeviceMessageError Chyba Normalizace
PatientIdentityNotDefinedException K této chybě dochází v případě, že výraz pro analýzu identifikátoru pacienta ze zprávy zařízení není nakonfigurovaný v mapování zařízení nebo ve zprávě zařízení není identifer pacienta. Poznámka: K této chybě dochází pouze v případě, že je typ řešení služby MedTech nastavený na Vytvořit. DeviceTemplateError Kritické Normalizace
DeviceIdentityNotDefinedException K této chybě dochází v případě, že výraz pro analýzu identifikátoru zařízení ze zprávy zařízení není nakonfigurovaný v mapování zařízení nebo ve zprávě zařízení není identifer 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 Zobrazí Podmínka Oprava
Bylo dosaženo maximálního počtu typů iotconnectors prostředků. Rozhraní API a Azure Portal Dosáhli jsme kvóty předplatného služby MedTech (výchozí hodnota je 10 služeb MedTech 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. Požádejte o navýšení kvóty předplatného.
Neplatné deviceMapping mapování Chyby ověření: {Seznam chyb} Rozhraní API a Azure Portal Zadaný properties.deviceMapping požadavek na zřízení prostředků služby MedTech je neplatný. Opravte chyby v mapování JSON zadaném properties.deviceMapping ve vlastnosti .
fullyQualifiedEventHubNamespace má hodnotu null, je prázdná nebo je nesprávně naformátovaná. Rozhraní API a Azure Portal Žádost o properties.ingestionEndpointConfiguration.fullyQualifiedEventHubNamespace zřízení služby MedTech není platná. Aktualizujte službu properties.ingestionEndpointConfiguration.fullyQualifiedEventHubNamespace MedTech na správný formát. Měla by být {YOUR_NAMESPACE}.servicebus.windows.net.
Před zřízením podřízeného prostředku je nutné plně zřídit nadřazené prostředky. rozhraní API Nadřazený pracovní prostor se stále zřizuje. 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ů se musí shodovat s Location vlastností nadřazených prostředků. rozhraní API Vlastnost Žádosti o location zřízení služby MedTech se liší od vlastnosti nadřazeného pracovního prostoru location . location Nastavte vlastnost služby MedTech v žádosti o zřízení na stejnou hodnotu jako vlastnost nadřazeného pracovního prostorulocation.

Cílový prostředek

Zpráva Zobrazí Podmínka Oprava
Bylo dosaženo maximálního počtu typů iotconnectors/destinations prostředků. Rozhraní API a Azure Portal Dosáhli jsme kvóty cílových prostředků 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 službu MedTech je povolený pouze jeden cílový prostředek.
Zadaný parametr fhirServiceResourceId je neplatný. Rozhraní API a Azure Portal Zadaný properties.fhirServiceResourceId v žádosti o zřízení cílového prostředku není platným 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 ID prostředku odpovídá instanci služby FHIR služby Azure Health Data Services. Formát by měl být: /subscriptions/{SUBSCRIPTION_ID}/resourceGroups/{RESOURCE_GROUP_NAME}/providers/Microsoft.HealthcareApis/workspaces/{workspace_NAME}/fhirservices/{FHIR_SERVICE_NAME}
Před zřízením podřízeného prostředku je nutné plně zřídit nadřazené prostředky. rozhraní API Nadřazený pracovní prostor nebo nadřazená služba MedTech se stále zřizuje. Počkejte, až se dokončí 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ů se musí shodovat s Location vlastností nadřazených prostředků. rozhraní API Vlastnost Destination provisioning request location se liší od nadřazené vlastnosti služby location MedTech. location Nastavte vlastnost Destination v požadavku na zřizování na stejnou hodnotu jako vlastnost nadřazené služby location MedTech.

Proč se data služby MedTech nezobrazují ve službě FHIR?

Potenciální problémy Opravy
Data se stále zpracovávají. Data se do služby FHIR odesílají v dávkách (každých přibližně 5 minut). Je možné, že se data stále zpracovávají a k jejich uchování ve službě FHIR je potřeba více času.
Mapování zařízení není nakonfigurované. Nakonfigurujte a uložte odpovídající mapování zařízení.
Mapování cíle FHIR nebylo nakonfigurováno. Nakonfigurujte a uložte odpovídající mapování cílů FHIR.
Zpráva zařízení neobsahuje očekávaný výraz definovaný v mapování zařízení. Ověřte, že JsonPath výrazy definované v mapování zařízení odpovídají tokenům definovaným ve zprávě zařízení.
Prostředek zařízení se nevytvořil 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 se nevytvořil 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.

*Rychlý start s referenčními informacemi: Nasazení služby MedTech pomocí Azure Portal pro funkční popis typů řešení služby MedTech (například: Vytvoření nebo Vyhledávání).

Další kroky

V tomto článku jste zjistili, jak řešit potíže s chybovými zprávami a podmínkami služby MedTech. Informace o řešení potíží se zařízením služby MedTech a mapováním cílů FHIR najdete v tématu

FHIR® je registrovaná ochranná známka společnosti Health Level Seven International, registrovaná v AMERICKÉm úřadu pro ochranné známky a používá se s jejich svolením.