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

Pour le cas fréquent où « l’observabilité », c’est surtout ne pas louper l’information dans le bon canal. Une adresse de webhook entrant à coller, et les seuils que vous choisissez partent dans ce canal.

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
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
Le mardi à 11 h, le quota journalier est atteint. Les messages suivants sont refusés.
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.
→
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 changez d’outil, la marche à suivre tient en une page et se tente sur un seul test.

Créer un compte gratuit Comment migrer