azure-iot-edge

Azure IoT Edge Skill

This skill provides expert guidance for Azure IoT Edge. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L37-L47	Diagnosing and fixing IoT Edge device/runtime issues, monitoring and metrics problems, Azure portal troubleshooting, and EFLOW/Windows networking and common error resolutions.
Best Practices	L48-L55	Monitoring and production guidance for IoT Edge: using Azure Monitor workbooks, tracking module twin health, implementing observability, and applying production-ready best practices.
Decision Making	L56-L62	Guidance on choosing IoT Edge/EFLOW platforms, provisioning methods, networking setups, and nested virtualization options for different deployment scenarios.
Architecture & Design Patterns	L63-L69	Design patterns for IoT Edge topologies: gateway scenarios, offline/intermittent connectivity strategies, and configuring multi-level (nested) Edge hierarchies for complex deployments
Limits & Quotas	L70-L74	Azure IoT Edge resource limits and quotas, including module, deployment, message, and device constraints, plus scalability and performance-related restrictions.
Security	L75-L88	Securing IoT Edge: certificates and X.509 provisioning, dTPM/EFLOW security, confidential computing modules, EST server setup, downstream auth, and Private Link/endpoint traffic protection.
Configuration	L89-L120	Configuring IoT Edge devices and EFLOW: networking, gateways, proxies, storage, GPUs, provisioning (DPS, keys, X.509), module options, metrics, and host/VM integration.
Integrations & Coding Patterns	L121-L130	Working with IoT Edge metrics, logs, and direct methods, integrating custom modules with IoT Hub, and managing IoT Edge on EFLOW via PowerShell for monitoring and remote operations.
Deployment	L131-L143	Deploying and updating IoT Edge at scale: CI/CD pipelines, portal/CLI deployments, Kubernetes/VM installs, runtime updates, and supported platforms for devices and device groups.

Troubleshooting

Topic	URL
Troubleshoot Azure IoT Edge monitoring and metrics	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-troubleshoot-monitoring-and-faq
Diagnose and troubleshoot Azure IoT Edge devices	https://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot
Resolve common Azure IoT Edge errors and issues	https://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-common-errors
Troubleshoot IoT Edge devices via Azure portal	https://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-in-portal
Troubleshoot Azure IoT Edge for Linux on Windows devices	https://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-iot-edge-for-linux-on-windows
Resolve common Azure IoT Edge for Linux on Windows issues	https://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-iot-edge-for-linux-on-windows-common-errors
Troubleshoot networking issues for EFLOW virtual machines	https://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-iot-edge-for-linux-on-windows-networking

Best Practices

Topic	URL
Use curated Azure Monitor workbooks for IoT Edge	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-explore-curated-visualizations
Monitor IoT Edge module twins for health	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-monitor-module-twins
Implement observability for Azure IoT Edge systems	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-observability
Apply production readiness best practices for Azure IoT Edge	https://learn.microsoft.com/en-us/azure/iot-edge/production-checklist

Decision Making

Topic	URL
Select and configure networking options for EFLOW	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-configure-iot-edge-for-linux-on-windows-networking
Choose platform and provisioning options for IoT Edge devices	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-create-iot-edge-device
Choose nested virtualization options for EFLOW deployments	https://learn.microsoft.com/en-us/azure/iot-edge/nested-virtualization

Architecture & Design Patterns

Topic	URL
Choose Azure IoT Edge gateway patterns for devices	https://learn.microsoft.com/en-us/azure/iot-edge/iot-edge-as-gateway
Design offline operation patterns for Azure IoT Edge	https://learn.microsoft.com/en-us/azure/iot-edge/offline-capabilities
Design and configure nested Azure IoT Edge hierarchies	https://learn.microsoft.com/en-us/azure/iot-edge/tutorial-nested-iot-edge

Limits & Quotas

Topic	URL
Review Azure IoT Edge limits and restrictions	https://learn.microsoft.com/en-us/azure/iot-edge/iot-edge-limits-and-restrictions

Security

Topic	URL
Deploy confidential computing applications as IoT Edge modules	https://learn.microsoft.com/en-us/azure/iot-edge/deploy-confidential-applications
Configure dTPM access for IoT Edge on EFLOW	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-access-dtpm
Configure authentication for IoT Edge downstream devices	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-authenticate-downstream-device
Create and install test certificates for Azure IoT Edge	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-create-test-certificates
Manage certificates for secure Azure IoT Edge devices	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-manage-device-certificates
Provision Linux IoT Edge device using X.509 certificates	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-provision-single-device-linux-x509
Configure certificate-based security for Azure IoT Edge	https://learn.microsoft.com/en-us/azure/iot-edge/iot-edge-certs
Understand and configure security principles for IoT Edge for Linux on Windows	https://learn.microsoft.com/en-us/azure/iot-edge/iot-edge-for-linux-on-windows-security
Configure EST server security for Azure IoT Edge devices	https://learn.microsoft.com/en-us/azure/iot-edge/tutorial-configure-est-server
Secure IoT Edge traffic with Private Link and endpoints	https://learn.microsoft.com/en-us/azure/iot-edge/using-private-link

