azd app health
Monitor the health status of running services with production-grade reliability and observability features.
Usage
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
azd app health [flags]azd app healthazd app health --service web,apiazd app health --stream --interval 10sazd app health --output jsonazd app health --profile production --streamazd app health --profile development --log-level debugazd app health --circuit-breaker --rate-limit 10 --cache-ttl 5s --metrics --log-format jsonazd app health --save-profiles📚 Detailed Documentation
For complete documentation including flows, diagrams, and advanced usage, see the full command specification.
View full health specification →