ConverterHQDevelopers
API v1

Observabilidad

Correlaciona peticiones, Jobs, Tasks, uso y webhooks en producción.

La observabilidad empieza con IDs correlacionables y estado persistente. Guarda X-Request-ID y client_reference_id para llegar desde un incidente de usuario a la ejecución exacta.

Correlación de peticiones

Registra X-Request-ID, status HTTP, endpoint, duración y project_id sin guardar secretos API ni contenido de archivos.

Estado de Jobs y Tasks

Mide latencia en cola, duración del motor, attempts, códigos de error y éxito por par. Los retries deben quedar visibles, no borrar historial.

Entrega de eventos

Mide fallos de firma, tasa 2xx, latencia de handlers, backlog de retry y antigüedad del último evento. Usa replay tras corregir un incidente.

Uso y coste

Sigue llamadas, créditos, bytes y concurrencia por proyecto. Las alertas de coste deben usar contadores comerciales autoritativos, no estimaciones locales.