From 42fab4476816b79c4eb1b19ac52486f00f34716b Mon Sep 17 00:00:00 2001
From: Peter Zsobrak <243386091+zsobpeter-code@users.noreply.github.com>
Date: Sat, 24 Oct 2026 19:25:35 +0200
Subject: [PATCH] monitoring: error-rate alert for the payments API

---
 monitoring/alerts.yml | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 monitoring/alerts.yml

diff --git a/monitoring/alerts.yml b/monitoring/alerts.yml
new file mode 100644
index 0000000..ebc46ae
--- /dev/null
+++ b/monitoring/alerts.yml
@@ -0,0 +1,18 @@
+# Error-rate alert for the payments API (Prometheus alerting rule, Alertmanager routes on `team`).
+groups:
+  - name: payments-api
+    rules:
+      - alert: PaymentsApiHighErrorRate
+        expr: |
+          sum(rate(http_requests_total{job="payments-api", code=~"5.."}[5m]))
+            /
+          sum(rate(http_requests_total{job="payments-api"}[5m]))
+            > 0.05
+        for: 10m
+        labels:
+          severity: page
+          team: payments
+        annotations:
+          summary: "Payments API 5xx error rate above 5% for 10 minutes"
+          description: "{{ $value | humanizePercentage }} of payments-api requests returned 5xx over the last 5 minutes."
+          runbook_url: "https://coderifts.com/docs/"