Ř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.