> azure-iot-operations

Expert knowledge for Azure IoT Operations development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building, debugging, or optimizing Azure IoT Operations applications. Not for Azure IoT (use azure-iot), Azure IoT Hub (use azure-iot-hub), Azure IoT Central (use azure-iot-central), Azure IoT Edge (use azure-iot-edge).

fetch
$curl "https://skillshub.wtf/MicrosoftDocs/Agent-Skills/azure-iot-operations?format=md"
SKILL.mdazure-iot-operations

Azure IoT Operations Skill

This skill provides expert guidance for Azure IoT Operations. 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-L42Diagnosing and fixing Azure IoT Operations deployment and runtime issues, including known errors, health checks, logs, and step-by-step troubleshooting guidance.
Best PracticesL43-L48Guidance for production-ready Azure IoT Operations deployments and designing highly available, resilient edge applications using the Azure MQTT broker.
Decision MakingL49-L53Guidance and examples for sizing Azure IoT Operations production deployments, including resource planning, capacity considerations, and scaling recommendations.
Architecture & Design PatternsL54-L59Akri-based device discovery architecture and patterns for deploying Azure IoT Operations in layered/segmented industrial networks (DMZ, OT/IT zones, network topologies).
Limits & QuotasL60-L64Details on MQTT broker feature support, protocol limits, and control capabilities in Azure IoT Operations, including which MQTT functions and controls are available or restricted.
SecurityL65-L81Securing Azure IoT Operations and MQTT broker: TLS/cert management, OPC UA trust, authN/authZ (RBAC, ABAC), secrets/Key Vault, secure endpoints, and image validation.
ConfigurationL82-L119Configuring Azure IoT Operations data flows, endpoints, schemas, WebAssembly, MQTT broker settings, observability, and device/asset registry to control, monitor, and persist IoT data.
Integrations & Coding PatternsL120-L137Patterns and how-tos for integrating external systems with Azure IoT Operations: OPC UA, MQTT, HTTP/SSE, cameras/ONVIF, Akri connectors, WASM/ONNX modules, and the state store protocol.
DeploymentL138-L148Deploying and managing Azure IoT Operations on Kubernetes: cluster prep, secure prod/test setups, cloning, upgrades, uninstall, edge WebAssembly deployment, and supported versions.

Troubleshooting

TopicURL
Resolve known issues in Azure IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/troubleshoot/known-issues
Troubleshoot Azure IoT Operations deployments and runtimehttps://learn.microsoft.com/en-us/azure/iot-operations/troubleshoot/troubleshoot

Best Practices

TopicURL
Apply production deployment guidelines for Azure IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/concept-production-guidelines
Design highly available edge apps with Azure MQTT brokerhttps://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/overview-edge-apps

Decision Making

TopicURL
Use Azure IoT Operations production deployment sizing exampleshttps://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/concept-production-examples

Architecture & Design Patterns

TopicURL
Understand Akri-based asset discovery architecture in Azure IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/overview-akri
Use Azure IoT Operations in layered industrial networkshttps://learn.microsoft.com/en-us/azure/iot-operations/manage-layered-network/concept-iot-operations-in-layered-network

Limits & Quotas

TopicURL
Review MQTT feature and control support in brokerhttps://learn.microsoft.com/en-us/azure/iot-operations/reference/mqtt-support

Security

TopicURL
Configure secure settings and identities for Azure IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-enable-secure-settings
Configure OPC UA certificate trust for Azure IoT Operations connectorhttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-configure-opc-ua-certificates-infrastructure
Understand OPC UA certificate security for Azure IoT Operations connectorhttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/overview-opc-ua-connector-certificates-management
Configure authentication methods for Azure MQTT brokerhttps://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-configure-authentication
Configure authorization policies for Azure MQTT brokerhttps://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-configure-authorization
Secure Azure MQTT broker endpoints with BrokerListener configurationhttps://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-configure-brokerlistener
Encrypt internal traffic for Azure IoT MQTT brokerhttps://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-encrypt-internal-traffic
Configure MQTT broker TLS, X.509, and ABAChttps://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/tutorial-tls-x509
Define custom RBAC roles for IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/reference/custom-rbac
Use built-in RBAC roles for Azure IoT Operations access controlhttps://learn.microsoft.com/en-us/azure/iot-operations/secure-iot-ops/built-in-rbac
Manage TLS certificates for Azure IoT Operations communicationshttps://learn.microsoft.com/en-us/azure/iot-operations/secure-iot-ops/howto-manage-certificates
Manage Azure IoT Operations secrets with Key Vault and Kuberneteshttps://learn.microsoft.com/en-us/azure/iot-operations/secure-iot-ops/howto-manage-secrets
Validate Azure IoT Operations container and Helm imageshttps://learn.microsoft.com/en-us/azure/iot-operations/secure-iot-ops/howto-validate-images

Configuration

