Skillshub azure-iot-operations

Azure IoT Operations Skill

install
source · Clone the upstream repo
git clone https://github.com/ComeOnOliver/skillshub
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/ComeOnOliver/skillshub "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/MicrosoftDocs/Agent-Skills/azure-iot-operations" ~/.claude/skills/comeonoliver-skillshub-azure-iot-operations && rm -rf "$T"
manifest: skills/MicrosoftDocs/Agent-Skills/azure-iot-operations/SKILL.md
source content

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