> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vincular traces com logs

Vincular traces com [logs](/logging) 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](/logging/integrations) 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](/logging/integrations) 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

* Configure o [relato de logs](/logging) para enviar os logs do seu aplicativo ao AppSignal.
* Saiba mais sobre [adicionar tags](/guides/tagging) aos seus traces.