TopicURL
Clean up Azure IoT Operations observability resourceshttps://learn.microsoft.com/en-us/azure/iot-operations/configure-observability-monitoring/howto-clean-up-observability-resources
Deploy observability resources and Grafana dashboardshttps://learn.microsoft.com/en-us/azure/iot-operations/configure-observability-monitoring/howto-configure-observability
Configure data flow conversions for transforming datahttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/concept-dataflow-conversions
Configure data enrichment with contextualization datasetshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/concept-dataflow-enrich
Use data flow mapping language for transformationshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/concept-dataflow-mapping
Understand and configure schema registry message schemashttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/concept-schema-registry
Configure Azure Data Lake Gen2 data flow endpointshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-adlsv2-endpoint
Configure Azure Data Explorer data flow endpointshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-adx-endpoint
Configure data flow endpoints in Azure IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-dataflow-endpoint
Configure data flow profiles to control behaviorhttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-dataflow-profile
Configure Fabric OneLake data flow endpointshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-fabric-endpoint
Configure Fabric Real-Time Intelligence data flow endpointshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-fabric-real-time-intelligence
Configure Kafka and Event Hubs data flow endpointshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-kafka-endpoint
Configure local storage endpoints for Azure IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-local-storage-endpoint
Configure MQTT data flow endpoints in IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-mqtt-endpoint
Create and configure data flows in IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-create-dataflow
Configure WebAssembly modules in IoT data flow graphshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-dataflow-graph-wasm
Configure OpenTelemetry data flow endpoints in IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/open-telemetry
Build WASM modules for data flows using VS Codehttps://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-build-wasm-modules-vscode
Configure registry endpoints for data flow graphshttps://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-configure-registry-endpoint
Configure WebAssembly graph definitions for IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-configure-wasm-graph-definitions
Use MQTT broker state store for data persistencehttps://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/overview-state-store
Define Azure IoT Operations assets and devices in Device Registryhttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/concept-assets-devices
Manage Azure IoT Operations resources in the operations experience UIhttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-use-operations-experience
Configure SSE connector assets and devices in Azure IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-use-sse-connector
Configure diagnostics for Azure IoT MQTT brokerhttps://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-broker-diagnostics
Set advanced MQTT client options on brokerhttps://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-broker-mqtt-client-options
Configure data persistence for Azure MQTT brokerhttps://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-broker-persistence
Tune Azure MQTT broker availability, scale, and memory settingshttps://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-configure-availability-scale
Configure disk-backed message buffer for MQTT brokerhttps://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-disk-backed-message-buffer
Configure Azure MQTT broker for publish/subscribe in IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/overview-broker
Monitor Layered Network Management with metricshttps://learn.microsoft.com/en-us/azure/iot-operations/reference/observability-metrics-layered-network
Use MQTT broker observability metrics in IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/reference/observability-metrics-mqtt-broker
Monitor OPC UA connector with observability metricshttps://learn.microsoft.com/en-us/azure/iot-operations/reference/observability-metrics-opcua-broker

Integrations & Coding Patterns

TopicURL
Build Akri connectors using the VS Code extensionhttps://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-build-akri-connectors-vscode
Build and deploy Akri REST connectors for IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-develop-akri-connectors
Develop Rust and Python WASM modules for IoT graphshttps://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-develop-wasm-modules
Run ONNX inference inside IoT WebAssembly data flowshttps://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-wasm-onnx-inference
Implement Azure IoT Operations state store protocolhttps://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/reference-state-store-protocol
Configure OPC UA assets and devices in Azure IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-configure-opc-ua
Ingest Kafka-compatible data into Azure IoT Operations via MQTT connectorhttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-connect-kafka
Configure control of OPC UA assets from Azure IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-control-opc-ua
Automatically discover OPC UA assets with Akri and Azure IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-detect-opc-ua-assets
Configure HTTP/REST connector assets and devices in Azure IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-use-http-connector
Use the media connector to integrate camera streams with Azure IoT Operationshttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-use-media-connector
Use the MQTT connector (preview) to model external MQTT assetshttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-use-mqtt-connector
Integrate ONVIF cameras with Azure IoT Operations via connectorhttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-use-onvif-connector
Integrate OPC UA assets with Azure IoT Operations via connectorhttps://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/overview-opc-ua-connector

Deployment

TopicURL
Clone Azure IoT Operations instances with Azure CLIhttps://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-clone-instance
Deploy Azure IoT Operations securely to production clustershttps://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-deploy-iot-operations
Deploy Azure IoT Operations to a test Kubernetes clusterhttps://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-deploy-iot-test-operations
Manage, update, and uninstall Azure IoT Operations instanceshttps://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-manage-update-uninstall
Prepare Kubernetes clusters for Azure IoT Operations deploymenthttps://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-prepare-cluster
Upgrade Azure IoT Operations deployments via portal or CLIhttps://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-upgrade
Deploy WebAssembly modules and graph definitions to IoT edgehttps://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-deploy-wasm-graph-definitions
Check Azure IoT Operations supported versions and environmentshttps://learn.microsoft.com/en-us/azure/iot-operations/overview-support

> related_skills --same-repo

> azure-well-architected

Expert guidance for designing, assessing, and optimizing Azure workloads using Azure Well Architected. Covers design review checklists, recommendations, design principles, tradeoffs, service guides, workload patterns, and assessment questions. Use when architecting new solutions, reviewing existing workloads, or applying Well-Architected principles.

> azure-web-pubsub

Expert knowledge for Azure Web PubSub development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building, debugging, or optimizing Azure Web PubSub applications. Not for Azure SignalR Service (use azure-signalr-service), Azure Event Hubs (use azure-event-hubs), Azure Service Bus (use azure-service-bus), Azure Relay (use azure-relay).

> azure-web-application-firewall

Expert knowledge for Azure Web Application Firewall development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building, debugging, or optimizing Azure Web Application Firewall applications. Not for Azure Application Gateway (use azure-application-gateway), Azure Front Door (use azure-front-door), Azure Firewall (use azure-firewall), Azure DDos Protectio

> azure-vpn-gateway

Expert knowledge for Azure VPN Gateway development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building, debugging, or optimizing Azure VPN Gateway applications. Not for Azure Virtual Network (use azure-virtual-network), Azure Virtual WAN (use azure-virtual-wan), Azure ExpressRoute (use azure-expressroute), Azure Application Gateway (use azure-applica

┌ stats

installs/wk0
░░░░░░░░░░
github stars425
██████████
first seenMar 17, 2026
└────────────

┌ repo

MicrosoftDocs/Agent-Skills
by MicrosoftDocs
└────────────

┌ tags

└────────────