MedTech hizmet günlüklerini kullanarak hataları giderme

Not

Fast Healthcare Interoperability Resources (FHIR®), açık bir sağlık hizmeti belirtimidir.

Bu makalede, MedTech hizmet günlüklerinde bulunan hatalarla ilgili sorun giderme adımları ve düzeltmeler sağlanır.

İpucu

MedTech hizmet günlüklerine erişmek, MedTech hizmetinizin genel durumunu ve performansının sorunlarını gidermek ve değerlendirmek için önemlidir.

MedTech hizmet günlüklerine nasıl erişeceğinizi öğrenmek için bkz. MedTech hizmeti için tanılama ayarlarını etkinleştirme.

MedTech hizmeti hata önem derecesi

Bu özellik, oluşan hatanın önem derecesini temsil eder. Bu özellik için olası değerlerin listesi aşağıdadır:

Önem Derecesi	Açıklama
Engelleyici olmayan	Veri akışı işleminde bir sorun var, ancak cihaz iletilerinin işlenmesi durdurulmuyor.
Engelleme	Veri akışı işleminde bir sorun var ve hiçbir cihaz iletisinin işlenmesi beklenmiyor.

MedTech hizmeti tarafından gerçekleştirilen işlem

Bu özellik, hata oluştuğunda MedTech hizmeti tarafından gerçekleştirilen işlemi temsil eder. İşlem genellikle bir cihaz iletisinin işlendiği veri akışı aşamasını temsil eder. Veri akışı aşaması hata günlüklerinde OperationName olarak görüntülenir. Bu özellik için olası değerlerin listesi aşağıdadır:

OperationName	Açıklama
Normalleştirme	Cihaz iletisinin normalleştirildiği veri akışı aşaması.
FHIRConversion	Gruplandırılmış-normalleştirilmiş verilerin gözlem kaynağına dönüştürüldüğü veri akışı aşaması.

Not

MedTech hizmeti cihaz ileti veri dönüşümü hakkında bilgi edinmek için bkz. MedTech hizmeti cihaz veri işleme aşamalarına genel bakış.

MedTech hizmet durumu denetimi özel durumları ve düzeltmeleri

Sistem durumu denetimleri, bir MedTech hizmetinin cihaz iletilerini normalleştirip dönüştüremediğini denetlemek için otomatik ve düzenli aralıklarla gerçekleştirilir. Sistem durumu denetimi geçmezse HealthCheckException gerçekleşir ve günlüğe kaydedilir.

MedTech hizmet günlüklerinde, HealthCheckExceptionLogType değeriyle bir sistem durumu denetimi hatası günlüğe kaydedilir ve başarısız sistem durumu denetiminin adı İletiye kaydedilir.

Sistem durumu denetimlerinin adları aşağıdaki tabloda listelenmiştir ve hatalarından herhangi birinin düzeltmeleri tablonun altında açıklanmıştır:

HealthCheck
CredentialStore:IsCustomerFacingMiCredentialBundlePresent
ExternalEventHub:IsAuthenticated
FhirService:IsAuthenticated

Not

HealthCheckException engelleyici bir sorun olsa da geçici olabilir ve müdahale olmadan kendi kendine çözülebilir.

CredentialStore:IsCustomerFacingMiCredentialBundlePresent

Açıklama: MedTech hizmetinin sistem tarafından atanan yönetilen kimliğinin etkinleştirilip etkinleştirilmediğini veya kullanıcı tarafından atanan yönetilen kimliğin yapılandırılıp yapılandırılmadığını denetler.

Önem Derecesi: Engelleme

Düzeltme: ManagedIdentityCredentialNotFound bölümünde açıklanan düzeltmeyi izleyin.

ExternalEventHub:IsAuthenticated

Açıklama: Olay hub'sının geçerli olduğunu ve MedTech hizmetinin buna erişim aldığını denetler.

Önem Derecesi: Engelleme

Düzeltme: InvalidEventHubException'da açıklanan düzeltmeyi izleyerek olay hub'ınızın geçerli olduğundan emin olun. Ardından , UnauthorizedAccessEventHubException bölümünde açıklanan düzeltmeyi izleyerek MedTech hizmetinizin olay hub'ınıza erişim aldığından emin olun.

FhirService:IsAuthenticated

Açıklama: FHIR hedefinin geçerli olduğunu ve MedTech hizmetinin buna yazma erişimi olduğunu denetler.

Önem Derecesi: Engelleme

