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á.
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.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
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:
-
Conceitos básicos do Tempo
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.
Pré-requisitos
Antes de começar, você precisa de:
-
Um espaço de trabalho do Amazon Managed Grafana.
-
Uma fonte de dados Tempo 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.
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
-
No espaço de trabalho, crie um dashboard ou acesse um dashboard existente no qual você gostaria de adicionar visualizações de rastreamentos.
-
Escolha Adicionar visualização de um novo dashboard, ou escolha Adicionar painel em um dashboard existente.
-
Selecione a fonte de dados de rastreamento apropriada.
-
No canto superior direito do editor de painéis, escolha a guia Visualizações e selecione Rastreamentos.
-
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.
-
No editor de consultas, selecione a guia do tipo de consulta TraceQL.
-
Insira
${traceId}no campo de consulta TraceQL para criar uma variável de dashboard. Essa variável é usada como consulta de modelo. -
Escolha Aplicar no editor de painéis para adicionar o painel ao dashboard.
-
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. -
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
-
No mesmo dashboard em que você adicionou a visualização de rastreamento, escolha Adicionar painel para adicionar um novo painel de visualização.
-
Selecione a mesma fonte de dados de rastreamento usada na seção anterior.
-
No canto superior direito do editor de painéis, selecione a guia Visualizações e escolha Tabela.
-
No editor de consultas, escolha a guia TraceQL.
-
Nas opções do painel, insira um título para o painel de rastreamento.
-
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
-
No menu do lado direito, em Links de dados, escolha Adicionar link.
-
Adicione um título para o link de dados.
-
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=1Então, o caminho para o dashboard será:
/d/1234abcd5/my-dashboard?orgId=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
traceIdusando dos resultados selecionados da tabela de TraceQL. O ID de rastreamento é exposto usando o campo de dadostraceIDnos 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"]} -
Escolha Salvar para salvar o link de dados.
-
Escolha Aplicar no editor do painel para aplicar o painel ao dashboard.
-
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.
