Del via

az workload-orchestration support

  • Preview

Note

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

This command group is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Commands for troubleshooting and diagnostics of workload orchestration deployments.

Commands

Name Description Type Status
az workload-orchestration support create-bundle

Create a support bundle for troubleshooting workload orchestration issues.

 Extension Preview

az workload-orchestration support create-bundle

Preview

Command group 'workload-orchestration support' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Create a support bundle for troubleshooting workload orchestration issues.

Collects cluster information, resource descriptions, container logs, and runs prerequisite validation checks. The output is a zip file that can be shared with Microsoft support for troubleshooting Day 0 (installation) and Day N (runtime) issues.

Collected data includes:

  • Cluster info (version, nodes, namespaces)
  • Pod/Deployment/Service/DaemonSet/Event descriptions per namespace
  • Container logs (tailed by default)
  • Network configuration (kube-proxy, external services, pod CIDRs)
  • StorageClass, PV, webhook, CRD inventory
  • WO component health (Symphony, cert-manager)
  • Prerequisite checks (K8s version, node capacity, DNS, storage, RBAC).
az workload-orchestration support create-bundle [--bundle-name]
                                                [--full-logs]
                                                [--kube-config]
                                                [--kube-context]
                                                [--namespaces]
                                                [--output-dir]
                                                [--skip-checks]
                                                [--skip-logs]
                                                [--tail-lines]

Examples

Create a support bundle with defaults

az workload-orchestration support create-bundle

Create a named bundle

az workload-orchestration support create-bundle --bundle-name my-cluster-debug

Create a bundle in a specific directory

az workload-orchestration support create-bundle --output-dir /tmp/bundles

Collect full logs (no tail) for WO namespace only

az workload-orchestration support create-bundle --full-logs --namespaces workloadorchestration

Run checks only, skip log collection

az workload-orchestration support create-bundle --skip-logs

Use a specific kubeconfig and context

az workload-orchestration support create-bundle --kube-config ~/.kube/prod-config --kube-context my-cluster

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--bundle-name -n

Optional name for the support bundle. Defaults to wo-support-bundle-YYYYMMDD-HHMMSS.

--full-logs

Collect full container logs instead of tailing. Warning: may produce very large bundles.

Property Value
Default value: False
--kube-config

Path to kubeconfig file. Defaults to ~/.kube/config.

--kube-context

Kubernetes context to use. Defaults to current context.

--namespaces

Kubernetes namespaces to collect logs and resources from. Defaults to kube-system, workloadorchestration, cert-manager.

--output-dir -d

Directory where the support bundle zip will be saved. Defaults to current directory.

--skip-checks

Skip prerequisite validation checks and only collect logs/resources.

Property Value
Default value: False
--skip-logs

Skip container log collection and only run checks/collect resources.

Property Value
Default value: False
--tail-lines

Number of log lines to collect per container (default: 1000). Use --full-logs to collect all lines.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Property Value
Default value: False