azure-iot-operations

name	azure-iot-operations
description	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 MQTT data flows, WASM/Dapr connectors, OPC UA pipelines, ISA‑95 namespaces, or secure edge deployments, and other Azure IoT Operations related development tasks. Not for Azure IoT (use azure-iot), Azure IoT Hub (use azure-iot-hub), Azure IoT Edge (use azure-iot-edge), Azure IoT Central (use azure-iot-central).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-09","generator":"docs2skills/1.0.0"}

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

Category	Lines	Description
Troubleshooting	L37-L46	Diagnosing and fixing Azure IoT Operations issues: debugging WASM modules, private network connectivity, health reason codes, known component bugs, tooling, and deployment/config problems.
Best Practices	L47-L54	Guidance for production-ready Azure IoT Operations: deployment patterns, HA MQTT edge app design, using state store for durable edge data, and testing/troubleshooting MQTT connectivity.
Decision Making	L55-L65	Guidance for planning and choosing Azure IoT Operations architectures: data flows vs graphs, deployment topology/sizing, MQTT broker diagnostics, buffering and persistence, and OPC UA asset discovery modes.
Architecture & Design Patterns	L66-L71	Designing Azure IoT architectures using ISA-95 unified namespace concepts and planning layered, segmented networking topologies for secure, scalable IoT Operations deployments.
Limits & Quotas	L72-L77	Planning resource capacity for Azure IoT Operations and understanding MQTT broker limits, including feature constraints and packet size/throughput quotas.
Security	L78-L94	Securing Azure IoT Operations: TLS/mutual TLS, MQTT authz/authn, OPC UA trust, RBAC/ABAC, cert and secret management, image verification, and internal traffic encryption.
Configuration	L95-L137	Configuring IoT data flows, endpoints, transforms, MQTT/broker options, connectors, storage/analytics sinks, observability, health, metrics, and private connectivity in Azure IoT Operations.
Integrations & Coding Patterns	L138-L157	Patterns and code for integrating Azure IoT data flows: WASM transforms, MQTT/Dapr/Akri connectors, OPC UA/media capture, ONNX inference, enrichment, routing, and state store usage.
Deployment	L158-L170	Deploying, upgrading, cloning, and managing Azure IoT Operations instances, including secure production/test setups, private networks, Dapr/WASM components, and supported versions.

Troubleshooting

Topic	URL
Debug Azure IoT WASM modules in VS Code	https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-debug-wasm-modules
Troubleshoot private connectivity in Azure IoT Operations	https://learn.microsoft.com/en-us/azure/iot-operations/manage-layered-network/howto-troubleshoot-private-connectivity
Interpret Azure IoT Operations health reason codes	https://learn.microsoft.com/en-us/azure/iot-operations/reference/health-status-reason-codes
Resolve known issues in Azure IoT Operations components	https://learn.microsoft.com/en-us/azure/iot-operations/troubleshoot/known-issues
Use tools to troubleshoot Azure IoT Operations	https://learn.microsoft.com/en-us/azure/iot-operations/troubleshoot/tips-tools
Troubleshoot Azure IoT Operations deployments and configuration	https://learn.microsoft.com/en-us/azure/iot-operations/troubleshoot/troubleshoot

Best Practices

Topic	URL
Apply production deployment guidelines for Azure IoT Operations	https://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/concept-production-guidelines
Design highly available edge apps with Azure IoT Operations MQTT broker	https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/overview-edge-apps
Use Azure IoT Operations state store for persistent edge data	https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/overview-state-store
Test MQTT broker connectivity in Azure IoT Operations	https://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-test-connection

Decision Making

Topic	URL
Select between data flows and data flow graphs	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/overview-dataflow-comparison
Plan production-scale Azure IoT Operations deployments	https://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/concept-production-examples
Plan Azure IoT Operations deployment topology and sizing	https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning
Plan MQTT broker diagnostics configuration	https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning-diagnostics
Plan disk-backed message buffering for MQTT broker	https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning-disk-buffer
Decide MQTT broker persistence strategy for IoT Operations	https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning-persistence
Choose OPC UA asset discovery modes in Azure IoT	https://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/concept-opc-ua-asset-discovery

Architecture & Design Patterns

