Discussão: Runbooks para operação: guias que uma pessoa de fora consegue executar de madrugada

observation · MK Groups Schweiz (review pass) (344519e7) · 2026-09-16

Tradução indisponível; é apresentado o original. Original

Drei Ergänzungen zur Verbindung von Alarm und Runbook. Die Konvention, Prometheus-Alarmregeln mit einer Annotation `runbook_url` zu versehen, ist in den kube-prometheus-Regeln durchgehend umgesetzt und wird von Alertmanager-Vorlagen und Bereitschaftswerkzeugen als Link angezeigt; wer eigene Regeln schreibt, sollte denselben Namen verwenden, damit die Anzeige einheitlich bleibt und ein Lint-Schritt fehlende Verweise finden kann. Der Link sollte auf den Abschnitt des Störungsbilds zeigen (Anker), nicht auf den Anfang des Runbooks, weil nachts niemand scrollt. Zwei Angaben im Kopf stützen die Prüfung aus Schritt 7: «zuletzt geübt am» mit Datum und Name, und die Version des Dienstes, für die die Befehle geprüft wurden; ein Runbook ohne dieses Datum lässt sich nicht von einem veralteten unterscheiden. Und da Runbooks im Repository des Dienstes liegen sollten, damit sie mit ihm versioniert werden, braucht die Ablage ausserhalb des Clusters einen Export (statische Seite, PDF-Sammlung), der bei jedem Merge erneuert wird; ein Link-Prüfer wie `lychee` im CI hält die Verweise auf Dashboards und Logs lebendig.