Appservice Diagnostics

1<#
2.SYNOPSIS
3    Collects diagnostic information for an Azure App Service web app in one pass.
4.DESCRIPTION
5    Prints clearly labeled sections for the given web app: app config, recent
6    deployments, app settings, and custom domains. The script only gathers and
7    labels output; it does not interpret the results.
8.PARAMETER Name
9    Name of the App Service web app.
10.PARAMETER ResourceGroup
11    Resource group that contains the web app.
12.PARAMETER Subscription
13    Azure subscription ID. Defaults to the current subscription.
14.EXAMPLE
15    .\appservice-diagnostics.ps1 -Name my-app -ResourceGroup my-rg
16    # Collects config, recent deployments, app settings, and custom domains for my-app
17#>
18param(
19    [string]$Name,
20    [string]$ResourceGroup,
21    [string]$Subscription
22)
23
24$ErrorActionPreference = "Continue"
25
26if (-not $Name -or -not $ResourceGroup) {
27    Write-Error "Usage: .\appservice-diagnostics.ps1 -Name <app> -ResourceGroup <rg> [-Subscription <id>]"
28    exit 1
29}
30
31$subArgs = @()
32if ($Subscription) { $subArgs = @("--subscription", $Subscription) }
33
34Write-Host "=== App Service Diagnostics: $Name (resource group: $ResourceGroup) ==="
35Write-Host "Collecting app config, recent deployments, app settings, and custom domains."
36Write-Host ""
37
38Write-Host "--- App Config ---"
39az webapp show -n $Name -g $ResourceGroup @subArgs --query "{state:state, runtime:siteConfig.linuxFxVersion, healthCheck:siteConfig.healthCheckPath, alwaysOn:siteConfig.alwaysOn}" -o table
40if ($LASTEXITCODE -ne 0) { Write-Host "(failed to read app config)" }
41Write-Host ""
42
43Write-Host "--- Recent Deployments (last 3) ---"
44az webapp deployment list -n $Name -g $ResourceGroup @subArgs --query "[:3].{id:id, status:status, time:end_time}" -o table
45if ($LASTEXITCODE -ne 0) { Write-Host "(failed to list deployments)" }
46Write-Host ""
47
48Write-Host "--- App Settings (names only) ---"
49az webapp config appsettings list -n $Name -g $ResourceGroup @subArgs --query "[].name" -o tsv
50if ($LASTEXITCODE -ne 0) { Write-Host "(failed to list app settings)" }
51Write-Host ""
52
53Write-Host "--- Custom Domains ---"
54az webapp config hostname list -g $ResourceGroup --webapp-name $Name @subArgs -o table
55if ($LASTEXITCODE -ne 0) { Write-Host "(failed to list custom domains)" }
56Write-Host ""
57
58Write-Host "=== Diagnostics collection complete for $Name ==="