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

Flag Short Type Default Description
--service -s string - Monitor specific service(s) only (comma-separated)
--stream - bool false Enable streaming mode for real-time updates
--interval -i duration 5s Interval between health checks in streaming mode
--output -o string text Output format: 'text', 'json', 'table'
--endpoint - string /health Default health endpoint path to check
--timeout - duration 5s Timeout for each health check
--all - bool false Show health for all projects on this machine
--verbose -v bool false Show detailed health check information
--profile - string - Health profile: development, production, ci, staging, or custom
--log-level - string info Log level: debug, info, warn, error
--log-format - string pretty Log format: json, pretty, text
--save-profiles - bool false Save sample health profiles to .azd/health-profiles.yaml
--metrics - bool false Enable Prometheus metrics exposition
--metrics-port - int 9090 Port for Prometheus metrics endpoint
--circuit-breaker - bool false Enable circuit breaker pattern
--circuit-break-count - int 5 Number of failures before opening circuit
--circuit-break-timeout - duration 60s Circuit breaker timeout duration
--rate-limit - int 0 Max health checks per second per service (0 = unlimited)
--cache-ttl - duration 0 Cache 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 →