63. pepsi-status

Fasst die Gesundheit der Mail-Pipeline zusammen.

63.1. Rolle

pepsi-status ist die nur lesende Gesundheitsübersicht des Operators über die Pipeline. Es verbindet sich über den gemeinsamen [pepsi-postgres]-Abschnitt, hat keinen eigenen Abschnitt (die einzige weitere Option, die es liest, ist [pepsi] MAILBOX_QUOTA, der Standardwert der Installation, den ein Konto ohne eigenen Datensatz erbt) und verändert nie einen Datensatz oder gibt eine Benachrichtigung aus, sodass es gefahrlos über SSH gegen eine Live-Installation ausgeführt werden kann. Als root gestartet, läuft es vor dem Verbinden als Dienstkonto pepsi weiter, sodass kein sudo -u pepsi nötig ist. Referenz: pepsi-status(1).

63.2. Funktionen

  • Warteschlange — der pepsi.workqueue-Rückstau, aufgeschlüsselt nach stage und status, mit dem Alter der ältesten Nachricht in jedem Bucket.

  • Festhängende Nachrichten — die einzelnen failed/timeout-Nachrichten, älteste zuerst, mit jedem für sie festgehaltenen Grund: dem strukturierten Fehler des nächsten Hops aus state.bounce (entfernter MTA, SMTP-Code, erweiterter Status, Antworttext), dem eigenen state.last_error der Stage und dem state.dispatch_error des Dispatchers (ein abgestürzter oder hängender Worker, eine nicht konfigurierte Stage); durch --limit gedeckelt.

  • Zustellung & Fehler — kumulative dispatch_stats/stage_stats-Zähler: insgesamt verarbeitete Nachrichten, Nachrichtenzahlen pro Stage, durchschnittliche Verarbeitungszeit, Worker-Timeouts und -Abstürze.

  • Ausgehendes TLS — tls_session-Ergebnisse der letzten sieben UTC-Berichtstage (einschließlich des heutigen), gruppiert nach Richtliniendomain und Ergebnistyp (nicht-erfolgreiche Ergebnisse markiert), plus MX-Adressen, die der Resolver-Cache als beim Verbinden fehlschlagend markiert hat.

  • Postfachquoten — jedes Konto mit Quotenbuchführung, älteste Messung zuerst (die Reihenfolge, in der der reconcile-Durchlauf von pepsi-quota arbeitet), mit seiner wirksamen Grenze, der gemessenen Nutzung, der ungemessenen Zustellungsschätzung obendrauf und dem Alter der Messung. Ein Konto erscheint hier, sobald ihm etwas zugestellt wurde, mit oder ohne Quote.

--json gibt den gesamten Bericht als ein JSON-Objekt für Überwachungssysteme aus, und --limit begrenzt sowohl die Liste der steckengebliebenen Nachrichten als auch die Postfachquotenliste.

63.3. Eine Anmerkung zu „jüngsten Erfolgen“

Eine erfolgreich zugestellte Nachricht wird aus der Warteschlange gelöscht, sodass es kein Zustell-Journal pro Nachricht gibt. Die Zustellzahlen sind daher die seit der Erstellung des Schemas angesammelten kumulativen Zähler — Lebenszeit-Gesamtwerte, kein gleitendes Zeitfenster. Nur der Warteschlangen-Schnappschuss und der TLS-Abschnitt (der nach Berichtstag geschlüsselt ist) spiegeln wirklich jüngste Aktivität wider.

63.4. Siehe auch

pepsi-queue, pepsi-quota, pepsi-tlsrpt, pepsi-dispatch, Architektur, pepsi-status(1), pepsi.conf(5).