az iot ops support

  • Preview
  • Reference

Note

This reference is part of the azure-iot-ops extension for the Azure CLI (version 2.46.0 or higher). The extension will automatically install the first time you run an az iot ops support command. Learn more about extensions.

Command group 'iot ops' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

IoT Operations support command space.

Commands

Name Description Type Status
az iot ops support create-bundle

Creates a standard support bundle zip archive for use in troubleshooting and diagnostics.

 Extension Preview

az iot ops support create-bundle

Preview

Command group 'iot ops' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Creates a standard support bundle zip archive for use in troubleshooting and diagnostics.

{Supported service APIs}

  • mq.iotoperations.azure.com/[v1beta1]
  • opcuabroker.iotoperations.azure.com/[v1beta1]
  • dataprocessor.iotoperations.azure.com/[v1]
  • orchestrator.iotoperations.azure.com/[v1]
  • akri.sh/[v0]
  • layerednetworkmgmt.iotoperations.azure.com/[v1beta1]
  • deviceregistry.microsoft.com/[v1beta1]
  • clusterconfig.azure.com/[v1].
az iot ops support create-bundle [--bundle-dir]
                                 [--context]
                                 [--log-age]
                                 [--mq-traces {false, true}]
                                 [--ops-service {akri, auto, billing, dataprocessor, deviceregistry, lnm, mq, opcua, orc}]

Examples

Basic usage with default options. This form of the command will auto detect IoT Operations APIs and build a suitable bundle capturing the last 24 hours of container logs. The bundle will be produced in the current working directory.

az iot ops support create-bundle

Constrain data capture on a specific service as well as producing the bundle in a custom output dir.

az iot ops support create-bundle --ops-service opcua --bundle-dir ~/ops

Specify a custom container log age in seconds.

az iot ops support create-bundle --ops-service mq --log-age 172800

Include mq traces in the support bundle. This is an alias for stats trace fetch capability.

az iot ops support create-bundle --ops-service mq --mq-traces

Optional Parameters

--bundle-dir

The local directory the produced bundle will be saved to. If no directory is provided the current directory is used.

--context

Kubeconfig context name to use for k8s cluster communication. If no context is provided current_context is used.

--log-age

Container log age in seconds.

default value: 86400
--mq-traces

Include mq traces in the support bundle. Usage may add considerable size to the produced bundle.

accepted values: false, true
--ops-service --svc

The IoT Operations service the support bundle creation should apply to. If auto is selected, the operation will detect which services are available.

accepted values: akri, auto, billing, dataprocessor, deviceregistry, lnm, mq, opcua, orc
default value: auto
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.