Rastreamento no Explore - Amazon Managed Grafana

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á.

Rastreamento no Explore

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 10.x do Grafana.

Para espaços de trabalho do Grafana que suportam a versão 9.x do Grafana, consulte. Trabalhando na versão 9 do Grafana

Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana

Você pode usar o Explore para visualizar traços de fontes de dados de rastreamento.

Há suporte para as seguintes fontes de dados.

Para obter informações sobre como configurar consultas para as fontes de dados listadas acima, consulte a documentação da fonte de dados específica.

Editor de consultas

Você pode consultar e pesquisar dados de rastreamento usando o editor de consultas de uma fonte de dados.

Cada fonte de dados pode ter seu próprio editor de consultas. O editor de consultas da fonte de dados Tempo é um pouco diferente do editor de consultas da fonte de dados Jaeger.

Para obter informações sobre como consultar cada fonte de dados, consulte sua documentação.

Explicação do Trace View

Esta seção explica os elementos do painel do Trace View.

cabeçalho

O cabeçalho da visualização de rastreamento tem os seguintes elementos:

  • Título do cabeçalho — Mostra o nome da extensão raiz e do ID de rastreamento.

  • Pesquisar — Destaca os espaços contendo o texto pesquisado.

  • Metadados — Vários metadados sobre o rastreamento.

Minimapa

Mostra a visualização condensada da linha do tempo do traçado. Arraste o ponteiro sobre o minimapa para ampliar em um intervalo de tempo menor. O zoom também atualizará a linha do tempo principal, para que seja fácil ver períodos mais curtos. Passar o mouse sobre o minimapa, quando ampliado, mostrará o botão Redefinir seleção, que redefine o zoom.

Filtros Span

Usando filtros de extensão, você pode filtrar suas extensões no visualizador da linha do tempo de rastreamento. Quanto mais filtros você adicionar, mais específicos serão os intervalos filtrados.

Você pode adicionar um ou mais dos seguintes filtros:

  • Nome do serviço de recursos

  • Nome do Span

  • Duração

  • Tags (que incluem tags, tags de processo e campos de log)

Para mostrar somente os intervalos que você combinou, escolha o botão Mostrar somente correspondências.

Cronograma

Mostra a lista de extensões dentro do traçado. Cada linha de extensão consiste nos seguintes componentes:

  • Botão Expandir crianças — Expande ou contrai todas as extensões secundárias da extensão selecionada.

  • Nome do serviço — Nome do serviço que registrou a extensão.

  • Nome da operação — Nome da operação que esse intervalo representa.

  • Barra de duração do intervalo — Representação visual da duração da operação dentro do traçado.

Detalhes do Span

A escolha da linha de extensão mostra os detalhes da extensão, incluindo o seguinte.

  • Nome de operação

  • Metadados do Span

  • Tags — Qualquer tag associada a esse período.

  • Metadados do processo — Metadados sobre o processo que registrou esse período.

  • Registros — Lista de registros registrados por esse intervalo e valores de chave associados. No caso de registros do Zipkin, a seção mostra as anotações do Zipkin.

Rastrear até registros

Você pode navegar de uma extensão em uma visualização de rastreamento diretamente para registros relevantes para essa extensão. Isso está disponível para fontes de dados Tempo, Jaeger e Zipkin. Consulte a documentação relevante para obter instruções sobre como configurar cada fonte de dados.

Escolha o ícone do documento para abrir uma visualização dividida no Explore com a fonte de dados configurada e consulte os registros relevantes para o período.

Rastreie as métricas

nota

Este recurso está atualmente na versão beta

Você pode navegar de um intervalo em uma visualização de rastreamento diretamente até as métricas relevantes para esse período. Esse recurso está disponível para fontes de dados Tempo, Jaeger e Zipkin. Consulte a documentação relevante para obter detalhes sobre a configuração.

Rastrear até perfis

Usando o Trace to profiles, você pode usar a capacidade do Grafana de correlacionar diferentes sinais adicionando a funcionalidade de vincular traços e perfis.

Gráfico de nós

Opcionalmente, você pode expandir o gráfico do nó para o traçado exibido. Dependendo da fonte de dados, isso pode mostrar extensões do rastreamento como nós no gráfico ou adicionar algum contexto adicional, incluindo o gráfico do serviço com base no rastreamento atual.

Visualização do gráfico de serviços

A visualização do Gráfico de Serviços visualiza as métricas de amplitude (rastreia dados para taxas, taxas de erro e durações (RED)) e gráficos de serviços. Depois que os requisitos são configurados, essa visualização pré-configurada fica imediatamente disponível.

Para obter mais informações, consulte a página da fonte de dados Tempo. Você também pode ver a página de visualização do gráfico de serviços na documentação do Grafana Labs Tempo.

Data API (API de dados)

Essa visualização precisa de uma forma específica dos dados a serem retornados da fonte de dados para exibi-los corretamente.

A fonte de dados precisa retornar o quadro de dados e o conjuntoframe.meta.preferredVisualisationType = 'trace'.

Estrutura do quadro de dados

Campos obrigatórios;

Nome do campo Tipo Descrição
ID de rastreamento string Identificador para todo o rastreamento. Deve haver somente um traço no quadro de dados.
ID da Espanha string Identificador para o período atual. Os SPANIDs devem ser exclusivos por rastreamento.
Pais e pânico string spanID do intervalo pai para criar um relacionamento entre pais e filhos na visualização de rastreamento. Pode ser undefined para extensão raiz sem um pai.
serviceName string Nome do serviço do qual esse período faz parte.
Etiquetas de serviço TraceKeyValuePair[] Lista de tags relevantes para o serviço.
startTime número Hora de início do intervalo em milissegundos.
duration número Duração do intervalo em milissegundos.

Campos opcionais:

Nome do campo Tipo Descrição
logs TraceLog[] Lista de registros associados ao período atual.
tags TraceKeyValuePair[] Lista de tags associadas ao período atual.
avisos sequência de caracteres [] Lista de avisos associados ao período atual.
StackTraces sequência de caracteres [] Lista de rastreamentos de pilha associados ao intervalo atual.
errorIconColor string Cor do ícone de erro caso span esteja marcado comerror: true.

Para obter detalhes sobre os tipos TraceSpanRow, consulte TraceKeyValuePaire TraceLogcontinue GitHub.