You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/healthcare-apis/iot/device-data-through-iot-hub.md
+21-19Lines changed: 21 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
-
title: Receive device data through Azure IoT Hub - Azure Health Data Services
3
-
description: Learn how to deploy Azure IoT Hub with message routing to send device messages to the medtech service in Azure Health Data Services. The tutorial uses an Azure Resource Manager template in the Azure portal and Visual Studio Code with the Azure IoT Hub extension.
2
+
title: Receive device messages through Azure IoT Hub - Azure Health Data Services
3
+
description: Learn how to deploy Azure IoT Hub with message routing to send device messages to the MedTech service in Azure Health Data Services. The tutorial uses an Azure Resource Manager template in the Azure portal and Visual Studio Code with the Azure IoT Hub extension.
4
4
services: healthcare-apis
5
5
author: msjasteppe
6
6
ms.service: healthcare-apis
@@ -10,9 +10,9 @@ ms.date: 11/16/2022
10
10
ms.author: jasteppe
11
11
---
12
12
13
-
# Tutorial: Receive device data through Azure IoT Hub
13
+
# Tutorial: Receive device messages through Azure IoT Hub
14
14
15
-
For enhanced workflows and ease of use, you can use the medtech service in Azure Health Data Services with devices you create and manage through a hub in [Azure IoT Hub](../../iot-hub/iot-concepts-and-iot-hub.md). This tutorial uses an Azure Resource Manager template (ARM template) and a **Deploy to Azure** button to deploy a medtech service. The template creates a deployment that uses an instance of IoT Hub to create and manage devices. The hub then routes device messages to an event hub for the medtech service to pick up.
15
+
For enhanced workflows and ease of use, you can use the MedTech service in Azure Health Data Services to receive messages from devices you create and manage through a hub in [Azure IoT Hub](../../iot-hub/iot-concepts-and-iot-hub.md). This tutorial uses an Azure Resource Manager template (ARM template) and a **Deploy to Azure** button to deploy a MedTech service. The template creates an instance of IoT Hub to create and manage devices, and then routes device messages to an event hub for the MedTech service to pick up.
16
16
17
17
In this tutorial, you learn how to:
18
18
@@ -26,11 +26,13 @@ In this tutorial, you learn how to:
26
26
The ARM template that you use to deploy your solution in this tutorial is available at [Azure Quickstart Templates](/samples/azure/azure-quickstart-templates/iotconnectors-with-iothub/) by using the *azuredeploy.json* file on [GitHub](https://github.com/azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.healthcareapis/workspaces/iotconnectors-with-iothub).
27
27
28
28
> [!TIP]
29
-
> Learn how to [use Azure PowerShell and the Azure CLI to deploy the medtech service by using an ARM template](deploy-08-new-ps-cli.md). For more information about ARM templates, see [What are ARM templates?](../../azure-resource-manager/templates/overview.md)
29
+
> Learn how to [use Azure PowerShell and the Azure CLI to deploy the MedTech service by using an ARM template](deploy-08-new-ps-cli.md). For more information about ARM templates, see [What are ARM templates?](../../azure-resource-manager/templates/overview.md)
30
30
31
-
The following diagram demonstrates the IoT device message flow when you use a hub with the medtech service. Devices send messages to the IoT hub. The hub then routes the device messages to the device message event hub for the medtech service to pick up. The medtech service then transforms the device messages and persists them in the Fast Healthcare Interoperability Resources (FHIR®) service as FHIR Observations. For more information, see [Medtech service data flow](iot-data-flow.md).
31
+
## Device message flow
32
32
33
-
:::image type="content" source="media\iot-hub-to-iot-connector\iot-hub-to-iot-connector.png" border="false" alt-text="Diagram of the IoT message data flow through an IoT hub into the medtech service." lightbox="media\iot-hub-to-iot-connector\iot-hub-to-iot-connector.png":::
33
+
The following diagram demonstrates the IoT device message flow when you use a hub with the MedTech service. Devices send messages to the IoT hub. The hub then routes the device messages to the device message event hub for the MedTech service to pick up. The MedTech service transforms the device messages and persists them in the Fast Healthcare Interoperability Resources (FHIR®) service as FHIR Observations. For more information, see [Medtech service data flow](iot-data-flow.md).
34
+
35
+
:::image type="content" source="media\iot-hub-to-iot-connector\iot-hub-to-iot-connector.png" border="false" alt-text="Diagram of the IoT message data flow through an IoT hub into the MedTech service." lightbox="media\iot-hub-to-iot-connector\iot-hub-to-iot-connector.png":::
34
36
35
37
## Prerequisites
36
38
@@ -54,7 +56,7 @@ To begin deployment in the Azure portal, select the **Deploy to Azure** button:
54
56
55
57
[](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.healthcareapis%2Fworkspaces%2Fiotconnectors-with-iothub%2Fazuredeploy.json)
56
58
57
-
The button calls an ARM template from [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/iotconnectors-with-iothub/) to get information from your Azure subscription environment and begin deploying the medtech service and IoT Hub by using the Azure portal.
59
+
The button calls an ARM template from [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/iotconnectors-with-iothub/) to get information from your Azure subscription environment and begin deploying the MedTech service and IoT Hub by using the Azure portal.
58
60
59
61
## Configure the deployment
60
62
@@ -76,14 +78,14 @@ The button calls an ARM template from [Azure Quickstart Templates](https://azure
76
78
77
79
To learn how to get an Azure AD user object ID, see [Find the user object ID](/partner-center/find-ids-and-domain-names#find-the-user-object-id). The user object ID that's used in this tutorial is only an example. You'll use your own user object ID or the object ID of another person who you want to be able to access the FHIR service.
78
80
79
-
:::image type="content" source="media\iot-hub-to-iot-connector\iot-deploy-template-options.png" alt-text="Screenshot of Azure portal page displaying deployment options for the Azure Health Data Service medtech service." lightbox="media\iot-hub-to-iot-connector\iot-deploy-template-options.png":::
81
+
:::image type="content" source="media\iot-hub-to-iot-connector\iot-deploy-template-options.png" alt-text="Screenshot of Azure portal page displaying deployment options for the Azure Health Data Service MedTech service." lightbox="media\iot-hub-to-iot-connector\iot-deploy-template-options.png":::
80
82
81
83
Don't change the default values for **Device Mapping** and **Destination Mapping** in this tutorial. The mappings are set in the template to send a device message to your hub later in the tutorial.
82
84
83
85
> [!IMPORTANT]
84
-
> In this tutorial, the ARM template configures the medtech service to operate in Create mode. A Patient Resource and a Device Resource are created for each device that sends data to your FHIR service.
86
+
> In this tutorial, the ARM template configures the MedTech service to operate in Create mode. A Patient Resource and a Device Resource are created for each device that sends data to your FHIR service.
85
87
>
86
-
> To learn more about the medtech service resolution types Create and Lookup, see [Destination properties](deploy-05-new-config.md#destination-properties).
88
+
> To learn more about the MedTech service resolution types Create and Lookup, see [Destination properties](deploy-05-new-config.md#destination-properties).
87
89
88
90
1. To validate your configuration, select **Review + create**.
89
91
@@ -119,18 +121,18 @@ When deployment is completed, the following resources and access roles are creat
119
121
120
122
- A Health Data Services FHIR service.
121
123
122
-
- An instance of the Health Data Services medtech service, with the required [system-assigned managed identity](../../active-directory/managed-identities-azure-resources/overview.md) roles:
124
+
- An instance of the Health Data Services MedTech service, with the required [system-assigned managed identity](../../active-directory/managed-identities-azure-resources/overview.md) roles:
123
125
124
126
- For the device message event hub, the Azure Events Hubs Receiver role is assigned in the [Access control section (IAM)](../../role-based-access-control/overview.md) of the device message event hub.
125
127
126
128
- For the FHIR service, the FHIR Data Writer role is assigned in the [Access control section (IAM)](../../role-based-access-control/overview.md) of the FHIR service.
127
129
128
130
> [!TIP]
129
-
> Get detailed instructions to [manually deploy the medtech service by using the Azure portal](deploy-03-new-manual.md).
131
+
> Get detailed instructions to [manually deploy the MedTech service by using the Azure portal](deploy-03-new-manual.md).
130
132
131
133
## Create a device and send a test message
132
134
133
-
With your resources successfully deployed, next, you connect to your hub, create a device, and send a test message to the hub. After you complete these steps, your medtech service can:
135
+
With your resources successfully deployed, next, you connect to your hub, create a device, and send a test message to the hub. After you complete these steps, your MedTech service can:
134
136
135
137
- Pick up the hub-routed test message from the device message event hub.
136
138
- Transform the test message into five FHIR Observations.
@@ -198,18 +200,18 @@ You complete the steps by using Visual Studio Code with the Azure IoT Hub extens
198
200
199
201
## Review metrics from the test message
200
202
201
-
Now that you've successfully sent a test message to your hub, review your medtech service metrics. You review metrics to verify that your medtech service received, transformed, and persisted the test message to your FHIR service. To learn more, see [How to display the medtech service monitoring tab metrics](how-to-use-monitoring-tab.md).
203
+
Now that you've successfully sent a test message to your hub, review your MedTech service metrics. You review metrics to verify that your MedTech service received, transformed, and persisted the test message to your FHIR service. To learn more, see [How to display the MedTech service monitoring tab metrics](how-to-use-monitoring-tab.md).
202
204
203
-
For your medtech service metrics, you can see that your medtech service completed the following steps for the test message:
205
+
For your MedTech service metrics, you can see that your MedTech service completed the following steps for the test message:
204
206
205
207
- **Number of Incoming Messages**: Received the incoming test message from the device message event hub.
206
208
- **Number of Normalized Messages**: Created five normalized messages.
207
209
- **Number of Measurements**: Created five measurements.
208
210
- **Number of FHIR resources**: Created five FHIR resources that are persisted in your FHIR service.
209
211
210
-
:::image type="content" source="media\iot-hub-to-iot-connector\iot-metrics-tile-one.png" alt-text="Screenshot that shows a medtech service metrics tile and test data metrics." lightbox="media\iot-hub-to-iot-connector\iot-metrics-tile-one.png":::
212
+
:::image type="content" source="media\iot-hub-to-iot-connector\iot-metrics-tile-one.png" alt-text="Screenshot that shows a MedTech service metrics tile and test data metrics." lightbox="media\iot-hub-to-iot-connector\iot-metrics-tile-one.png":::
211
213
212
-
:::image type="content" source="media\iot-hub-to-iot-connector\iot-metrics-tile-two.png" alt-text="Screenshot that shows a second medtech service metrics tile and test data metrics." lightbox="media\iot-hub-to-iot-connector\iot-metrics-tile-two.png":::
214
+
:::image type="content" source="media\iot-hub-to-iot-connector\iot-metrics-tile-two.png" alt-text="Screenshot that shows a second MedTech service metrics tile and test data metrics." lightbox="media\iot-hub-to-iot-connector\iot-metrics-tile-two.png":::
213
215
214
216
## View test data in the FHIR service
215
217
@@ -219,7 +221,7 @@ To learn how to get an Azure AD access token and view FHIR resources in your FHI
219
221
220
222
## Next steps
221
223
222
-
In this tutorial, you deployed an ARM template in the Azure portal, connected to your hub in Azure IoT Hub, created a device, and sent a test message to your medtech service.
224
+
In this tutorial, you deployed an ARM template in the Azure portal, connected to your hub in Azure IoT Hub, created a device, and sent a test message to your MedTech service.
0 commit comments