Obtén la salud de entrega de la suscripción
Devuelve un resumen consolidado y no secreto de la salud de entrega para una suscripción — la vista de «por qué este tenant dejó de recibir eventos». La compuerta de existencia se ejecuta primero, así que un id ausente, soft-deleted o de otro tenant devuelve un 404 not_found uniforme. Los conteos de resultados son una vista de ventana reciente, no un total histórico.
Autorizaciones
Un JWT bearer emitido por plugin-auth (lib-auth). La identidad del tenant se resuelve a partir de los claims validados del token; la superficie /v1 nunca lee un tenant del cuerpo, del path ni de la query. Los llamadores de máquina obtienen un token vía el flujo client-credentials de plugin-auth. La superficie /admin autoriza contra un scope de operador y no lleva contexto de tenant.
Parámetros de ruta
The unique identifier of the subscription (UUIDv7).
Respuesta
El resumen de salud de entrega.
The consolidated, non-secret delivery-health rollup for one subscription.
The subscription the rollup describes.
"0192f1a0-0000-7000-8000-00000000a001"
The operator on/off flag.
true
The subscription's position in the destination verification state machine. Only an active subscription is deliverable. A webhook sub is born active; a queue sub is born pending_verification and reaches active on a successful credential probe. degraded and disabled signal an impaired or auto-disabled destination that a successful verify returns to active.
pending_verification, active, degraded, disabled The rolled-up delivery-health verdict. Down means the subscription was auto-disabled by the system (the endpoint is judged broken); Degraded means a lesser impairment (a manual disable, dead-lettered attempts, or dropped tenant events); Healthy otherwise.
Healthy, Degraded, Down Delivery-attempt outcome counts over the configured recent window (keyed by outcome, e.g. delivered, failed, dead_lettered). Always an object, never null.
The same outcome histogram restricted to the last 24 hours (a subset of delivery_outcomes). Always an object; an outcome with no recent activity is simply a missing key.
The derived per-attempt delivery rate over the window (delivered / (delivered + failed + dead_lettered)), in [0.0, 1.0]. null when there are zero terminal attempts (distinct from a genuine 0.0). Per-attempt, not per-job, and informational only — it does not change status.
0.7
The count of dead-lettered attempts in the window.
1
A best-effort count of quarantined (poison) events keyed on the untrusted captured tenant id; drives dropped_tenant.
3
True when quarantined tenant events were observed.
true
Process consumer lag in milliseconds; 0 when no lag-as-time source is exposed.
12000
The auto-disable verdict: null when the subscription has no recorded attempts yet, false when a health row exists with no verdict, true when auto-disable has tripped (which drives status: "Down").
true
A fixed, secret-free auto-disable verdict token (e.g. consecutive_failures). Omitted when empty.
"consecutive_failures"
The last successful delivery timestamp (RFC 3339). Omitted when none.
"2026-06-01T12:00:00Z"
The last failed delivery timestamp (RFC 3339). Omitted when none.
"2026-06-05T09:30:00Z"

