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:
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) deviceIdExpression
değ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:
ARM şablonu kullanarak bir MedTech hizmeti dağıtıyorsanız ARM şablonundaki MedTech hizmet kaynağınızın değerini
"SystemAssigned"
içerentype
biridentity
özelliği olduğundan emin olun (GitHub'dakiazuredeploy.json dosyasındaki örnek ARM şablonuna bakın).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:
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.
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 biruserAssignedIdentities
özelliğe sahipidentity
olduğundan emin olun (bkz. Azure VM'ye kullanıcı tarafından atanan yönetilen kimlik atama).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).
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) deviceIdExpression
değ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.
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.