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.