Configuration

Topic	URL
Configure Azure IoT Edge device via config.toml	https://learn.microsoft.com/en-us/azure/iot-edge/configure-device
Enable GPU acceleration for IoT Edge for Linux on Windows	https://learn.microsoft.com/en-us/azure/iot-edge/gpu-acceleration
Configure IoT Edge modules to use host storage	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-access-host-storage-from-module
Configure IoT Edge metrics collection and transport	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-collect-and-transport-metrics
Customize the Azure IoT Edge API proxy module for gateways	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-configure-api-proxy-module
Configure EFLOW networking for DMZ and multiple NICs	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-configure-iot-edge-for-linux-on-windows-iiot-dmz
Configure IoT Edge module build and deployment options	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-configure-module-build-options
Attach and configure multiple NICs for EFLOW VM	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-configure-multiple-nics
Configure proxy settings for Azure IoT Edge devices and modules	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-configure-proxy-support
Configure downstream devices to connect via IoT Edge gateway	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-connect-downstream-device
Configure nested Azure IoT Edge device hierarchies	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-connect-downstream-iot-edge-device
Configure USB over IP connectivity to EFLOW VM	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-connect-usb-devices
Create Azure Monitor alerts for IoT Edge metrics	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-create-alerts
Configure Azure IoT Edge as a transparent gateway	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-create-transparent-gateway
Create and configure virtual switches for EFLOW	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-create-virtual-switch
Configure symmetric key DPS provisioning for EFLOW	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-provision-devices-at-scale-linux-on-windows-symmetric
Configure TPM-based DPS provisioning for EFLOW devices	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-provision-devices-at-scale-linux-on-windows-tpm
Autoprovision EFLOW IoT Edge devices at scale with X.509 and DPS	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-provision-devices-at-scale-linux-on-windows-x509
Configure large-scale IoT Edge provisioning with X.509 certificates	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-provision-devices-at-scale-linux-x509
Provision a single EFLOW IoT Edge device with symmetric keys	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-provision-single-device-linux-on-windows-symmetric
Provision EFLOW IoT Edge device using X.509 certificates	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-provision-single-device-linux-on-windows-x509
Provision a single Linux IoT Edge device with symmetric keys	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-provision-single-device-linux-symmetric
Share Windows folders with the EFLOW virtual machine	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-share-windows-folder-to-vm
Configure IoT Edge module container createOptions	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-use-create-options
Configure networking between Windows host and EFLOW virtual machine	https://learn.microsoft.com/en-us/azure/iot-edge/iot-edge-for-linux-on-windows-networking
Migrate IoT Edge metrics collector to Logs Ingestion	https://learn.microsoft.com/en-us/azure/iot-edge/migrate-metrics-collector
Configure IoT Edge deployment manifests and message routes	https://learn.microsoft.com/en-us/azure/iot-edge/module-composition
Configure edgeAgent and edgeHub module twin properties	https://learn.microsoft.com/en-us/azure/iot-edge/module-edgeagent-edgehub

Integrations & Coding Patterns

Topic	URL
Access and consume Azure IoT Edge built-in metrics	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-access-built-in-metrics
Add custom metrics from IoT Edge modules	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-add-custom-metrics
Use IoT Edge agent direct methods for remote management	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-edgeagent-direct-method
Retrieve and upload Azure IoT Edge logs via direct methods	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-retrieve-iot-edge-logs
Develop Azure IoT Edge modules that integrate with IoT Hub	https://learn.microsoft.com/en-us/azure/iot-edge/module-development
Use EFLOW PowerShell functions to manage IoT Edge	https://learn.microsoft.com/en-us/azure/iot-edge/reference-iot-edge-for-linux-on-windows-functions

Deployment

Topic	URL
Set up CI/CD pipelines for Azure IoT Edge modules with Azure DevOps	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-continuous-integration-continuous-deployment
Create IoT Edge automatic deployments in portal	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-deploy-at-scale
Manage IoT Edge at-scale deployments with CLI	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-deploy-cli-at-scale
Deploy IoT Edge modules using Azure CLI	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-deploy-modules-cli
Install Azure IoT Edge on Kubernetes with KubeVirt	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-install-iot-edge-kubernetes
Deploy Azure IoT Edge to Ubuntu VMs with Bicep	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-install-iot-edge-ubuntuvm-bicep
Plan and execute Azure IoT Edge runtime updates on devices	https://learn.microsoft.com/en-us/azure/iot-edge/how-to-update-iot-edge
Check supported platforms for IoT Edge on Windows	https://learn.microsoft.com/en-us/azure/iot-edge/iot-edge-for-linux-on-windows-support
Manage IoT Edge automatic deployments for device groups	https://learn.microsoft.com/en-us/azure/iot-edge/module-deployment-monitoring
Check supported platforms for Azure IoT Edge deployments	https://learn.microsoft.com/en-us/azure/iot-edge/support