ConverterHQDevelopers
API v1

Observabilité

Relier requêtes, Jobs, Tasks, usage et webhooks en production.

L’observabilité commence par des identifiants corrélables et des états durables. Conservez X-Request-ID ainsi que vos client_reference_id afin de remonter d’un incident utilisateur à l’exécution exacte.

Corrélation des requêtes

Journalisez X-Request-ID, status HTTP, endpoint, durée et project_id sans enregistrer le secret API ni le contenu des fichiers.

État des Jobs et Tasks

Surveillez latence en file, durée moteur, attempts, codes d’erreur et taux de succès par paire. Les retries doivent rester visibles au lieu d’écraser l’historique.

Livraison des événements

Mesurez erreurs de signature, taux 2xx, latence des handlers, backlog de retries et âge du dernier événement livré. Utilisez replay pour corriger un incident après déploiement.

Usage et coût

Suivez appels, crédits, octets et concurrence par projet. Une alerte de coût doit s’appuyer sur les compteurs commerciaux autoritatifs plutôt que sur une estimation locale.