Encontrar e explorar traces

Para encontrar e analisar detalhes de traces individuais, use a página Explorador de trace. Esta página exibe traces dos quais seu projeto do Google Cloud armazena pelo menos um período. Os dados mostrados para cada trace e período exibidos incluem informações resumidas, como a latência e o tipo de comando, e informações detalhadas. As informações detalhadas incluem registros, eventos e outras informações.

A página Trace Explorer exibe no máximo 1.000 traces.

Antes de começar

Para receber as permissões necessárias para visualizar dados de rastreamento usando o console do Google Cloud, peça ao administrador para conceder a você o papel de usuário do Cloud Trace (roles/cloudtrace.user) do IAM no seu projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Para mais informações sobre papéis, consulte Controle o acesso com o Identity and Access Management.

Mostrar rastros recentes

Para exibir os traces mais recentes, faça o seguinte:

1. No console do Google Cloud, acesse a página Explorador de traces:

   Acessar o Explorador de traces

   Também é possível encontrar essa página usando a barra de pesquisa.

   Se esta for a primeira vez que você usa o Trace, pode levar alguns minutos para que os rastros apareçam. A captura de tela a seguir mostra um exemplo da página Trace Explorer:

   

   O gráfico de dispersão exibe um ponto para cada solicitação na intervalo de tempo:

   • As coordenadas (x, y) de uma solicitação correspondem ao tempo e à latência da solicitação.

   • As informações de erro são codificadas na cor de um ponto. A cor azul indica sucesso e a cor vermelha indica falha. Na captura de tela anterior, a maioria dos comandos foi concluída.

   • A dica que é ativada quando você mantém o ponteiro sobre um ponto, exibe a data, a hora, o URI e a latência:

     

2. Opcional: para filtrar os traces e períodos mostrados, escolha uma destas opções:

   • Filtrar por tempo. Por padrão, a hora mais recente dos dados é exibido. Para visualizar um intervalo de tempo personalizado, faça o seguinte:

     1. Selecione uma opção predefinida mais longa do que a personalizada em um intervalo de tempo maior.
     2. Coloque o ponteiro no gráfico Selecionar um trace em uma extremidade do tempo e arraste o ponteiro horizontalmente para a outra extremidade do intervalo.

     Para restaurar o gráfico para o intervalo de tempo predefinido, clique em Redefinir.

   • Filtrar por latência. Por padrão, todos os rastros no intervalo de tempo selecionado são mostrados. Para limitar a exibição aos rastros com latência dentro de um intervalo, coloque o ponteiro em uma extremidade do valor de latência e arraste-o verticalmente para a outra extremidade.

     Para restaurar o gráfico para o intervalo de tempo predefinido, clique em Redefinir.

   • Clique em filter_list Adicionar filtro de trace, selecione uma opção de filtro e selecione ou insira um valor. Se você adicionar vários filtros, somente os rastros que atenderem a todos os filtros serão mostrados. Por exemplo, para mostrar todos os traces que contêm um comando HTTP GET e cuja latência seja de pelo menos 2 segundos, adicione os filtros Method: GET e MinLatency: 2000.

     As seguintes opções de filtro estão sempre disponíveis:

     • RootSpan: corresponde ao nome do período raiz.
     • SpanName: corresponde ao nome do período.
     • Método: exibe traces cujos períodos raiz são anotados com o Rótulo /http/method, em que o valor do rótulo corresponde o valor do filtro.
     • Status: exibe traces em que os períodos raiz são anotados com o Rótulo /http/status_code, em que o rótulo de valor corresponde o valor do filtro. O valor do filtro pode conter códigos de status específicos, como 301, ou intervalos de valores de status, como 3xx.
     • LatênciaMín: exibe traces cuja latência é pelo menos tão grande quanto o valor do filtro. O valor do filtro precisa estar em milissegundos.
     • HasLabel: exibe traces em que o rótulo especificado pelo filtro aparece em pelo menos um período.

     • Serviço: mostra rastros que contêm pelo menos um período cujo nome de serviço corresponde ao valor do filtro.

       O nome do serviço de uma extensão é extraído do atributo service.name do OpenTelemetry, quando esse atributo é definido. Se esse atributo não estiver definido e se o serviço estiver sendo executado App Engine, o nome de serviço do App Engine será exibidos. Caso contrário, o serviço não será especificado.

     • Versão: (somente App Engine) exibe traces que contêm no mínimo pelo menos um período cuja versão do aplicativo corresponda ao valor do filtro.

     Talvez você veja outras opções de filtro, como rótulos de URL ou HTTP. Se você tiver um rótulo definido pelo usuário que corresponda a um filtro predefinido, o o rótulo definido pelo usuário tem o prefixo LABEL para que você possa distinguir entre os dois. Por exemplo, se você criar um rótulo Service, consulte Serviço e LABEL:Service no menu do filtro.

