63. pepsi-status

Résumer la santé du pipeline de messagerie.

63.1. Rôle

pepsi-status est l’aperçu de santé en lecture seule du pipeline destiné à l’opérateur. Il se connecte via la section partagée [pepsi-postgres], n’a pas de section propre (la seule autre option qu’il lit est [pepsi] MAILBOX_QUOTA, la valeur par défaut du site dont hérite un compte qui n’a pas de ligne à lui), et ne modifie jamais une ligne ni n’émet de notification : on peut donc l’exécuter sans risque par SSH sur un déploiement en service. Démarré en tant que root, il poursuit sous le compte de service pepsi avant de se connecter, de sorte qu’aucun sudo -u pepsi n’est nécessaire. Référence : pepsi-status(1).

63.2. Fonctionnalités

  • File d’attente — l’arriéré pepsi.workqueue ventilé par stage et status, avec l’âge du message le plus ancien dans chaque groupe.

  • Messages bloqués — les messages failed/timeout individuels, les plus anciens d’abord, avec chaque raison notée à leur sujet : l’échec structuré du saut suivant issu de state.bounce (MTA distant, code SMTP, statut étendu, texte de réponse), le state.last_error propre à l’étape et le state.dispatch_error du dispatcher (un worker planté ou bloqué, une étape non configurée) ; plafonné par --limit.

  • Remise et échecs — compteurs cumulatifs dispatch_stats/stage_stats : total de messages traités, nombres de messages par étape, temps de traitement moyen, timeouts et plantages de workers.

  • TLS sortant — issues tls_session des sept derniers jours de rapport UTC (aujourd’hui compris) groupées par domaine de politique et type de résultat (résultats non réussis marqués), plus les adresses MX que le cache du résolveur a signalées comme échouant à se connecter.

  • Quotas de boîtes aux lettres — chaque compte doté d’une comptabilité de quota, mesure la plus ancienne d’abord (l’ordre dans lequel travaille le balayage reconcile de pepsi-quota), avec sa limite effective, l’utilisation mesurée, l’estimation des remises non mesurées qui s’y ajoute et l’âge de la mesure. Un compte y figure dès que quelque chose lui a été remis, qu’il ait un quota ou non.

--json émet tout le rapport sous forme d’un objet JSON pour les systèmes de surveillance, et --limit plafonne à la fois la liste des messages bloqués et celle des quotas de boîtes aux lettres.

63.3. Une note sur les « succès récents »

Un message remis avec succès est supprimé de la file d’attente, de sorte qu’il n’y a pas de journal de remise par message. Les chiffres de remise sont donc les compteurs cumulatifs accumulés depuis la création du schéma — des totaux sur toute la durée de vie, pas une fenêtre temporelle glissante. Seuls l’instantané de la file d’attente et la section TLS (indexée par jour de rapport) reflètent une activité véritablement récente.

63.4. Voir aussi

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