Explore curated visualizations in Azure IoT Edge

Applies to: IoT Edge 1.5 IoT Edge 1.4

You can visually explore metrics collected from IoT Edge devices using Azure Monitor workbooks. Curated monitoring workbooks for IoT Edge devices are provided in the form of public templates:

• For devices connected to IoT Hub, from the IoT Hub page in the Azure portal, navigate to the Workbooks page in the Monitoring section.
• For devices connected to IoT Central, from the IoT Central page in the Azure portal, navigate to the Workbooks page in the Monitoring section.

Curated workbooks use built-in metrics from the IoT Edge runtime. They first need metrics to be ingested into a Log Analytics workspace. These views don't need any metrics instrumentation from the workload modules.

Access curated workbooks

Azure Monitor workbooks for IoT are a set of templates that you can use to visualize your device metrics. They can be customized to fit your solution.

To access the curated workbooks, use the following steps:

1. Sign in to the Azure portal and navigate to your IoT Hub or IoT Central application.

2. Select Workbooks from the Monitoring section of the menu.

3. Choose the workbook that you want to explore from the list of public templates:

• Fleet View: Monitor your fleet of devices across multiple IoT Hubs or Central Apps, and drill into specific devices for a health snapshot.

• Device Details: Visualize device details around messaging, modules, and host components on an IoT Edge device.

• Alerts: View triggered alerts for devices across multiple IoT resources.

Use the following sections to get a preview of the kind of data and visualizations that each workbook offers.

Fleet view workbook

By default, this view shows the health of devices associated with the current IoT cloud resource. You can select multiple IoT resources using the dropdown control on the top left.

Use the Settings tab to adjust the various thresholds to categorize the device as Healthy or Unhealthy.

Select the Details button to see the device list with a snapshot of aggregated, primary metrics. Select the link in the Status column to view the trend of an individual device's health metrics or the device name to view its detailed metrics.

Device details workbook

The device details workbook has three views:

• The Messaging view visualizes the message routes for the device and reports on the overall health of the messaging system.
• The Modules view shows how the individual modules on a device are performing.
• The Host view shows information about the host device including version information for host components and resource use.

Switch between the views using the tabs at the top of the workbook.

The device details workbook also integrates with the IoT Edge portal-based troubleshooting experience. You can pull Live logs from your device using this feature. Access this experience by selecting the Troubleshoot <device name> live button above the workbook.

Alerts workbook

See the generated alerts from pre-created alert rules in the Alerts workbook. This view lets you see alerts from multiple IoT Hubs or IoT Central applications.

Select a severity row to see alerts details. The Alert rule link takes you to the alert context and the Device link opens the detailed metrics workbook. When opened from this view, the device details workbook is automatically adjusted to the time range around when the alert fired.

Customize workbooks

To begin customizing a workbook, first enter editing mode. Select the Edit button in the menu bar of the workbook. Curated workbooks make extensive use of workbook groups. You may need to select Edit on several nested groups before being able to view a visualization query.

Save your changes as a new workbook. You can share the saved workbook with your team or deploy them programmatically as part of your organization's resource deployments.

Next steps

Customize your monitoring solution with alert rules and metrics from custom modules.