ConverterHQDevelopers
API v1

Observabilidade

Correlacione requisições, Jobs, Tasks, uso e webhooks em produção.

Observabilidade começa com IDs correlacionáveis e estado durável. Guarde X-Request-ID e client_reference_id para ir de um incidente do usuário à execução exata.

Correlação de requisições

Registre X-Request-ID, status HTTP, endpoint, duração e project_id sem gravar segredos da API nem conteúdo dos arquivos.

Estado de Jobs e Tasks

Monitore latência de fila, duração do engine, attempts, códigos de erro e sucesso por par. Retries precisam permanecer visíveis.

Entrega de eventos

Meça falhas de assinatura, taxa 2xx, latência dos handlers, backlog de retry e idade do último evento. Use replay após corrigir um incidente.

Uso e custo

Acompanhe chamadas, créditos, bytes e concorrência por projeto. Alertas de custo devem usar contadores comerciais autoritativos, não estimativas locais.