CmdID

CmdID / az / az webapp / az webapp troubleshoot

az webapp troubleshoot config

Validate configuration for a Linux web app and surface a recent runtime error. Azure CLI reference

Aggregates two data sources into a single report: (1) Built-in configuration checks — a set of common Linux App Service settings (linuxFxVersion, port binding, startup command, alwaysOn, health check path, ...) evaluated against the running site's configuration snapshot. (2) The site runtime status error reported by App Service for the worker represented by the configuration-check snapshot. Use `--instance` with a worker machine name to retrieve that worker's configuration checks. The instance ID returned by those checks is used to select the matching runtime error. If the configuration snapshot is unavailable, the machine name is resolved through ARM so an error from another worker is not returned. Runtime errors are surfaced only when they occurred within the last 15 minutes. Older errors are omitted from both structured output and the `--report` view. For a 24-hour lookback of runtime status and startup attempts, run `az webapp troubleshoot status`. By default the command returns a structured payload so the standard `-o json/yaml/tsv/table` formatters handle output. Pass `--report` to print a human-readable two-section report to stdout instead.

4 examples 5 options Its page in the Azure CLI reference

Opens CmdID with your command. It is read in your browser and sent nowhere.

Examples

from the Azure CLI, each command read by CmdID

Run the built-in configuration checks and show a recent runtime error, if any (JSON by default)

az webapp troubleshoot config --name MyWebApp --resource-group MyResourceGroupIdentify
--namename of the web app.
--resource-groupName of resource group.

Print the human-readable report

az webapp troubleshoot config --name MyWebApp --resource-group MyResourceGroup --reportIdentify
--namename of the web app.
--resource-groupName of resource group.
--reportPrint a human-readable report instead of the structured payload.

Target a deployment slot

az webapp troubleshoot config --name MyWebApp --resource-group MyResourceGroup --slot stagingIdentify
--namename of the web app.
--resource-groupName of resource group.
--slotthe name of the slot.

Run checks and show a recent runtime error for a specific worker instance

az webapp troubleshoot config --name MyWebApp --resource-group MyResourceGroup --instance lw0sdlwk000002Identify
--namename of the web app.
--resource-groupName of resource group.
--instanceFilter configuration checks by worker machine name.

Options

5 in the Azure CLI reference
--instanceFilter configuration checks by worker machine name.
--name, -nname of the web app.
--reportPrint a human-readable report instead of the structured payload.
--resource-group, -gName of resource group.
--slot, -sthe name of the slot.