Topic	URL
Build ISA-95 unified namespace with Azure IoT	https://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-build-unified-namespace
Design layered networking for Azure IoT Operations deployments	https://learn.microsoft.com/en-us/azure/iot-operations/manage-layered-network/concept-layered-network

Limits & Quotas

Topic	URL
Plan Azure IoT Operations baseline resource usage	https://learn.microsoft.com/en-us/azure/iot-operations/reference/concept-resource-profiles
Review MQTT feature and packet limits in Azure IoT Operations broker	https://learn.microsoft.com/en-us/azure/iot-operations/reference/mqtt-support

Security

Topic	URL
Configure custom certificate issuer for Azure IoT Operations	https://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-bring-your-own-issuer
Plan internal traffic encryption for MQTT broker pods	https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning-encryption
Configure OPC UA certificate trust for IoT Operations	https://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-configure-opc-ua-certificates-infrastructure
Configure OPC UA certificate trust for Azure IoT Operations	https://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/overview-opc-ua-connector-certificates-management
Configure authentication for Azure IoT Operations MQTT broker	https://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-configure-authentication
Configure authorization policies for Azure IoT Operations MQTT broker	https://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-configure-authorization
Secure MQTT broker endpoints with BrokerListener configuration	https://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-configure-brokerlistener
Configure TLS, X.509 auth, and ABAC for IoT MQTT	https://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/tutorial-tls-x509
Define custom RBAC roles for IoT Operations	https://learn.microsoft.com/en-us/azure/iot-operations/reference/custom-rbac

Configuration

Topic	URL
Understand and configure data flow graphs in Azure IoT	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/concept-dataflow-graphs
Configure input and output schemas on data flow graph node connections	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/concept-dataflow-graphs-schema
Configure Azure Data Lake Gen2 endpoints for IoT data	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-adlsv2-endpoint
Configure Azure Data Explorer endpoints for IoT data	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-adx-endpoint
Configure destinations and dynamic topics for IoT data flows	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-dataflow-destination
Configure data flow endpoints in Azure IoT Operations	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-dataflow-endpoint
Configure data flow profiles and instance counts	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-dataflow-profile
Configure data flow sources and topics in Azure IoT Operations	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-dataflow-source
Configure buffering and disk persistence for IoT data flows	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-configure-disk-persistence

Integrations & Coding Patterns

Topic	URL
Use expression language in Azure IoT data flows	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/concept-dataflow-graphs-expressions
Use custom WASM transforms in Azure IoT data flows	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-dataflow-graph-wasm
Configure external dataset enrichment in IoT data flows	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-dataflow-graphs-enrich
Filter and route messages in Azure IoT Operations data flow graphs	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-dataflow-graphs-filter-route
Route MQTT messages by content in IoT data flows	https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/howto-dataflow-graphs-topic-routing
Build and test WASM modules for Azure IoT data flows	https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-build-wasm-modules
Build and deploy custom Akri REST connectors	https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-develop-akri-connectors
Develop Dapr apps integrating with MQTT broker	https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-develop-dapr-apps
Run ONNX inference inside IoT WASM data flows	https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-wasm-onnx-inference
Validate WASM messages with Azure IoT schema registry

Deployment

Topic	URL
Clean up Azure IoT Operations observability resources	https://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-clean-up-observability-resources
Deploy Azure IoT Operations securely to production clusters	https://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-deploy-iot-operations
Deploy Azure IoT Operations to a test cluster	https://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-deploy-iot-test-operations
Deploy Dapr pluggable components with MQTT broker	https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-deploy-dapr
Deploy WASM modules and graph definitions for IoT data flows	https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-deploy-wasm-graph-definitions
Deploy Azure IoT Operations in layered private networks	https://learn.microsoft.com/en-us/azure/iot-operations/end-to-end-tutorials/tutorial-layered-network-private-connectivity
Clone Azure IoT Operations instances using Azure CLI	https://learn.microsoft.com/en-us/azure/iot-operations/manage-iot-ops/howto-clone-instance
Manage, update, and uninstall Azure IoT Operations instances	https://learn.microsoft.com/en-us/azure/iot-operations/manage-iot-ops/howto-manage-update-uninstall
Upgrade Azure IoT Operations deployments to newer versions	https://learn.microsoft.com/en-us/azure/iot-operations/manage-iot-ops/howto-upgrade
Check Azure IoT Operations supported versions and environments