Memecahkan masalah pesan dan kondisi kesalahan layanan MedTech
Artikel ini menyediakan langkah-langkah untuk memecahkan masalah dan memperbaiki pesan dan kondisi kesalahan layanan MedTech.
Penting
Memiliki akses ke metrik layanan MedTech sangat penting untuk pemantauan dan pemecahan masalah. Layanan MedTech membantu Anda melakukan tindakan ini melalui Metrik.
Tip
Lihat alat IoMT Connector Data Mapper untuk mengedit, menguji, dan memecahkan masalah perangkat layanan MedTech Perangkat dan pemetaan tujuan FHIR. Ekspor pemetaan untuk diunggah ke layanan MedTech di portal Microsoft Azure atau gunakan dengan versi sumber terbuka dari layanan MedTech.
Catatan
Saat membuka tiket Dukungan Teknis Azure untuk layanan MedTech, sertakan salinan pemetaan tujuan Perangkat dan FHIR Anda untuk membantu proses pemecahan masalah.
Pesan dan kondisi kesalahan
Operasi yang dilakukan oleh layanan MedTech
Properti ini mewakili operasi yang dilakukan oleh layanan MedTech ketika kesalahan telah terjadi. Operasi umumnya mewakili tahap aliran data saat memproses pesan perangkat. Di bawah ini adalah daftar nilai yang mungkin untuk properti ini.
Catatan
Untuk informasi tentang berbagai tahap aliran data di layanan MedTech, lihat alur data layanan MedTech.
| Tahap aliran data | Deskripsi |
|---|---|
| Siapkan | Tahap alur data penyiapan adalah operasi khusus untuk menyiapkan instans layanan MedTech Anda. |
| Normalisasi kasus | Normalisasi adalah tahap aliran data di mana data perangkat dinormalisasi. |
| Pengelompokan | Tahap aliran data pengelompokan di mana data yang dinormalisasi dikelompokkan. |
| FHIRConversion | FHIRConversion adalah tahap aliran data di mana data yang dinormalisasi dikelompokkan diubah menjadi sumber daya FHIR. |
| Tidak dikenal | Yang tidak diketahui adalah jenis operasi yang tidak diketahui kapan kesalahan terjadi. |
Tingkat keparahan kesalahan
Properti ini mewakili tingkat keparahan kesalahan yang terjadi. Di bawah ini adalah daftar nilai yang mungkin untuk properti ini.
| Tingkat keparahan | Deskripsi |
|---|---|
| Peringatan | Beberapa masalah kecil ada dalam proses aliran data, tetapi pemrosesan pesan perangkat tidak berhenti. |
| Kesalahan | Pesan ini terjadi ketika pemrosesan pesan perangkat tertentu mengalami kesalahan dan pesan lain dapat terus berjalan seperti yang diharapkan. |
| Kritis | Kesalahan ini adalah ketika beberapa masalah tingkat sistem ada dengan layanan MedTech dan tidak ada pesan yang diharapkan untuk diproses. |
Jenis kesalahan
Properti ini menandakan kategori untuk kesalahan tertentu, yang pada dasarnya merupakan pengelompokan logis untuk jenis kesalahan yang serupa. Di bawah ini adalah daftar nilai yang mungkin untuk properti ini.
| Jenis kesalahan | Deskripsi |
|---|---|
DeviceTemplateError |
Jenis kesalahan ini terkait dengan pemetaan Perangkat. |
DeviceMessageError |
Jenis kesalahan ini terjadi saat memproses pesan perangkat tertentu. |
FHIRTemplateError |
Jenis kesalahan ini terkait dengan pemetaan tujuan FHIR |
FHIRConversionError |
Tipe kesalahan ini terjadi saat mengubah pesan menjadi sumber daya FHIR. |
FHIRResourceError |
Jenis kesalahan ini terkait dengan sumber daya yang ada di layanan FHIR yang dirujuk oleh layanan MedTech. |
FHIRServerError |
Jenis kesalahan ini terjadi saat berkomunikasi dengan layanan FHIR. |
GeneralError |
Jenis kesalahan ini adalah tentang semua jenis kesalahan lainnya. |
Nama kesalahan
Properti ini menyediakan nama untuk kesalahan tertentu. Di bawah ini adalah daftar semua nama kesalahan dengan deskripsi dan jenis kesalahan terkait, keparahan, dan tahap aliran data.
| Nama kesalahan | Deskripsi | Jenis kesalahan | Tingkat keparahan kesalahan | Tahap aliran data |
|---|---|---|---|---|
MultipleResourceFoundException |
Kesalahan ini terjadi ketika beberapa sumber daya pasien atau perangkat ditemukan di layanan FHIR untuk masing-masing pengidentifikasi yang ada dalam pesan perangkat. | FHIRResourceError |
Kesalahan | FHIRConversion |
TemplateNotFoundException |
Pemetaan tujuan perangkat atau FHIR yang tidak dikonfigurasi dengan instans layanan MedTech. | DeviceTemplateError, FHIRTemplateError |
Kritis | Normalization, FHIRConversion |
CorrelationIdNotDefinedException |
ID korelasi tidak ditentukan dalam pemetaan Perangkat. CorrelationIdNotDefinedException Adalah kesalahan bersyarat yang terjadi hanya ketika Pengamatan FHIR harus mengelompokkan pengukuran perangkat menggunakan ID korelasi karena tidak dikonfigurasi dengan benar. |
DeviceMessageError |
Kesalahan | Normalisasi kasus |
PatientDeviceMismatchException |
Kesalahan ini terjadi ketika sumber daya perangkat pada layanan FHIR memiliki referensi ke sumber daya pasien. Jenis kesalahan ini berarti tidak cocok dengan pengidentifikasi pasien yang ada dalam pesan. | FHIRResourceError |
Kesalahan | FHIRConversionError |
PatientNotFoundException |
Tidak ada sumber daya FHIR Pasien yang dirujuk oleh sumber daya Perangkat FHIR yang terkait dengan pengenal perangkat yang ada dalam pesan perangkat. Perhatikan kesalahan ini hanya akan terjadi ketika instans layanan MedTech dikonfigurasi dengan tipe resolusi Pencarian . | FHIRConversionError |
Kesalahan | FHIRConversion |
DeviceNotFoundException |
Tidak ada sumber daya perangkat yang ada pada layanan FHIR yang terkait dengan pengenal perangkat yang ada dalam pesan perangkat. | DeviceMessageError |
Kesalahan | Normalisasi kasus |
PatientIdentityNotDefinedException |
Kesalahan ini terjadi ketika ekspresi untuk mengurai pengenal pasien dari pesan perangkat tidak dikonfigurasi pada pemetaan Perangkat atau pengidentifikasi pasien tidak ada dalam pesan perangkat. Perhatikan kesalahan ini hanya terjadi ketika jenis resolusi layanan MedTech diatur ke Buat. | DeviceTemplateError |
Kritis | Normalisasi kasus |
DeviceIdentityNotDefinedException |
Kesalahan ini terjadi ketika ekspresi untuk mengurai pengidentifikasi pasien dari pesan perangkat tidak dikonfigurasi pada pemetaan Perangkat atau pengidentifikasi pasien tidak ada dalam pesan perangkat. | DeviceTemplateError |
Kritis | Normalisasi kasus |
NotSupportedException |
Kesalahan terjadi saat pesan perangkat dengan format yang tidak didukung diterima. | DeviceMessageError |
Kesalahan | Normalisasi kasus |
Sumber daya layanan MedTech
| Pesan | Ditampilkan | Kondisi | Perbaikan |
|---|---|---|---|
Jumlah maksimum jenis sumber daya iotconnectors telah tercapai. |
API dan portal Microsoft Azure | Kuota berlangganan layanan MedTech tercapai (default adalah 10 layanan MedTech per ruang kerja dan 10 ruang kerja per langganan). | Hapus salah satu instans layanan MedTech yang ada. Gunakan langganan berbeda yang belum mencapai kuota langganan. Minta kenaikan kuota langganan. |
Pemetaan yang deviceMapping tidak valid. Kesalahan validasi: {Daftar kesalahan} |
API dan portal Microsoft Azure | Yang properties.deviceMapping disediakan dalam permintaan penyediaan Sumber Daya layanan MedTech tidak valid. |
Perbaiki kesalahan dalam pemetaan JSON yang disediakan di properties.deviceMapping properti. |
fullyQualifiedEventHubNamespace adalah null, kosong, atau diformat secara tidak benar. |
API dan portal Microsoft Azure | Permintaan properties.ingestionEndpointConfiguration.fullyQualifiedEventHubNamespace penyediaan layanan MedTech tidak valid. |
Perbarui layanan properties.ingestionEndpointConfiguration.fullyQualifiedEventHubNamespace MedTech ke format yang benar. harus {YOUR_NAMESPACE}.servicebus.windows.net. |
| Sumber daya leluhur harus sepenuhnya disediakan sebelum sumber daya anak dapat disediakan. | API | Ruang kerja induk masih menyediakan. | Tunggu hingga penyediaan ruang kerja induk selesai dan ajukan permintaan provisi lagi. |
Location properti sumber daya anak harus sesuai dengan Location properti sumber daya orang tua. |
API | Properti permintaan location penyediaan layanan MedTech berbeda dari properti ruang kerja location induk. |
location Atur properti layanan MedTech dalam permintaan provisi ke nilai yang sama dengan properti ruang kerja location induk. |
Sumber daya tujuan
| Pesan | Ditampilkan | Kondisi | Perbaikan |
|---|---|---|---|
Jumlah maksimum jenis sumber daya iotconnectors/destinations telah tercapai. |
API dan portal Microsoft Azure | Kuota Sumber Daya Tujuan layanan MedTech tercapai dan defaultnya adalah 1 per layanan MedTech). | Hapus instans yang ada dari sumber daya tujuan layanan MedTech. Hanya satu Sumber Daya Tujuan yang diizinkan per layanan MedTech. |
fhirServiceResourceIdyang disediakan tidak valid. |
API dan portal Microsoft Azure | Yang properties.fhirServiceResourceId disediakan dalam permintaan penyediaan Sumber Daya Tujuan bukanlah ID sumber daya yang valid untuk instans layanan FHIR Azure Health Data Services. |
Pastikan ID sumber daya diformat dengan benar, dan pastikan ID sumber daya untuk instans layanan FHIR Azure Health Data Services. Format harus /subscriptions/{SUBSCRIPTION_ID}/resourceGroups/{RESOURCE_GROUP_NAME}/providers/Microsoft.HealthcareApis/workspaces/{workspace_NAME}/fhirservices/{FHIR_SERVICE_NAME} |
| Sumber daya leluhur harus sepenuhnya disediakan sebelum sumber daya anak dapat disediakan. | API | Ruang kerja induk atau layanan MedTech induk masih menyediakan. | Tunggu hingga ruang kerja induk atau penyediaan layanan MedTech induk selesai, lalu kirimkan permintaan provisi lagi. |
Location properti sumber daya anak harus sesuai dengan Location properti sumber daya orang tua. |
API | Properti permintaan location provisi Tujuan berbeda dari properti layanan location MedTech induk. |
location Tetapkan properti Tujuan dalam permintaan provisi ke nilai yang sama dengan properti layanan location MedTech induk. |
Mengapa data layanan MedTech tidak muncul di layanan FHIR?
| Potensi Masalah | Perbaikan |
|---|---|
| Data masih diproses. | Data keluar ke layanan FHIR dalam batch (setiap ~ 5 menit). Ada kemungkinan data masih diproses dan waktu tambahan diperlukan agar data tetap ada di layanan FHIR. |
| Pemetaan perangkat belum dikonfigurasi. | Konfigurasikan dan simpan pemetaan Perangkat yang sesuai. |
| Pemetaan tujuan FHIR belum dikonfigurasi. | Konfigurasikan dan simpan pemetaan tujuan FHIR yang sesuai. |
| Pesan perangkat tidak berisi ekspresi yang diharapkan yang didefinisikan dalam pemetaan Perangkat. | Verifikasi JsonPath ekspresi yang didefinisikan dalam token kecocokan pemetaan Perangkat yang didefinisikan dalam pesan perangkat. |
| Sumber Daya Perangkat belum dibuat di layanan FHIR (Tipe Resolusi: Hanya Cari)*. | Buat Sumber Daya Perangkat yang valid di layanan FHIR. Pastikan Sumber Daya Perangkat berisi pengenal yang cocok dengan pengenal perangkat yang disediakan dalam pesan masuk. |
| Sumber Daya Pasien belum dibuat di layanan FHIR (Tipe Resolusi: Hanya Cari)*. | Buat Sumber Daya Perangkat yang valid di layanan FHIR. |
Referensi Device.patient tidak diatur, atau referensi tidak valid (Tipe Resolusi: Hanya Cari)*. |
Pastikan Sumber Daya Perangkat berisi Referensi yang valid ke Sumber Daya Pasien. |
* Mulai Cepat Referensi: Sebarkan layanan MedTech menggunakan portal Azure untuk deskripsi fungsional jenis resolusi layanan MedTech (Misalnya: Cari atau Buat).
Langkah berikutnya
Pada artikel ini, Anda mempelajari cara memecahkan masalah pesan dan kondisi kesalahan layanan MedTech. Untuk mempelajari cara memecahkan masalah Perangkat layanan MedTech dan pemetaan tujuan FHIR, lihat
(FHIR®) adalah merek dagang terdaftar dari HL7 dan digunakan dengan izin HL7.