Aller au contenu
Facteur
ENCommencer

Observabilité

Vos tests de messagerie sont un signal comme les autres

Un outil de test qui ne s’observe pas vous laisse découvrir ses limites en même temps que la panne. Nous exposons nos compteurs là où vous regardez déjà.

prometheus.ymlYAML
# Un endpoint scrapable par organisation.
- job_name: facteur
  scheme: https
  metrics_path: /v1/metrics
  static_configs:
    - targets: ['api.facteur.eu']
  authorization:
    credentials_file: /etc/prometheus/facteur.key

# Séries exposées
# facteur_messages_received_total{inbox,type}
# facteur_quota_used_ratio{inbox,window}
# facteur_message_delivery_seconds{inbox,quantile}
# facteur_credits_remaining
charge utile du webhookJSON
{
  "type": "quota.threshold_reached",
  "occurred_at": "2026-08-05T09:14:22Z",
  "organization": "org_4kd9",
  "inbox": { "id": "j3k9x2mq", "name": "e2e-signature" },
  "window": "daily",
  "threshold_pct": 90,
  "used": 7200,
  "limit": 8000,
  "credits_remaining": 41320
}

Intégrations

Où partent vos données d’usage

Endpoint Prometheus

GET /v1/metrics

Un endpoint au format OpenMetrics par organisation, protégé par une clé en lecture seule. Vos volumes, vos taux de remplissage de quota et vos latences de réception atterrissent dans le même Grafana que le reste.

Export OTLP

Métriques et traces poussées vers n’importe quel collecteur OpenTelemetry, donc vers à peu près n’importe quelle plateforme d’observabilité.

Intégration Datadog

Métriques et events envoyés directement dans votre organisation Datadog. Un dépassement de quota devient un event corrélable avec vos déploiements, pas un email perdu.

Webhooks signés

HMAC-SHA256

Chaque événement — message reçu, seuil franchi, crédit épuisé — peut appeler votre système. Signature HMAC, horodatage anti-rejeu, réessais exponentiels et journal des livraisons consultable.

Slack et Microsoft Teams

Pour le cas fréquent où « l’observabilité », c’est surtout ne pas louper l’information dans le bon canal.

OpsGenie et PagerDuty

Un quota épuisé la nuit avant une livraison n’est pas une notification, c’est une astreinte. Les événements critiques partent dans votre outil d’escalade, avec une clé d’intégration et un niveau de priorité que vous choisissez par règle.

Latence de réception mesurée

Le temps entre l’acceptation SMTP et la disponibilité par l’API, publié comme métrique. Si nous ralentissons, vous le voyez avant nous.

Pourquoi c’est là

Un quota qu’on ne voit pas venir est un incident

Le scénario que nous avons vécu, et qui a motivé cette page.

  1. 1

    Une suite de tests est modifiée un lundi. Elle envoie désormais trois fois plus d’emails qu’avant. Personne ne le remarque : c’est un détail d’implémentation.

  2. 2

    Le mardi à 11 h, le quota journalier est atteint. Les messages suivants sont refusés.

  3. 3

    La CI devient rouge sur des tests qui n’ont pas changé. L’équipe cherche la régression pendant deux heures avant de penser au quota.

  4. →

    Avec une alerte à 50 %, ce lundi-là un message tombe dans le canal de l’équipe. Le dépassement devient une décision — acheter un pack, revoir le test — au lieu d’une enquête.

Votre première inbox dans deux minutes

Le plan gratuit ne demande pas de carte bancaire. Si vous migrez depuis Mailosaur, la couche de compatibilité vous évite de réécrire vos tests.

Créer un compte gratuitGuide de migration