Explore curated visualizations in Azure IoT Edge

Applies to: IoT Edge 1.5

Visually explore metrics collected from IoT Edge devices using Azure Monitor workbooks. Curated monitoring workbooks for IoT Edge devices are available as 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 IoT Edge runtime. Metrics must first be ingested into a Log Analytics workspace. These views don't require metrics instrumentation from workload modules.

Access curated workbooks

Azure Monitor workbooks for IoT are templates that let you visualize device metrics. You can customize them to fit your solution.

Follow these steps to access the curated workbooks:

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

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

3. Choose a workbook 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.

See the following sections for a preview of the data and visualizations each workbook offers.

Fleet view workbook

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

Use the Settings tab to adjust thresholds to categorize devices as healthy or unhealthy.

Select the Details button to view the device list with a snapshot of aggregated primary metrics. Select the link in the Status column to view trends in an individual device's health metrics or select 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 views by selecting 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

View 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 view alert details. The Alert rule link opens the alert context, and the Device link opens the detailed metrics workbook. When opened from this view, the device details workbook automatically adjusts to the time range around the alert firing.

Customize workbooks

Azure Monitor workbooks are customizable. You can edit the public templates to suit your requirements. All the visualizations are driven by resource-centric Kusto Query Language queries on the InsightsMetrics table.

To customize a workbook, enter editing mode. Select the Edit button in the workbook's menu bar. Curated workbooks use workbook groups extensively. You might need to select Edit on several nested groups 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.