Encontrar um trace por ID

Ao solucionar um incidente ou uma falha, você pode conhecer o ID do trace. Para analisar esse trace, faça o seguinte:

1. No console do Google Cloud, acesse a página Explorador de traces:

   Acessar o Explorador de traces

   Também é possível encontrar essa página usando a barra de pesquisa.

2. Selecione um projeto do Google Cloud para visualizar os dados de trace.

   Selecione o projeto do Google Cloud que armazena os dados de trace, a menos que seu projeto faz parte de uma organização. Quando um projeto faz parte de uma organização, é possível configurar o rastreamento entre projetos, o que permite visualizar dados de qualquer projeto na organização. Para mais informações, consulte Visualizar traces entre projetos.

3. Insira o ID no campo ID do rastreamento.

   Quando você insere um ID válido, o painel Detalhes do trace é preenchido com informações sobre o trace e os períodos dele. Você pode usar as opções nesse painel para acessar o trace.

Analisar um rastro

Para analisar um trace, clique em um ponto no gráfico de dispersão. Quando você clica em um ponto no gráfico de dispersão, as seguintes mudanças ocorrem no página do Explorador de traces:

• O gráfico de dispersão é atualizado e o ponto selecionado é destacado com um círculo desenhado ao redor do ponto. Os pontos que representam todas as outras os rastros ficam esmaecidos.

• O painel Detalhes do trace mostra o seguinte:

  • É o identificador de rastreamento. Esse identificador globalmente exclusivo do trace é um número inteiro de 128 bits representado como uma string hexadecimal de 32 bytes. Para mais detalhes, consulte Resource: Trace.

  • Uma linha de resumo que lista o horário de início, a duração e o número de intervalos.

  • Um menu Registros e eventos. A seleção de menu controla como os registros e eventos são mostrados. Por padrão, quando um registro ou evento existe, um círculo é adicionado à duração do rastreamento. Círculos sobrepostos indicam que o período tem vários registros ou eventos. Para exibir cada registro ou evento como uma linha no tabela, expanda arrow_drop_down Registros e eventos e selecione Mostrar expandido.

  • Uma tabela. A primeira linha da tabela é para o trace. Uma linha é adicionada para cada período no trace.

    Para os períodos, a tabela lista o nome do período e o serviço associado com o período. O nome do serviço é extraído do atributo service.name do OpenTelemetry, quando esse atributo está definido. Se esse atributo não estiver definido e se o serviço estiver sendo executado App Engine, o nome de serviço do App Engine será exibidos. Caso contrário, o serviço não será especificado.

    A coluna Latência fornece uma representação visual da latência, status e, quando presente, anotações de eventos. Uma barra de latência azul indica uma conclusão bem-sucedida, uma barra de latência vermelha indica que ocorreu um erro. Cada anotação de evento no espaço é representada por um círculo na barra de latência.

Confira abaixo um exemplo do painel Detalhes do trace:

Pesquisar períodos em um trace

