Skip to content
cccskills
FreePublished on GitHub

azure-iot-edge

Expert knowledge for Azure IoT Edge development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring EFLOW devices, DPS/X.509 provisioning, gateway/nested topologies, CI/CD deployments, or IoT Edge metrics/logs, and other Azure IoT Edge related development tasks. Not for Azure IoT Hub (use azure-iot-hub), Azure IoT (use azure-iot), Azure IoT Operations (use azure-iot-operations), Azure Stack Edge (use azure-stack-edge).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills
Works withAzureKubernetes
See how to install

Files included (1)

  • SKILL.md14.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

CategoryLinesDescription
TroubleshootingL37-L47Diagnosing and fixing IoT Edge device/runtime issues, monitoring and metrics problems, Azure portal troubleshooting, and EFLOW/Windows networking and common error resolutions.
Best PracticesL48-L55Monitoring and production guidance for IoT Edge: using Azure Monitor workbooks, tracking module twin health, implementing observability, and applying production-ready best practices.
Decision MakingL56-L62Guidance on choosing IoT Edge/EFLOW platforms, provisioning methods, networking setups, and nested virtualization options for different deployment scenarios.
Architecture & Design PatternsL63-L69Design patterns for IoT Edge topologies: gateway scenarios, offline/intermittent connectivity strategies, and configuring multi-level (nested) Edge hierarchies for complex deployments
Limits & QuotasL70-L74Azure IoT Edge resource limits and quotas, including module, deployment, message, and device constraints, plus scalability and performance-related restrictions.
SecurityL75-L88Securing IoT Edge: certificates and X.509 provisioning, dTPM/EFLOW security, confidential computing modules, EST server setup, downstream auth, and Private Link/endpoint traffic protection.
ConfigurationL89-L120Configuring IoT Edge devices and EFLOW: networking, gateways, proxies, storage, GPUs, provisioning (DPS, keys, X.509), module options, metrics, and host/VM integration.
Integrations & Coding PatternsL121-L130Working 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.
DeploymentL131-L143Deploying 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

TopicURL
Troubleshoot Azure IoT Edge monitoring and metricshttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-troubleshoot-monitoring-and-faq
Diagnose and troubleshoot Azure IoT Edge deviceshttps://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot
Resolve common Azure IoT Edge errors and issueshttps://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-common-errors
Troubleshoot IoT Edge devices via Azure portalhttps://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-in-portal
Troubleshoot Azure IoT Edge for Linux on Windows deviceshttps://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-iot-edge-for-linux-on-windows
Resolve common Azure IoT Edge for Linux on Windows issueshttps://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-iot-edge-for-linux-on-windows-common-errors
Troubleshoot networking issues for EFLOW virtual machineshttps://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-iot-edge-for-linux-on-windows-networking

Best Practices

TopicURL
Use curated Azure Monitor workbooks for IoT Edgehttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-explore-curated-visualizations
Monitor IoT Edge module twins for healthhttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-monitor-module-twins
Implement observability for Azure IoT Edge systemshttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-observability
Apply production readiness best practices for Azure IoT Edgehttps://learn.microsoft.com/en-us/azure/iot-edge/production-checklist

Decision Making

TopicURL
Select and configure networking options for EFLOWhttps://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 deviceshttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-create-iot-edge-device
Choose nested virtualization options for EFLOW deploymentshttps://learn.microsoft.com/en-us/azure/iot-edge/nested-virtualization

Architecture & Design Patterns

TopicURL
Choose Azure IoT Edge gateway patterns for deviceshttps://learn.microsoft.com/en-us/azure/iot-edge/iot-edge-as-gateway
Design offline operation patterns for Azure IoT Edgehttps://learn.microsoft.com/en-us/azure/iot-edge/offline-capabilities
Design and configure nested Azure IoT Edge hierarchieshttps://learn.microsoft.com/en-us/azure/iot-edge/tutorial-nested-iot-edge

Limits & Quotas

TopicURL
Review Azure IoT Edge limits and restrictionshttps://learn.microsoft.com/en-us/azure/iot-edge/iot-edge-limits-and-restrictions

Security

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

Configuration