Düzeltme: InvalidFhirServiceException'da açıklanan düzeltmeyi izleyerek FHIR hedefinizin geçerli olduğundan emin olun. Ardından , UnauthorizedAccessFhirServiceException'da açıklanan düzeltmeyi izleyerek MedTech hizmetinizin FHIR hedefinize yazma erişimi olduğundan emin olun.

MedTech hizmeti hataları ve düzeltmeleri

Cihaz iletilerini normalleştirirken veya dönüştürürken bir hata oluşursa günlüğe kaydedilir.

MedTech hizmet günlüklerinde hatanın adı LogType'a kaydedilir.

Hataların adları aşağıdaki tabloda listelenmiştir ve bunlar için düzeltmeler tablonun altında verilmiştir:

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

CorrelationIdNotDefinedException

Açıklama: Cihaz eşlemesinde bir CorrelationIdExpression (cihaz iletisinden bağıntı tanımlayıcısını ayrıştırma ifadesidir) belirtilirse, bu hata bir cihaz iletisinde bağıntı tanımlayıcısı olmadığında veya CorrelationIdExpression cihaz eşlemesinde doğru yapılandırılmadığında oluşur. Not: CorrelationIdExpression isteğe bağlıdır. Aynı cihazı, türü ve bağıntı tanımlayıcısını paylaşan ölçümler tek bir FHIR Gözlem kaynağında gruplandırıldığında bu hata oluşur.

Önem Derecesi: Engelleme

Düzeltme:

• CorrelationIdExpression gerekiyorsa: Cihaz iletilerinizin bağıntı tanımlayıcısını içerdiğinden emin olun. Ayrıca, Azure portal MedTech hizmetinizin Cihaz eşleme dikey penceresine gidin ve cihaz eşlemesindeki değerin correlationIdExpression mevcut olduğundan ve cihaz iletilerinizdeki bağıntı tanımlayıcısının anahtarına doğru şekilde başvurdığından emin olun.

• CorrelationIdExpression gerekli değilse: Azure portal MedTech hizmetinizin Cihaz eşleme dikey penceresine gidin ve cihaz eşlemesinde bulunan correlationIdExpression çizgiyi kaldırın.

FhirDataMappingException

Açıklama: FHIR hedef eşlemesi ile normalleştirilmiş veriler dönüştürülürken bir hata oluştu. Normalleştirilmiş verilere karşılık gelen bir şablon FHIR hedef eşlemesinde tanımlanmadığında bu hata oluşur.

Önem Derecesi: Engelleme

Düzeltme: Azure portal MedTech hizmetinizin Cihaz eşleme dikey penceresine ve Hedef dikey penceresine gidin ve cihaz eşlemesindeki her şablon için FHIR hedef eşlemesinde aynı typeName değere sahip bir şablon bulunduğundan emin olun. Ayrıca, Hedef dikey penceresinde FHIR hedef eşlemesini düzenlerken ve kaydederken gösterilen doğrulama hatalarını düzeltin.

FhirResourceNotFoundException

Açıklama: Bu hata, cihaz iletisinde verilen tanımlayıcıya sahip bir FHIR kaynağı FHIR hedefinde bulunamadığında oluşur. FHIR kaynağının türü Patient ise hata, cihaz iletisinde verilen cihaz tanımlayıcısı olan Cihaz FHIR kaynağının Patient FHIR kaynağına başvurmaması olabilir. FHIR kaynağının türü (örneğin, Cihaz, Hasta, Karşılaşma veya Gözlem) hata iletisinde belirtilir. Not: Bu hata yalnızca MedTech hizmetinin çözüm türü Arama olarak ayarlandığında oluşabilir.

Önem Derecesi: Engelleyici değil

Düzeltme: Cihaz iletilerinizin, hata iletisinde belirtilen türe sahip FHIR kaynağının tanımlayıcısını içerdiğinden emin olun. Ayrıca Azure portal MedTech hizmetinizin Cihaz eşleme dikey penceresine gidin ve cihaz eşlemesindeki {FHIR resource’s type specified in the error message}IdExpression (örneğin) deviceIdExpressiondeğerinin mevcut olduğundan ve cihaz iletilerinizde tanımlayıcının anahtarına doğru şekilde başvurdığından emin olun.

IncompatibleDataException

Açıklama: Cihaz iletisiyle cihaz eşlemesi arasında bir uyumsuzluk vardır (örneğin, cihaz iletisinde ve/veya cihaz eşlemesinde gerekli bir özellik eksik veya boş olabilir). Hata içeren cihaz eşleme özelliği hata iletisinde belirtilir.

