Pular para o conteúdo principal
Vincular traces com logs permite correlacionar incidentes de erro e traces com mensagens de log, facilitando a depuração de problemas ao visualizar logs relevantes diretamente junto aos seus traces. Ao adicionar um identificador aos seus traces e logs, você pode navegar entre eles na interface do AppSignal.

​
Como funciona

Para vincular traces com logs, você precisa adicionar o mesmo identificador a ambos, como request_id ou trace_id. Isso será configurado automaticamente na maioria dos casos, mas quando não for, certifique-se de que os seguintes identificadores estejam definidos.
  1. Adicione um identificador de requisição ou trace ao seu trace como uma tag do AppSignal ou atributo do OpenTelemetry.
  2. Adicione o mesmo identificador aos seus logs como um atributo de log.
Quando o AppSignal recebe traces e logs com identificadores correspondentes, ele pode correlacioná-los, permitindo que você visualize logs relacionados ao inspecionar uma amostra de trace.

​
Escolhendo um identificador

Você pode usar qualquer um dos seguintes identificadores para vincular traces e logs:
  • request_id - um identificador exclusivo para cada requisição HTTP (comum em frameworks web).
  • trace_id - o ID de trace do AppSignal ou OpenTelemetry.
Muitos frameworks web geram automaticamente um request_id para cada requisição, tornando-o uma escolha conveniente. Para integrações baseadas em OpenTelemetry, você pode usar o trace ID diretamente.

​
Vinculando logs de aplicativo

Reporte logs do seu aplicativo configurando o logging usando os pacotes do AppSignal ou o SDK do OpenTelemetry. A maioria das configurações de frameworks já terá as tags request_id ou trace_id configuradas. Se nenhum log relevante for detectado, siga as instruções de configuração de logging para o framework que seu aplicativo usa ou reporte o identificador manualmente como uma tag de trace e atributo de log.

​
Visualizando logs vinculados

Depois de configurar seu aplicativo para vincular traces com logs, você pode visualizar logs relacionados diretamente na interface do AppSignal:
  1. Navegue até uma amostra de trace de desempenho ou incidente de erro.
  2. Procure o bloco de logs relacionados, que será vinculado às mensagens de log relevantes.
  3. Use os logs para obter contexto adicional sobre o que aconteceu durante a requisição.
Essa correlação torna a depuração mais rápida, pois você pode encontrar rapidamente o trace e os logs relevantes.

​
Próximos passos