Encontrar e analisar rastros

Para encontrar e analisar detalhes de traces individuais, use a página Explorador de traces. Esta página mostra os rastros para os 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 logs, 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 Controlar o acesso com o Identity and Access Management.

Mostrar rastros 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 traces 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 na cor de um ponto. Azul indica sucesso e vermelho indica falha. Na captura de tela anterior, a maioria dos comandos foi concluída.

   • 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 rastros e intervalos mostrados, faça um destes procedimentos:

   • Filtrar por tempo. 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 rastros no intervalo de tempo selecionado são mostrados. 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 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 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.
     • MinLatency: 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 rastros em que o rótulo especificado pelo valor do 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 o serviço estiver em execução no App Engine, o nome do serviço no App Engine vai aparecer. Caso contrário, o serviço não será especificado.

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

     Talvez você encontre outras opções de filtro, como URL ou rótulos HTTP. Se você tiver um rótulo definido pelo usuário que corresponda a um filtro predefinido, o rótulo definido pelo usuário será prefixado com LABEL para que você possa distinguir entre os dois. Por exemplo, se você criar um rótulo Service, os itens Service e LABEL:Service vão aparecer no menu de filtro.

     Observação: para fazer uma correspondência exata, adicione um sinal de mais ("+") como prefixo do 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 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 ver 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. 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 na página Trace Explorer:

• O gráfico de dispersão é atualizado, e o ponto selecionado é destacado com um círculo ao redor dele. Os pontos que representam todos os outros traces são esmaecidos.

• O painel Detalhes do trace mostra o seguinte:

  • O identificador do trace. 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 mostrar cada registro ou evento como uma linha na tabela, abra 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 períodos, a tabela lista o nome do período e o serviço associado a ele. O nome do serviço é extraído do atributo service.name do OpenTelemetry, 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 no App Engine vai aparecer. Caso contrário, o serviço não será especificado.

    A coluna Latência fornece uma representação visual da latência, do status e, quando presentes, das anotações de evento. 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 na barra de latência.

O exemplo a seguir ilustra o 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 estão destacados porque correspondem ao termo de pesquisa, que era 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.

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. A guia 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: Atributos, Registros e eventos, Stacktraces e 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 conferir informações sobre entradas de registro e eventos relacionados, quando houver, consulte a guia Registros e eventos. Para informações sobre anotações de eventos, consulte Como anotar períodos de rastreamento. A captura de tela a seguir 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 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 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 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 rastreamento. Para saber mais sobre links, consulte a página de referência da API Links.

  A captura de tela a seguir ilustra essa guia:

  

A seguir

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