Önem Derecesi: Engelleyici değil

Düzeltme: Cihaz iletilerinizin şu şekilde olduğundan emin olun:

• Hata iletisinde belirtilen cihaz eşleme özelliği tarafından başvuruda bulunan anahtar.

• Anahtar için boş olmayan bir değer.

Ayrıca, Azure portal MedTech hizmetinizin Cihaz eşleme dikey penceresine gidin ve hata iletisinde belirtilen cihaz eşleme özelliğinin cihaz iletilerinizde ilgili anahtara doğru başvuruda bulunan bir değere sahip olduğundan emin olun.

InvalidDataFormatException

Açıklama: Cihaz iletisi JSON nesnesine ayrıştırılabilir biçimde değildir.

Önem Derecesi: Engelleyici değil

Düzeltme: Cihaz iletilerinizin JSON biçiminde olduğundan emin olun. JSON biçimini onaylamanın bir yolu çevrimiçi JSON doğrulayıcı kullanmaktır.

InvalidEventHubException

Açıklama: Olay hub'ı şu nedenlerden biri nedeniyle geçersiz:

• Olay hub'ı ayrıntılarından en az biri (Event Hubs ad alanı, olay hub'ı adı veya tüketici grubu) yanlış biçimlendirilmiş veya mevcut değil. Event Hubs ad alanı olay hub'ını ve olay hub'ı tüketici grubunu içermelidir.

• Olay hub'ı tüketici grubundan birden fazla hizmet okuyor.

Önem Derecesi: Engelleme

Düzeltme: Azure portal MedTech hizmetinizin Event Hubs dikey penceresine gidin ve olay hub'ı ayrıntılarının tüm alanlarının doldurulduğundan emin olun. Tüketici grubundan yalnızca MedTech hizmetinizin okumasını sağlamak için:

• Hizmetlerinizi inceleyin ve MedTech hizmetinizin tüketici grubuna erişen tek hizmet olduğundan emin olun.

• Azure portal olay hub'ınıza gidin, yalnızca MedTech hizmetinizin eriştiği yeni bir tüketici grubu oluşturun, MedTech hizmetinizin Event Hubs dikey penceresine gidin ve Tüketici grubu alanında yeni tüketici grubunuzu seçin.

InvalidFhirServiceException

Açıklama: FHIR hedefi yanlış biçimlendirildiğinden, mevcut olmadığından veya Azure Health Veri Hizmetleri'nde bir FHIR hizmeti olmadığından geçersiz.

Önem Derecesi: Engelleme

Düzeltme: Azure portal MedTech hizmetinizin Hedef dikey penceresine gidin ve FHIR sunucu alanının doğru doldurulduğundan emin olun.

InvalidQuantityFhirValueException

Açıklama: Miktar kaynak veri türüne sahip değer geçersiz (örneğin, desteklenmeyen bir biçimde olabilir). Hata içeren değer hata iletisinde belirtilir.

Önem Derecesi: Engelleyici değil

Düzeltme: Cihaz iletilerinizdeki değerlerin FHIR Quantity.value belirtimlerine göre desteklenen veri türlerinde olduğundan emin olun.

InvalidTemplateException

Açıklama: Cihaz eşlemesinde veya FHIR hedef eşlemesinde şablonla ilgili bir hata var. Hatalar şunlardır:

• Şablonun şablon türü (özelliğiyle templateType temsil edilir) eksik veya boş bir değere sahip.

• Kök koleksiyon şablonunun altındaki bir şablonun template (özelliğiyle temsil edilir) değeri olarak küme ayraçlarıyla {}tanımlanan bir JSON nesnesi yoktur.

• Bir şablonun türü (özelliğiyle typeName temsil edilir) eksik veya boş bir değere sahip.

• Eşlemedeki birden fazla şablon aynı türe sahiptir (özelliği için aynı değere typeName sahiptir).

Şablonun türü ve hata içeren satırı hata iletisinde belirtilir.

Önem Derecesi: Engelleme

Düzeltme: Azure portal, MedTech hizmetinizin Cihaz eşleme dikey penceresine (cihaz eşlemesinde hata varsa) veya Hedef dikey penceresine (hata FHIR hedef eşlemesindeyse) gidin ve hata iletisinde belirtilen şablonu düzeltin.

ManagedIdentityCredentialNotFound