É possível pesquisar palavras-chave nos spans e atributos de um rastro. Por exemplo, na captura de tela anterior, algumas extensões e uma chave de atributo estão destacadas. Esses campos são destacados porque correspondem ao termo de pesquisa, que foi net.sock.peer.port.

Para pesquisar os intervalos em um trace, na barra de ferramentas do painel Detalhes do trace, digite o termo de pesquisa no campo Encontrar no trace e pressione Enter.

O Trace pesquisa campos selecionados de cada período no trace exibido. Uma correspondência ocorre quando um campo pesquisado contém o termo de pesquisa, ignorando maiúsculas e minúsculas. Os campos a seguir são pesquisados:

• Nome do período.
• Nome do serviço.
• Chaves e valores de atributos.

Depois que a pesquisa for concluída, o painel Detalhes do trace será atualizado e os campos correspondentes serão destacados.

Por exemplo, se você inserir o termo get, um período com um atributo com chave /http/method e valor GET será destacado. Além disso, as extensões com nomes como CurrencyService/GetSupportedCurrencies são destacadas.

Não é possível pesquisar usando uma expressão regular nem pesquisar registros, eventos ou metadados.

Mais detalhes do período

Para conferir informações detalhadas sobre o trace ou um período específico, no painel Detalhes do trace, clique na barra de latência da entrada. Quando você seleciona a barra de latência, o painel Detalhes do trace é redesenhado e mostra uma tabela com guias que fornece informações adicionais sobre a entrada.

Se você selecionar a barra de latência da primeira linha da tabela, a linha com o nome ID do trace, a tabela terá duas guias: Resumo e Logs. A guia Resumo lista informações gerais sobre o trace. Por exemplo, para comandos HTTP, essa guia exibe o tipo de comando HTTP, o serviço e as informações de latência para cada período no trace.

Se você selecionar a barra de latência para outras linhas na tabela, ou seja, uma linha para um período, a tabela terá quatro guias: Attributes, Logs e eventos, Stacktraces, Metadados e Links:

• Para encontrar os rótulos anexados a um período, acesse a guia Atributos. Para informações sobre rótulos, consulte Rótulos de trace. A captura de tela a seguir ilustra essa guia:

  

  Para localizar um rótulo específico ou um grupo de rótulos, adicione um filtro. Por exemplo, se você adicionar o filtro Chave: g.co, a tabela vai listar todos os rótulos em que a chave do rótulo contém g.co.

• Para exibir informações sobre entradas de registro e eventos relacionados, quando existirem, consulte a página Registros e guia "Eventos". Para informações sobre anotações de eventos, consulte Como anotar períodos de rastreamento. A captura de tela abaixo ilustra essa guia:

  

  Quando os dados de registro estiverem disponíveis, para conferir detalhes sobre uma entrada de registro, Clique em keyboard_arrow_down Mostrar mais:

  

• Para encontrar informações sobre o número de stack traces disponíveis, informações detalhadas sobre um stack trace capturado, use a API Stacktraces .

• Para encontrar informações gerais sobre o intervalo e uma tabela de links para outros intervalos, acesse a guia Metadados e links. Essas informações incluem o seguinte:

  • ID do período

    O ID da extensão é um número inteiro de 64 bits diferente de zero. Para mais detalhes, consulte TraceSpan

  • ID do período pai

  • ID do projeto

  • Horário de início e de término

  • Tabela que lista links para outras extensões

    Cada linha na tabela Links lista um link entre o período atual e outro. O campo Atributos lista os pares de chave-valor para a extensão vinculada. O campo Trace é vinculado ao trace para vinculado ao período. Quando esse campo contém Trace atual, o intervalo vinculado está no mesmo trace que o intervalo atual. Caso contrário, o campo contém um ID de trace. Para informações sobre links, consulte a Links página de referência da API.

  A captura de tela abaixo ilustra essa guia:

  

A seguir

• Adicionar anotações de eventos a intervalos de rastreamento
• Conferir traces em projetos
• Criar e visualizar relatórios