Öğretici: Azure IoT Hub aracılığıyla cihaz iletileri alma

Makale
10/18/2023

MedTech hizmeti, Azure IoT Hub'daki bir IoT hub'ı aracılığıyla oluşturduğunuz ve yönettiğiniz cihazlardan iletiler alabilir. Bu öğreticide bir MedTech hizmeti dağıtmak için bir Azure Resource Manager şablonu (ARM şablonu) ve Azure'a Dağıt düğmesi kullanılır. Şablon ayrıca cihazları oluşturmak ve yönetmek için bir IoT hub'ı dağıtır ve ileti MedTech hizmetinin okuyup işlemesi için cihaz iletilerini bir olay hub'ına yönlendirir. Cihaz verileri işlendikten sonra FHIR® kaynakları, şablona da dahil edilen FHIR hizmetinde kalıcı hale alınır.

Bahşiş

MedTech hizmetinin cihaz verilerini FHIR kaynakları olarak FHIR hizmetine nasıl dönüştürdüğünü ve kalıcı hale getirdiğini öğrenmek için bkz . MedTech hizmeti cihaz veri işleme aşamalarına genel bakış.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

Azure portalında bir ARM şablonu açın.
Dağıtımınız için şablonu yapılandırın.
Bir cihaz oluşturun.
Test iletisi gönderin.
Test iletisi için ölçümleri gözden geçirin.

Bahşiş

ARM şablonları hakkında bilgi edinmek için bkz. ARM şablonları nedir?

Ön koşullar

Dağıtımınıza başlamak ve öğreticiyi tamamlamak için aşağıdaki önkoşullara sahip olmanız gerekir:

Etkin bir Azure abonelik hesabı. Azure aboneliğiniz yoksa abonelik karar kılavuzuna bakın.
Azure aboneliğinde sahip veya Katkıda Bulunan ve Kullanıcı Erişimi Yönetici istrator rol atamaları. Daha fazla bilgi için bkz. Azure rol tabanlı erişim denetimi (Azure RBAC) nedir?
Azure aboneliğinize kayıtlı Microsoft.HealthcareApis, Microsoft.EventHub ve Microsoft.Devices kaynak sağlayıcıları. Daha fazla bilgi edinmek için bkz . Azure kaynak sağlayıcıları ve türleri.
Yerel ortama yüklenmiş Visual Studio Code.
Visual Studio Code'da yüklü Azure IoT Araçları . Azure IoT Araçları, IoT hub'larına bağlanmayı, cihaz oluşturmayı ve ileti göndermeyi kolaylaştıran bir uzantı koleksiyonudur. Bu öğreticide, Dağıtılan IoT hub'ınıza bağlanmak, bir cihaz oluşturmak ve cihazdan IoT hub'ınıza test iletisi göndermek için Visual Studio Code'daki Azure IoT Hub uzantısını kullanacaksınız.

Bu önkoşullara sahip olduğunuzda, Azure'a Dağıt düğmesini kullanarak ARM şablonunu yapılandırmaya hazırsınız demektir.

ARM şablonunu gözden geçirme

Bu öğreticideki kaynakları dağıtmak için kullanılan ARM şablonu, GitHub'daki azuredeploy.json dosyasını kullanarak Azure Hızlı Başlangıç Şablonları'nda kullanılabilir.

Azure'a Dağıt düğmesini kullanma

Azure portalında dağıtıma başlamak için Azure'a Dağıt düğmesini seçin:

Dağıtımı yapılandırma