Açıklama: MedTech hizmeti olay hub'ına bağlanırken, MedTech hizmetinin sistem tarafından atanan yönetilen kimliği devre dışı bırakılır veya mevcut değildir ya da MedTech hizmeti için kullanıcı tarafından atanan yönetilen kimlik yapılandırılmaz. Not: MedTech hizmeti yanlış yapılandırılmış bir Azure Resource Manager (ARM) şablonu kullanılarak dağıtıldıysa bu hata oluşabilir.

Önem Derecesi: Engelleme

Düzeltme: Düzeltme, kullanmak istediğiniz yönetilen kimliğin türüne bağlıdır. Sistem tarafından atanan ve kullanıcı tarafından atanan yönetilen kimlik arasındaki fark Yönetilen kimlik türleri'nde gözden geçirilebilir. Not: MedTech hizmeti yalnızca bir kimliği destekler: sistem tarafından atanan yönetilen kimlik veya kullanıcı tarafından atanan tek bir yönetilen kimlik.  

Sistem tarafından atanan yönetilen kimliği kullanmak istiyorsanız:

1. ARM şablonu kullanarak bir MedTech hizmeti dağıtıyorsanız ARM şablonundaki MedTech hizmet kaynağınızın değerini "SystemAssigned" içeren type bir identity özelliği olduğundan emin olun (GitHub'dakiazuredeploy.json dosyasındaki örnek ARM şablonuna bakın).

2. Azure portal MedTech hizmetinizin Kimlik dikey penceresine gidin, Sistem tarafından atanan sekmesine gidin ve aşağıdakilerden emin olun:

   • Durum Açık olarak ayarlanır.
   • Azure rol atamaları, olay hub'ınızın MedTech hizmetinizin sistem tarafından atanan yönetilen kimliğine atanmış bir Azure Event Hubs Veri Alıcısı rolüne sahip olduğunu gösterir. Aksi takdirde bu yönergeleri izleyin. 

Kullanıcı tarafından atanan bir yönetilen kimlik kullanmak istiyorsanız:

1. Kullanıcı tarafından atanan bir yönetilen kimliğe sahip olduğunuzdan emin olun. Aksi takdirde, Azure portal veya ARM şablonunu kullanarak bir şablon oluşturun.

2. ARM şablonu kullanarak bir MedTech hizmeti dağıtıyorsanız ARM şablonundaki MedTech hizmet kaynağınızın 1) değerini ve 2) "userAssigned"type kullanıcı tarafından atanan yönetilen kimliğinizi içeren bir değeri içeren bir userAssignedIdentities özelliğe sahip identity olduğundan emin olun (bkz. Azure VM'ye kullanıcı tarafından atanan yönetilen kimlik atama).

3. Azure portal MedTech hizmetinizin Kimlik dikey penceresine gidin, Kullanıcı tarafından atanan sekmesine gidin ve kullanıcı tarafından atanan yönetilen kimliğinizin gösterildiğinden emin olun. Aksi takdirde, kullanıcı tarafından atanan yönetilen kimliğinizi ekleyin ( var olan bir VM'ye kullanıcı tarafından atanan yönetilen kimlik atama örneğine bakın).

4. Azure portal olay hub'ınıza gidin ve Azure Event Hubs Veri Alıcısı rolünü MedTech hizmetinizin kullanıcı tarafından atanan yönetilen kimliğine atayın (yönergelere bakın, ancak sistem tarafından atanan yönetilen kimlik yerine kullanıcı tarafından atanan yönetilen kimliği kullanın).

MultipleResourceFoundException

Açıklama: Cihaz iletisinden alınan aynı tanımlayıcıya sahip birden çok FHIR kaynağı FHIR hedefinde bulunur, ancak yalnızca bir FHIR kaynağı bulunmalıdır. FHIR kaynağının türü (örneğin, Cihaz, Hasta, Karşılaşma veya Gözlem) hata iletisinde belirtilir.

Önem Derecesi: Engelleyici değil

Düzeltme: Bir tanımlayıcının hata iletisinde belirtilen türe sahip birden fazla FHIR kaynağına atanmadığından emin olun.

NormalizationDataMappingException

Açıklama: Cihaz eşlemesiyle bir cihaz iletisi normalleştirirken bir hata oluştu.

Önem Derecesi: Engelleme

Düzeltme: Azure portal MedTech hizmetinizin Cihaz eşleme dikey penceresine gidin ve cihaz eşlemesini düzenlerken ve kaydederken gösterilen doğrulama hatalarını düzeltin.

PatientDeviceMismatchException

Açıklama: FHIR hedefindeki Bir Cihaz kaynağı, cihaz iletisinde verilen hasta tanımlayıcısıyla eşleşmeyen bir tanımlayıcıya sahip bir Patient FHIR kaynağına başvurur (başka bir deyişle, cihaz başka bir hastayla bağlantılıdır).

Önem Derecesi: Engelleyici değil

Düzeltme: Bir hasta tanımlayıcının birden fazla cihaza atanmadığından emin olun.

ResourceIdentityNotDefinedException

Açıklama: Bu hata, FHIR kaynağının tanımlayıcısı bir cihaz iletisinde bulunmadığında veya FHIR kaynağının tanımlayıcısını cihaz iletisinden ayrıştırma ifadesi cihaz eşlemesinde yapılandırılmadığında oluşur. FHIR kaynağının türü (örneğin, Cihaz, Hasta, Karşılaşma veya Gözlem) hata iletisinde belirtilir. Not: Bu hata yalnızca MedTech hizmetinin çözüm türü Oluştur olarak ayarlandığında oluşabilir.

Önem Derecesi: Engelleyici değil

Düzeltme: Cihaz iletilerinizin, hata iletisinde belirtilen türe sahip FHIR kaynağının tanımlayıcısını içerdiğinden emin olun. Ayrıca Azure portal MedTech hizmetinizin Cihaz eşleme dikey penceresine gidin ve cihaz eşlemesindeki {FHIR resource’s type specified in the error message}IdExpression (örneğin) deviceIdExpressiondeğerinin mevcut olduğundan ve cihaz iletilerinizde tanımlayıcının anahtarına doğru şekilde başvurdığından emin olun.

TemplateExpressionException

Açıklama: Cihaz eşlemesi içindeki bir şablonda ifadeyle ilgili bir hata var. Hatalar şunlardır:

• Gerekli bir ifade eksik.

• İfadenin dili (özelliğiyle language temsil edilir) desteklenmez. Tüm şablon türleri JSONPath'te ifadeleri destekler; JMESPath'te yalnızca CalculatedContent şablon türü ifadeleri destekler.

• İfadenin değeri (özelliğiyle value temsil edilir) ifade dilinin söz dizimine göre yanlış biçimlendirilmiş.

İfade ve hata içeren satır, hata iletisinde belirtilir.

Önem Derecesi: Engelleme

Düzeltme: Azure portal MedTech hizmetinizin Cihaz eşleme dikey penceresine gidin ve cihaz eşlemesinde hata iletisinde belirtilen ifadeyi düzeltin.

TemplateNotFoundException

Açıklama: Cihaz eşlemesindeki bir şablonun FHIR hedef eşlemesinde aynı türe sahip eşleşen bir şablonu yoktur. Şablonun türü hata iletisinde belirtilir.

Önem Derecesi: Engelleyici değil

Düzeltme: Azure portal MedTech hizmetinizin Cihaz eşleme dikey penceresine ve Hedef dikey penceresine gidin ve cihaz eşlemesindeki her şablon için FHIR hedef eşlemesinde aynı typeName değere sahip bir şablon bulunduğundan emin olun.

UnauthorizedAccessEventHubException

Açıklama: MedTech hizmetinde olay hub'ına erişim alma işlemi eksik.

Önem Derecesi: Engelleme

Düzeltme: Azure portal olay hub'ınıza gidin ve Azure Event Hubs Veri Alıcısı rolünü MedTech hizmetinize atayın (yönergelere bakın).

UnauthorizedAccessFhirServiceException

Açıklama: MedTech hizmetinde FHIR hedefine yazma erişimi eksik.

Önem Derecesi: Engelleme

Düzeltme: Azure portal FHIR hizmetinize gidin ve FHIR Veri Yazıcısı rolünü MedTech hizmetinize atayın (yönergelere bakın).

Not

Bu sorun giderme kılavuzunu kullanarak MedTech hizmeti sorununuzu çözemiyorsanız, sorun belirleme konusunda daha iyi yardım almak için isteğinize cihaz iletinizin ve cihazınızın ve FHIR hedef eşlemelerinizin kopyalarını ekleyip bir Azure Teknik Destek bileti açabilirsiniz.

Sonraki adımlar

Bu makalede, MedTech hizmet günlüklerini kullanarak hataları gidermeyi ve düzeltmeyi öğrendiniz.

MedTech hizmeti hakkında sık sorulan sorular (SSS) hakkında bilgi edinmek için bkz.

MedTech hizmeti hakkında sık sorulan sorular

FHIR®, Health Level Seven International'ın KAYıTLı ticari markasıdır, ABD Ticari Marka Ofisi'nde kayıtlıdır ve izinleri ile birlikte kullanılır.