Skip to content

WebhookHealth (Enum)

WebhookHealth represents the computed health status of a webhook endpoint. Health is derived from recent delivery outcomes using two signals: - Success rate: successful deliveries / total deliveries - Consecutive failures: unbroken streak of failed deliveries Thresholds: HEALTHY: success_rate > 90% AND consecutive_failures < 3 DEGRADED: success_rate 50-90% OR consecutive_failures 3-9 UNHEALTHY: success_rate < 50% OR consecutive_failures >= 10

Values

Name Number Description
HEALTH_UNSPECIFIED 0 No delivery data available. The webhook has never received a delivery, or health has not been computed yet.
HEALTH_HEALTHY 1 Webhook is healthy: >90% success rate and fewer than 3 consecutive failures.
HEALTH_DEGRADED 2 Webhook is degraded: 50-90% success rate or 3-9 consecutive failures. May indicate intermittent issues at the target endpoint.
HEALTH_UNHEALTHY 3 Webhook is unhealthy: <50% success rate or 10+ consecutive failures. Investigate the target endpoint -- deliveries are still attempted but mostly failing.

Used by

  • HealthService
  • WebhookService