Azure portalında, Azure Hızlı Başlangıç Şablonu'nun Temel Bilgiler sekmesinde dağıtımınız için aşağıdaki bilgileri seçin veya girin:
- Abonelik: Dağıtım için kullanılacak Azure aboneliği.
- Kaynak grubu: Mevcut bir kaynak grubu veya yeni bir kaynak grubu oluşturabilirsiniz.
- Bölge: Dağıtım için kullanılan kaynak grubunun Azure bölgesi. Bölge , kaynak grubu bölgesini kullanarak otomatik olarak doldurulur.
- Temel ad: Dağıtılan Azure kaynaklarının ve hizmetlerinin adına eklenen değer. Bu öğreticideki örneklerde azuredocsdemo temel adı kullanılır. Kendi temel ad değerinizi seçebilirsiniz.
- Konum: Azure Health Veri Hizmetleri için desteklenen bir Azure bölgesi (değer, kaynak grubunuzun bulunduğu bölgeyle aynı veya farklı olabilir). Health Data Services'ın kullanılabildiği Azure bölgelerinin listesi için bkz . Bölgelere göre kullanılabilir ürünler.
- Fhir Katkıda Bulunan Asıl Kimliği (isteğe bağlı): FHIR hizmeti okuma/yazma izinleri sağlamak için Microsoft Entra kullanıcı nesnesi kimliği.
  
  Bu hesabı, bu öğreticide oluşturulan FHIR Gözlemlerini görüntülemek üzere FHIR hizmetine erişim vermek için kullanabilirsiniz. FHIR hizmetindeki iletilere erişebilmek için kendi Microsoft Entra kullanıcı nesne kimliğinizi kullanmanızı öneririz. Fhir Katkıda Bulunan Asıl Kimliği seçeneğini kullanmamayı seçerseniz metin kutusunun işaretini kaldırın.
  
  Microsoft Entra kullanıcı nesnesi kimliğini almayı öğrenmek için bkz . Kullanıcı nesne kimliğini bulma. Bu öğreticide kullanılan kullanıcı nesne kimliği yalnızca bir örnektir. Bu seçeneği kullanırsanız, kendi kullanıcı nesne kimliğinizi veya FHIR hizmetine erişebilmek istediğiniz başka bir kişinin nesne kimliğini kullanın.
- Cihaz eşleme: Bu öğretici için varsayılan değerleri bırakın.
- Hedef eşleme: Bu öğretici için varsayılan değerleri bırakın.
Yapılandırmanızı doğrulamak için Gözden geçir ve oluştur'u seçin.
Gözden geçir ve oluştur bölümünde şablon doğrulama durumunu denetleyin. Doğrulama başarılı olursa, şablonda Doğrulama Başarılı olarak görüntülenir. Doğrulama başarısız olursa, hata iletisinde belirtilen sorunu düzeltin ve gözden geçir ve yeniden oluştur'u seçin.
Başarılı bir doğrulamadan sonra dağıtımı başlatmak için Oluştur'u seçin.
Azure portalı birkaç dakika içinde dağıtımınızın tamamlandığını belirten iletiyi görüntüler.
Önemli

Olay hub'ına birden çok hizmetten erişime izin verecekseniz, her hizmetin kendi olay hub'ı tüketici grubuna sahip olması gerekir.

Tüketici grupları, birden çok kullanan uygulamanın olay akışının ayrı bir görünümüne sahip olmasını ve akışı kendi hızlarında ve kendi uzaklıklarıyla bağımsız olarak okumasını sağlar. Daha fazla bilgi için bkz . Tüketici grupları.

Örnekler:
- Aynı olay hub'ına erişen iki MedTech hizmeti.
- Aynı olay hub'ına erişen bir MedTech hizmeti ve depolama yazıcı uygulaması.

Dağıtılan kaynakları ve erişim izinlerini gözden geçirme

Dağıtım tamamlandığında aşağıdaki kaynaklar ve erişim rolleri oluşturulur:

Event Hubs ad alanı ve olay hub'ı. Bu dağıtımda olay hub'ına devicedata adı verilmiştir.
- Olay hub'ı tüketici grubu. Bu dağıtımda, tüketici grubu $Default olarak adlandırılır.
- Azure Event Hubs Veri Gönderen rolü. Bu dağıtımda, gönderen rolü devicedatasender olarak adlandırılır ve paylaşılan erişim imzası (SAS) kullanılarak olay hub'ına erişim sağlamak için kullanılabilir. SAS kullanarak erişimi yetkilendirme hakkında daha fazla bilgi edinmek için bkz . Paylaşılan Erişim İmzalarını kullanarak Event Hubs kaynaklarına erişimi yetkilendirme. Azure Event Hubs Veri Göndereni rolü bu öğreticide kullanılmaz.
Cihaz iletilerini olay hub'ına yönlendirmek için yapılandırılmış ileti yönlendirmeli IoT hub'ı.
IoT hub'ından olay hub'ına gönderme erişimi sağlayan kullanıcı tarafından atanan yönetilen kimlik. Yönetilen kimlik, olay hub'ının Erişim denetimi bölümünde (IAM) Azure Event Hubs Veri Göndereni rolüne sahiptir.
Health Data Services çalışma alanı.
Health Data Services FHIR hizmeti.
Sistem tarafından atanan yönetilen kimliğin etkinleştirildiği ve aşağıdaki erişim rollerinin verildiği Sistem Durumu Veri Hizmetleri MedTech hizmeti:
- Olay hub'ı için Azure Event Hubs Veri Alıcısı erişim rolü, olay hub'ının Erişim denetimi bölümünde (IAM) atanır.
- FHIR hizmeti için FHIR Veri Yazıcısı erişim rolü, FHIR hizmetinin Erişim denetimi bölümünde (IAM) atanır.
Uyumlu ve geçerli MedTech hizmet cihazı ve FHIR hedef eşlemeleri. Çözüm türü Oluştur olarak ayarlanır.

