azd app health

Monitor the health status of running services with production-grade reliability and observability features.

Usage

Terminal window
azd app health [flags]

Flags

FlagShortTypeDefaultDescription
--service-sstring-Monitor specific service(s) only (comma-separated)
--stream-boolfalseEnable streaming mode for real-time updates
--interval-iduration5sInterval between health checks in streaming mode
--output-ostringtextOutput format: 'text', 'json', 'table'
--endpoint-string/healthDefault health endpoint path to check
--timeout-duration5sTimeout for each health check
--all-boolfalseShow health for all projects on this machine
--verbose-vboolfalseShow detailed health check information
--profile-string-Health profile: development, production, ci, staging, or custom
--log-level-stringinfoLog level: debug, info, warn, error
--log-format-stringprettyLog format: json, pretty, text
--save-profiles-boolfalseSave sample health profiles to .azd/health-profiles.yaml
--metrics-boolfalseEnable Prometheus metrics exposition
--metrics-port-int9090Port for Prometheus metrics endpoint
--circuit-breaker-boolfalseEnable circuit breaker pattern
--circuit-break-count-int5Number of failures before opening circuit
--circuit-break-timeout-duration60sCircuit breaker timeout duration
--rate-limit-int0Max health checks per second per service (0 = unlimited)
--cache-ttl-duration0Cache TTL for health results (0 = no caching)

Examples

Terminal window
azd app health [flags]
Terminal window
azd app health
Terminal window
azd app health --service web,api
Terminal window
azd app health --stream --interval 10s
Terminal window
azd app health --output json
Terminal window
azd app health --profile production --stream
Terminal window
azd app health --profile development --log-level debug
Terminal window
azd app health --circuit-breaker --rate-limit 10 --cache-ttl 5s --metrics --log-format json
Terminal window
azd app health --save-profiles

📚 Detailed Documentation

For complete documentation including flows, diagrams, and advanced usage, see the full command specification.

View full health specification →