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