Önemli

Bu öğreticide ARM şablonu MedTech hizmetini Oluşturma modunda çalışacak şekilde yapılandırıyor. FHIR hizmetinize veri gönderen her cihaz için bir Hasta kaynağı ve Bir Cihaz kaynağı oluşturulur.

MedTech hizmet çözümleme türleri Oluşturma ve Arama hakkında bilgi edinmek için bkz. Hedef sekmesini yapılandırma.

Cihaz oluşturma ve test iletisi gönderme

Kaynaklarınız başarıyla dağıtıldıktan sonra IoT hub'ınıza bağlanır, bir cihaz oluşturur ve IoT hub'ına bir test iletisi gönderirsiniz. Bu adımları tamamladıktan sonra MedTech hizmetiniz şunları yapabilir:

Olay hub'ından IoT hub'ı tarafından yönlendirilen test iletisini okuyun.
Test iletisini beş FHIR Gözlemine dönüştürün.
FHIR Gözlemlerini FHIR hizmetinizde kalıcı hale getir.

Azure IoT Hub uzantısıyla Visual Studio Code kullanarak adımları tamamlarsınız:

Visual Studio Code'u Azure IoT Araçları yüklü olarak açın.
Gezgin'de, Azure IoT Hub'ın altında ... öğesini ve ardından IoT Hub'ı Seç'i seçin.
IoT hub'ınızın sağlandığı Azure aboneliğini seçin.
IoT hub'ınızı seçin. IoT hub'ınızın adı, ih- ön ekli kaynakları sağlarken sağladığınız temel addır. Örnek hub adı ih-azuredocsdemo'dur.
Gezgin'de, Azure IoT Hub'da ... öğesini ve ardından Cihaz Oluştur'u seçin. Örnek cihaz adı iot-001'dir.
Cihazdan IoT hub'ınıza test iletisi göndermek için cihaza sağ tıklayın ve IoT Hub'a D2C İletisi Gönder'i seçin.

Dekont

Bu cihazdan buluta (D2C) örnekte bulut, Azure IoT Hub'da cihaz iletisini alan IoT hub'dır. Azure IoT Hub iki yönlü iletişimi destekler. Buluttan cihaza (C2D) senaryosu ayarlamak için C2D İletisini Cihaz Bulutu'na Gönder'i seçin.
D2C İletileri Gönder bölümünde aşağıdaki değerleri seçin veya girin:
- İleti gönderilecek cihazlar: Oluşturduğunuz cihazın adı.
- Cihaz başına ileti sayısı: 1.
- İki ileti arasındaki aralık: 1 saniye.
- İleti: Düz Metin.
- Düzenle: Var olan tüm metinleri temizleyin ve aşağıdaki test iletisini kopyalayıp yapıştırın JSON.
  
  Bahşiş
  
  Aşağıdaki test iletisinin sağ köşesindeki Kopyala seçeneğini kullanabilir ve ardından Düzenle penceresine yapıştırabilirsiniz.
```
{
    "PatientId": "patient1",
    "HeartRate": 78,
    "RespiratoryRate": 12,
    "HeartRateVariability": 30,
    "BodyTemperature": 98.6,
    "BloodPressure": {
       "Systolic": 120,
       "Diastolic": 80
    }
}  
```
IoT hub'ınıza test iletisi gönderme işlemine başlamak için Gönder'i seçin.

