Skip to content

observability: instant_email_failover_total alert + tile + catalog (#35)#54

Merged
mastermanas805 merged 1 commit into
masterfrom
feat/email-failover-observability
Jun 5, 2026
Merged

observability: instant_email_failover_total alert + tile + catalog (#35)#54
mastermanas805 merged 1 commit into
masterfrom
feat/email-failover-observability

Conversation

@mastermanas805
Copy link
Copy Markdown
Member

What

Rule-25 companion to worker PR InstaNode-dev/worker#93 (failover ESP provider). Every new metric ships its alert + dashboard tile + catalog row.

Metric: instant_email_failover_total{outcome} emitted by the worker FailoverProvider. Inert when EMAIL_PROVIDER_FALLBACK is unset (lazy CounterVec — never emits in single-provider mode).

Artifacts

  • prometheus-rules: new instant-worker-email-failover group —
    • EmailFailoverEngaged (P1: fallback_ok rate > 0 for 10m → primary ESP degraded, secondary carrying load)
    • EmailFailoverAllFailed (P0: all_failed rate > 0 for 5m → every ESP refused, email lost)
  • newrelic/alerts: email-failover-engaged.json (P1), email-failover-all-failed.json (P0) — mirror the Prom thresholds.
  • dashboard: "Email failover outcomes (1h)" line tile faceted by outcome.
  • METRICS-CATALOG: row for instant_email_failover_total.

All JSON + YAML validated.

🤖 Generated with Claude Code

Companion to worker #35 (failover ESP provider). Rule 25 — every new
metric ships its alert + dashboard tile + catalog row.

Metric: instant_email_failover_total{outcome} emitted by the worker
FailoverProvider (worker/internal/email/failover_provider.go). Inert
when EMAIL_PROVIDER_FALLBACK is unset (lazy CounterVec, never emits in
single-provider mode).

- prometheus-rules: new instant-worker-email-failover group —
  EmailFailoverEngaged (P1, fallback_ok rate > 0 for 10m = primary ESP
  degraded, secondary carrying load) and EmailFailoverAllFailed (P0,
  all_failed rate > 0 for 5m = every ESP refused, email being lost).
- newrelic/alerts: email-failover-engaged.json (P1),
  email-failover-all-failed.json (P0). Mirror the Prom thresholds.
- dashboard: "Email failover outcomes (1h)" line tile faceted by outcome.
- METRICS-CATALOG: row for instant_email_failover_total (lazy, owner
  worker, alerts + tile cross-referenced).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mastermanas805 mastermanas805 merged commit fc17385 into master Jun 5, 2026
3 checks passed
mastermanas805 added a commit that referenced this pull request Jun 5, 2026
…#54) (#55)

Rule 25 artifacts for instant_deploy_scaled_to_zero_total{outcome} +
instant_deploy_idle_apps (emitted by worker/internal/jobs/deploy_idle_scaler.go).

- Prom rules (instant-worker-deploy-scale-to-zero group):
  DeployScaleToZeroWakeFailed (wake_failed > 0 / 15m → P1: app stuck asleep),
  DeployScaleToZeroScaleDownFailures (scale_failed >= 5 / 30m → P2: savings not
  landing, no customer impact).
- NR alert: deploy-scale-to-zero-fail.json (wake_failed → CRITICAL).
- Dashboard: two tiles on instanode-reliability.json — asleep-apps billboard +
  scale-outcome stacked-bar.
- METRICS-CATALOG.md: rows for the counter (lazy, 4 outcomes primed) + the
  gauge (eager).

All INERT until an operator sets DEPLOY_SCALE_TO_ZERO_ENABLED — the series stay
0 and the alerts stay quiet until the feature is canaried on.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant