az workload-orchestration support

Preview

Note

This command group has commands that are defined in two or more extensions. Each extension will automatically install the first time you run an extension 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 (workload-orchestration extension)	Create a support bundle for troubleshooting workload orchestration issues.	Extension	Preview
az workload-orchestration support create-bundle (workload-orchestration-preview extension)	Create a support bundle for troubleshooting workload orchestration issues.	Extension	Preview

az workload-orchestration support create-bundle (workload-orchestration extension)

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 [--acquire-policy-token]
                                                [--bundle-name]
                                                [--change-reference]
                                                [--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.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--bundle-name -n

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

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--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

az workload-orchestration support create-bundle (workload-orchestration-preview extension)