Gönder'i seçtikten sonra FHIR kaynaklarının FHIR hizmetinde kullanılabilir olması beş dakika kadar sürebilir.

Önemli

Cihazdan buluta (D2C) iletilerde cihaz sahtekarlığına neden olmaması için Azure IoT Hub, tüm cihaz iletilerini olay hub'ına yönlendirmeden önce ek özelliklerle zenginleştirir. Örneğin: SystemProperties: iothub-connection-device-id ve Properties: iothub-creation-time-utc. Daha fazla bilgi için bkz . Kimlik sahtekarlığına karşı koruma özellikleri ve MedTech hizmeti cihaz eşlemesiyle IotJsonPathContent şablonlarını kullanma.

Zenginleştirmeler IoT hub'ı tarafından çoğaltılacağı ve MedTech hizmetinizde hataya neden olacağı için bu örnek cihaz iletisini IoT hub'ınıza göndermek istemezsiniz. Bu yalnızca cihaz iletilerinizin IoT hub'ı tarafından nasıl zenginleştirildiğinden oluşan bir örnektir.

Örneğin:

patientIdExpressionyalnızca Oluşturma modundaki MedTech hizmetleri için gereklidir, ancak Arama kullanılıyorsa, FHIR hizmetinde eşleşen Cihaz Tanımlayıcısı olan bir Cihaz kaynağı bulunmalıdır. Bu örnekte MedTech hizmetinizin Oluşturma modunda olduğu varsayılır. Bu öğreticinin Çözüm türü Oluştur olarak ayarlanır. Hedef özellikleri hakkında daha fazla bilgi için: Oluşturma ve Arama, bkz. Hedef sekmesini yapılandırma.

Test iletisindeki ölçümleri gözden geçirme

IoT hub'ınıza başarıyla bir test iletisi gönderdikten sonra artık MedTech hizmeti ölçümlerinizi gözden geçirebilirsiniz. MedTech hizmetinizin test iletisini FHIR hizmetinizde aldığını, gruplandırdığını, dönüştürdüğünü ve kalıcı hale getirdiğini doğrulamak için ölçümleri gözden geçirin. Daha fazla bilgi edinmek için bkz . MedTech hizmeti izleme ve sistem durumu denetimleri sekmelerini kullanma.

MedTech hizmeti ölçümleriniz için, MedTech hizmetinizin test iletisi için aşağıdaki adımları tamamladığını görebilirsiniz:

Gelen İleti Sayısı: Olay hub'ından gelen test iletisi alındı.
Normalleştirilmiş İleti Sayısı: Beş normalleştirilmiş ileti oluşturuldu.
Ölçü Sayısı: Beş ölçüm oluşturuldu.
FHIR kaynak sayısı: FHIR hizmetinizde kalıcı olan beş FHIR kaynağı oluşturuldu.

FHIR hizmetinde test verilerini görüntüleme

Dağıtım şablonunda Fhir Katkıda Bulunan Asıl Kimliği seçeneği için isteğe bağlı değer olarak kendi Microsoft Entra kullanıcı nesne kimliğinizi sağladıysanız, FHIR hizmetinizdeki FHIR kaynaklarını sorgulayabilirsiniz. IoT hub'ına gönderilen ve MedTech hizmeti tarafından işlenen test iletisine dayalı olarak FHIR hizmetinde aşağıdaki FHIR Gözlem kaynaklarını görmeyi bekleyebilirsiniz:

Kalp Hızı
Solunum Hızı
HeartRateVariability
BodyTemperature
BloodPressure

Microsoft Entra erişim belirtecini almayı ve FHIR hizmetinizdeki FHIR kaynaklarını görüntülemeyi öğrenmek için bkz . Postman kullanarak erişim. Test iletisi tarafından oluşturulan FHIR Gözlem kaynaklarını görüntülemek için Postman GET isteğinizde aşağıdaki değerleri kullanmanız gerekir: {{fhirurl}}/Observation

Sonraki adımlar

MedTech hizmeti için bir dağıtım yöntemi seçin

MedTech hizmeti cihaz veri işleme aşamaları genel bakış

MedTech hizmeti hakkında sık sorulan sorular

Dekont

FHIR®, HL7'nin tescilli ticari markasıdır ve HL7'nin izniyle kullanılır.

Aracılığıyla paylaş