TopicURL
Configure Azure IoT Edge device via config.tomlhttps://learn.microsoft.com/en-us/azure/iot-edge/configure-device
Enable GPU acceleration for IoT Edge for Linux on Windowshttps://learn.microsoft.com/en-us/azure/iot-edge/gpu-acceleration
Configure IoT Edge modules to use host storagehttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-access-host-storage-from-module
Configure IoT Edge metrics collection and transporthttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-collect-and-transport-metrics
Customize the Azure IoT Edge API proxy module for gatewayshttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-configure-api-proxy-module
Configure EFLOW networking for DMZ and multiple NICshttps://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 optionshttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-configure-module-build-options
Attach and configure multiple NICs for EFLOW VMhttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-configure-multiple-nics
Configure proxy settings for Azure IoT Edge devices and moduleshttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-configure-proxy-support
Configure downstream devices to connect via IoT Edge gatewayhttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-connect-downstream-device
Configure nested Azure IoT Edge device hierarchieshttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-connect-downstream-iot-edge-device
Configure USB over IP connectivity to EFLOW VMhttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-connect-usb-devices
Create Azure Monitor alerts for IoT Edge metricshttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-create-alerts
Configure Azure IoT Edge as a transparent gatewayhttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-create-transparent-gateway
Create and configure virtual switches for EFLOWhttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-create-virtual-switch
Configure symmetric key DPS provisioning for EFLOWhttps://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 deviceshttps://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 DPShttps://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 certificateshttps://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 keyshttps://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 certificateshttps://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 keyshttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-provision-single-device-linux-symmetric
Share Windows folders with the EFLOW virtual machinehttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-share-windows-folder-to-vm
Configure IoT Edge module container createOptionshttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-use-create-options
Configure networking between Windows host and EFLOW virtual machinehttps://learn.microsoft.com/en-us/azure/iot-edge/iot-edge-for-linux-on-windows-networking
Migrate IoT Edge metrics collector to Logs Ingestionhttps://learn.microsoft.com/en-us/azure/iot-edge/migrate-metrics-collector
Configure IoT Edge deployment manifests and message routeshttps://learn.microsoft.com/en-us/azure/iot-edge/module-composition
Configure edgeAgent and edgeHub module twin propertieshttps://learn.microsoft.com/en-us/azure/iot-edge/module-edgeagent-edgehub

Integrations & Coding Patterns

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

Deployment

TopicURL
Set up CI/CD pipelines for Azure IoT Edge modules with Azure DevOpshttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-continuous-integration-continuous-deployment
Create IoT Edge automatic deployments in portalhttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-deploy-at-scale
Manage IoT Edge at-scale deployments with CLIhttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-deploy-cli-at-scale
Deploy IoT Edge modules using Azure CLIhttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-deploy-modules-cli
Install Azure IoT Edge on Kubernetes with KubeVirthttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-install-iot-edge-kubernetes
Deploy Azure IoT Edge to Ubuntu VMs with Bicephttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-install-iot-edge-ubuntuvm-bicep
Plan and execute Azure IoT Edge runtime updates on deviceshttps://learn.microsoft.com/en-us/azure/iot-edge/how-to-update-iot-edge
Check supported platforms for IoT Edge on Windowshttps://learn.microsoft.com/en-us/azure/iot-edge/iot-edge-for-linux-on-windows-support
Manage IoT Edge automatic deployments for device groupshttps://learn.microsoft.com/en-us/azure/iot-edge/module-deployment-monitoring
Check supported platforms for Azure IoT Edge deploymentshttps://learn.microsoft.com/en-us/azure/iot-edge/support

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

azure-active-directory-b2c

Free

Expert knowledge for Azure Active Directory B2C development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building B2C user flows/custom policies, configuring IdPs/MFA, securing APIs, automating CI/CD, or monitoring with Sentinel, and other Azure Active Directory B2C related development tasks. Not for Azure Role-based access control (use azure-rbac), Azure Information Protection (use azure-information-protection), Azure Security (use azure-security), Azure Sentinel (use azure-sentinel).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-advisor

Free

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing Advisor alerts, digests, recommendation states, Resource Graph queries, or RBAC access, and other Azure Advisor related development tasks. Not for Cost Management (use azure-cost-management), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy), Azure Security (use azure-security).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-ai-vision

Free

Expert knowledge for Azure AI Vision development including decision making, limits & quotas, configuration, integrations & coding patterns, and deployment. Use when using Image Analysis, Read OCR containers, smart-crop thumbnails, background removal, or video frame analysis, and other Azure AI Vision related development tasks. Not for Azure AI Custom Vision (use azure-custom-vision), Azure AI Video Indexer (use azure-video-indexer), Azure AI Document Intelligence (use azure-document-intelligence), Azure AI Immersive Reader (use azure-immersive-reader).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-aks-edge-essentials

Free

Expert knowledge for Azure Kubernetes Service Edge Essentials development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when deploying AKS Edge/Hybrid with Arc, Azure Local, GitOps, IoT/OPC/ONVIF, or Key Vault-integrated workloads, and other Azure Kubernetes Service Edge Essentials related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure IoT Edge (use azure-iot-edge), Azure Stack Edge (use azure-stack-edge), Azure Container Apps (use azure-container-apps).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-analysis-services

Free

Expert knowledge for Azure Analysis Services development including troubleshooting. Use when resolving server connectivity, firewall/VNet, DNS, client connection, or network error issues, and other Azure Analysis Services related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure SQL Database (use azure-sql-database), Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-anyscale-on-azure

Free

Expert knowledge for Azure Anyscale On Azure development including limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when registering AKS as Anyscale clouds, wiring ACR images, enabling Private Link/RBAC, ARM-based deployments, or region checks, and other Azure Anyscale On Azure related development tasks. Not for Azure Databricks (use azure-databricks), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Machine Learning (use azure-machine-learning), Azure HDInsight (use azure-hdinsight).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

See all skills by MicrosoftDocs

Report a problem with this skill