ConverterHQDevelopers
API v1

Osservabilità

Correla richieste, Jobs, Tasks, utilizzo e webhook in produzione.

L’osservabilità parte da ID correlabili e stato durevole. Conserva X-Request-ID e client_reference_id per risalire da un incidente all’esecuzione esatta.

Correlazione delle richieste

Registra X-Request-ID, status HTTP, endpoint, durata e project_id senza memorizzare segreti API o contenuto dei file.

Stato di Jobs e Tasks

Monitora latenza di coda, durata motore, attempts, codici di errore e successo per coppia. I retry devono restare visibili.

Consegna eventi

Misura errori di firma, tasso 2xx, latenza handler, backlog retry ed età dell’ultimo evento. Usa replay dopo aver corretto un incidente.

Utilizzo e costi

Segui chiamate, crediti, byte e concorrenza per progetto. Gli alert di costo devono usare contatori commerciali autorevoli, non stime locali.