az iot ops broker
Note
This reference is part of the azure-iot-ops extension for the Azure CLI (version 2.53.0 or higher). The extension will automatically install the first time you run an az iot ops broker command. Learn more about extensions.
Command group 'iot ops' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Mqtt broker management and operations.
Commands
| Name | Description | Type | Status |
|---|---|---|---|
| az iot ops broker authn |
Broker authentication management. |
Extension | Preview |
| az iot ops broker authn list |
List mqtt broker authentication resources associated with an instance. |
Extension | Preview |
| az iot ops broker authn show |
Show details of an mqtt broker authentication resource. |
Extension | Preview |
| az iot ops broker authz |
Broker authorization management. |
Extension | Preview |
| az iot ops broker authz list |
List mqtt broker authorization resources associated with an instance. |
Extension | Preview |
| az iot ops broker authz show |
Show details of an mqtt broker authorization resource. |
Extension | Preview |
| az iot ops broker list |
List mqtt brokers associated with an instance. |
Extension | Preview |
| az iot ops broker listener |
Broker listener management. |
Extension | Preview |
| az iot ops broker listener list |
List mqtt broker listeners associated with a broker. |
Extension | Preview |
| az iot ops broker listener show |
Show details of an mqtt broker listener. |
Extension | Preview |
| az iot ops broker show |
Show details of an mqtt broker. |
Extension | Preview |
| az iot ops broker stats |
Show dmqtt running statistics. |
Extension | Preview |
az iot ops broker list
Command group 'iot ops' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
List mqtt brokers associated with an instance.
az iot ops broker list --instance
--resource-groupExamples
Enumerate all brokers in the instance 'mycluster-ops-instance'.
az iot ops broker list --in mycluster-ops-instance -g myresourcegroupRequired Parameters
IoT Operations instance name.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
az iot ops broker show
Command group 'iot ops' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Show details of an mqtt broker.
az iot ops broker show --instance
--name
--resource-groupExamples
Show details of the default broker 'broker' in the instance 'mycluster-ops-instance'.
az iot ops broker show -n broker --in mycluster-ops-instance -g myresourcegroupRequired Parameters
IoT Operations instance name.
Mqtt broker name.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
az iot ops broker stats
Command group 'iot ops' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Show dmqtt running statistics.
{Supported service APIs}
- mqttbroker.iotoperations.azure.com/v1beta1.
az iot ops broker stats [--context]
[--metrics-port]
[--namespace]
[--protobuf-port]
[--raw {false, true}]
[--refresh]
[--trace-dir]
[--trace-ids]
[--watch {false, true}]Examples
Fetch key performance indicators from the diagnostics Prometheus metrics endpoint.
az iot ops broker statsSame as prior example except with a dynamic display that refreshes periodically.
az iot ops broker stats --watchReturn the raw output of the metrics endpoint with minimum processing.
az iot ops broker stats --rawFetch all available mq traces from the diagnostics Protobuf endpoint. This will produce a `.zip` with both `Otel` and Grafana `tempo` file formats. A trace files last modified attribute will match the trace timestamp.
az iot ops broker stats --trace-dir .Fetch traces by trace Ids provided in space-separated hex format. Only `Otel` format is shown.
az iot ops broker stats --trace-ids 4e84000155a98627cdac7de46f53055dOptional Parameters
Kubeconfig context name to use for k8s cluster communication. If no context is provided current_context is used.
Diagnostic service metrics API port.
K8s cluster namespace the command should operate against. If no namespace is provided the kubeconfig current_context namespace will be used. If not defined, the fallback value azure-iot-operations will be used.
Diagnostic service protobuf API port.
Return raw output from the metrics API.
Number of seconds between a stats refresh. Applicable with --watch.
Local directory where traces will be bundled and stored at.
Space-separated trace ids in hex format.
The operation blocks and dynamically updates a stats table.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
