As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Rastreamentos
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
As visualizações de rastreamentos permitem que você acompanhe uma solicitação à medida que ela percorre os serviços em sua infraestrutura. A visualização de rastreamentos exibe os dados de rastreamentos em um diagrama que permite que você os interprete facilmente.
Para obter mais informações sobre rastreamentos e como usá-los, consulte a seguinte documentação:
+ [Rastreamento no Explore](v10-explore-tracing.md)
+ [Fonte de dados Tempo](tempo-data-source.md)
+ [Conceitos básicos do Tempo](https://grafana.com/docs/tempo/latest/getting-started/) na *documentação do Tempo da Grafana Labs*.
## Adicionar um painel com visualizações de rastreamentos
Depois de ter os dados de rastreamento disponíveis na pilha do Grafana, você pode adicionar painéis de rastreamento aos dashboards do Grafana.
Usar uma variável de dashboard, `traceID`, permite que você crie uma consulta para mostrar rastreamentos específicos para um determinado ID de rastreamento. Para obter mais informações sobre variáveis de dashboard, consulte a [documentação de variáveis](v10-dash-variables.md).
**Pré-requisitos**
Antes de começar, você precisa de:
+ Um espaço de trabalho do Amazon Managed Grafana.
+ Uma [fonte de dados Tempo](tempo-data-source.md) conectada ao espaço de trabalho.
Para visualizar e analisar dados de rastreamento em um dashboard, você precisa adicionar a visualização de rastreamentos ao seu dashboard e definir uma consulta usando o editor de painéis. A consulta determina os dados que serão exibidos na visualização. Para obter mais informações sobre o editor de painéis, consulte a [documentação do editor de painéis](v10-panels-editor-overview.md).
Esse procedimento usa variáveis e modelos do painel para permitir que você insira um rastreamento IDs que pode ser visualizado. Você usará uma variável chamada `traceId` e a adicionará como uma consulta de modelo.
**Para adicionar uma consulta de visualização de rastreamentos**
1. No espaço de trabalho, crie um dashboard ou acesse um dashboard existente no qual você gostaria de adicionar visualizações de rastreamentos.
1. Escolha **Adicionar visualização** de um novo dashboard, ou escolha **Adicionar painel** em um dashboard existente.
1. Selecione a fonte de dados de rastreamento apropriada.
1. No canto superior direito do editor de painéis, escolha a guia **Visualizações** e selecione **Rastreamentos**.
1. Nas **opções do painel**, insira um **título** para o painel de rastreamento. Para obter mais informações no editor de painéis, consulte [Configurar as opções do painel](v10-panels-configure-panel-options.md).
1. No editor de consultas, selecione a guia do tipo de consulta **TraceQL**.
1. Insira `${traceId}` no campo de consulta TraceQL para criar uma variável de dashboard. Essa variável é usada como consulta de modelo.
1. Escolha **Aplicar** no editor de painéis para adicionar o painel ao dashboard.
1. Acesse as **Configurações** do dashboard e adicione uma nova variável denominada `traceId`, do tipo de variável **Personalizada**, atribuindo-lhe um rótulo, se necessário. Escolha **Aplicar** para adicionar a variável ao dashboard.
1. Verifique se o painel funciona usando um ID de rastreamento válido para a fonte de dados usada para o painel de rastreamento e editando o ID na variável do dashboard.
## Adicionar o TraceQL com visualizações de tabela
Embora você possa adicionar uma visualização de rastreamento a um painel, ter que adicionar manualmente o rastreamento IDs como uma variável do painel é complicado. Em vez disso, é mais útil poder usar as consultas TraceQL para pesquisar tipos específicos de rastreamentos e, em seguida, selecionar os rastreamentos apropriados nos resultados correspondentes.
**Pré-requisitos**
Esse procedimento pressupõe que você já concluiu o procedimento anterior.
**Para adicionar o TraceQL com visualizações de tabela**
1. No mesmo dashboard em que você adicionou a visualização de rastreamento, escolha **Adicionar painel** para adicionar um novo painel de visualização.
1. Selecione a mesma fonte de dados de rastreamento usada na seção anterior.
1. No canto superior direito do editor de painéis, selecione a guia **Visualizações** e escolha **Tabela**.
1. No editor de consultas, escolha a guia **TraceQL**.
1. Nas **opções do painel**, insira um **título** para o painel de rastreamento.
1. Adicione uma consulta TraceQL apropriada para pesquisar os rastreamentos que você gostaria de visualizar no dashboard. Por exemplo, aqui está uma consulta simples e estática de um servidor chamado*my-server*.
```
{ .service.name = "my-server" && .http.status_code=500 }
```
Você pode escrever a consulta TraceQL como uma consulta de modelo para aproveitar outras variáveis do dashboard, se elas existirem. Isso permite criar consultas dinâmicas com base nessas variáveis.
Quando os resultados são retornados de uma consulta, eles são renderizados na tabela do painel.
Os resultados na visualização de rastreamentos incluem links para a página do **Explore** que renderiza o rastreamento. Você pode adicionar outros links aos rastreamentos na tabela que preencham a variável `traceId` do dashboard quando selecionada, para que o rastreamento seja visualizado no mesmo dashboard.
Use o procedimento a seguir para criar um conjunto de links de dados no painel.
**Para usar uma variável para adicionar outros links aos rastreamentos**
1. No menu do lado direito, em **Links de dados**, escolha **Adicionar link**.
1. Adicione um **título** para o link de dados.
1. Encontre o caminho para o dashboard examinando a barra de endereço do seu navegador quando o dashboard completo estiver sendo renderizado. Como este é um link para um dashboard na mesma pilha do Grafana, somente o caminho do dashboard é necessário.
Por exemplo, se seu caminho for:
```
https://g-example.grafana-workspace.us-east-1.amazonaws.com/d/1234abcd5/my-dashboard?orgId=1
```
Então, o caminho para o dashboard será:
```
/d/1234abcd5/my-dashboard?orgId=1
```
1. No campo **URL**, faça uma autorreferência ao dashboard que contenha os dois painéis. Essa autorreferência usa o valor do rastreamento selecionado na tabela para preencher a variável do dashboard. Use o caminho para o dashboard da etapa anterior e, em seguida, preencha o valor de `traceId` usando dos resultados selecionados da tabela de TraceQL. O ID de rastreamento é exposto usando o campo de dados `traceID` nos resultados retornados, portanto, use-o como o valor para a variável do dashboard. Por exemplo:
```
/d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
```
1. Escolha **Salvar** para salvar o link de dados.
1. Escolha **Aplicar** no editor do painel para aplicar o painel ao dashboard.
1. Salve o painel.
Agora você deve ver uma lista de rastreamentos correspondentes na visualização de tabela. Enquanto selecionar os campos **TraceID** ou **SpanID** lhe dará a opção de abrir a página do **Explore** para visualizar o rastreamento ou seguir o link de dados, selecionar qualquer outro campo (como `Start time`, `Name` ou `Duration`) seguirá automaticamente o link de dados, preenchendo a variável `traceId` do dashboard, e, então, mostrará o rastreamento relevante no painel de rastreamento.