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, além de informações detalhadas. As informações detalhadas incluem registros, eventos e outras informações.

A página Explorador de traces exibe no máximo 1.000 vestígios.

Antes de começar

Para receber as permissões necessárias para visualizar dados de trace usando o console do Google Cloud, faça o seguinte: peça ao administrador para conceder a você Papel do IAM de usuário do Cloud Trace (roles/cloudtrace.user) no 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 Controlar o acesso com o Identity and Access Management.

Exibir traces recentes

Para mostrar os rastros 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 diagrama de dispersão mostra um ponto para cada solicitação no intervalo de tempo selecionado:

   • 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 com a cor de um ponto. Azul indica sucesso e vermelho indica falha. Na última Captura de tela, a maioria dos comandos foi concluída com sucesso.

   • A dica que é ativada quando você segura o ponteiro sobre um ponto mostra 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 horário. Por padrão, a hora mais recente dos dados é exibida. Para visualizar um intervalo de tempo personalizado, faça o seguinte:

     1. Selecione uma opção predefinida maior que o intervalo de tempo personalizado.
     2. Coloque o ponteiro no gráfico Selecionar um trace em um final do intervalo de 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 traces no intervalo de tempo selecionado são exibidos. Para limitar a exibição aos traces 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 Adicionar filtro de trace, selecione uma opção de filtro e e selecione ou digite um valor de filtro. Se você adicionar vários filtros, somente os rastros que atenderem a todos os filtros serão mostrados. Por exemplo, para mostrar todos os rastros que contêm um comando HTTP GET e cuja latência é de pelo menos dois 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 rastros cujos períodos raiz são anotados com o rótulo /http/method, em que o valor do rótulo corresponde ao valor do filtro.
     • Status: exibe rastros cujos períodos raiz são anotados com o rótulo /http/status_code, em que o rótulo de valor corresponde ao 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.
     • TemRótulo: exibe rastros em que o rótulo especificado pelo valor do filtro aparece em pelo menos um período.

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

       O nome do serviço de um período é extraído do OpenTelemetry service.name, quando esse atributo é definido. Se esse atributo não estiver definido e o serviço estiver em execução no App Engine, o nome do serviço do App Engine será exibido. 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 Service e LABEL:Service no menu do filtro.

     Observação: para fazer uma correspondência exata, adicione um sinal de mais (+) como prefixo ao valor do filtro. Se você omitir o sinal de mais, uma correspondência será determinada por meio de um teste de prefixo com o valor do filtro. Para mais detalhes sobre as opções de filtragem, consulte Filtros de trace.

Encontrar um trace por ID

Ao resolver um incidente ou falha, você pode saber o ID do rastro. Para explorar 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 rastreamento, a menos que ele faça 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 Conferir rastros entre projetos.

3. Digite o ID no campo ID do trace.

   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 painel a ser analisado até 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 na página Trace Explorer:

• 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 todos os outros traces são 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 vãos.

  • A eventos. A seleção do 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 Registros e eventos e selecione Mostrar expandido.

  • Uma tabela. A primeira linha da tabela é para o trace. Uma linha foi 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 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, e uma barra de latência vermelha indica que ocorreu um erro. Cada anotação de evento no espaço é representada por um círculo no e a barra de latência.

O exemplo a seguir ilustra o painel Detalhes do trace:

Pesquisar intervalos 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 estão destacados porque correspondem ao termo de pesquisa, que era net.sock.peer.port.

Para pesquisar os períodos em um trace, na barra de ferramentas do painel Detalhes do trace, Digite o termo de pesquisa no campo Localizar no Trace e pressione Enter.

O Trace então pesquisa campos selecionados de cada período na trace exibido. Uma correspondência ocorre quando um campo pesquisado contém o termo de pesquisa, ignorando a distinção entre 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.

Após a conclusão da pesquisa, o painel Detalhes do trace é atualizado e campos correspondentes sã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, períodos com nomes como CurrencyService/GetSupportedCurrencies estão destacados.

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

Conferir detalhes do período

Observação: para expandir o painel Detalhes do trace e preencher a página Explorador de traces, acesse a barra de ferramentas do painel Detalhes do trace e clique em Expandir detalhes do trace.

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. O Resumo lista informações gerais sobre o trace. Por exemplo, para comandos HTTP, essa guia mostra o tipo de comando HTTP, o serviço e as informações de latência de cada período no rastro.

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 marcador específico ou um grupo de marcadores, 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 conferir informações sobre entradas de registro e eventos relacionados, quando houver, acesse a guia Registros e eventos. Para informações sobre anotações de eventos, consulte Como anotar períodos de trace. 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 Mostrar mais:

  

• Para encontrar informações sobre o número de stacktraces disponíveis e informações detalhadas sobre um stacktrace capturado, use a guia Stacktraces.

• Para encontrar informações gerais sobre o período e uma tabela de links para outros consulte a página Metadados e Links. Essas informações incluem os seguintes:

  • ID do período

    O ID do período é um número inteiro de 64 bits diferente de 0. Para mais detalhes, consulte TraceSpan.

  • ID do período pai

  • ID do projeto

  • Horário de início e 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 Attributes lista os pares de chave-valor para o período vinculado. O campo Trace é vinculado ao trace do período vinculado. 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 saber mais sobre links, consulte a página de referência da API Links.

  A captura de tela abaixo ilustra essa guia:

  

A seguir

• Adicionar anotações de eventos para rastrear períodos
• Visualizar traces nos projetos
• Criar e visualizar relatórios