Esta página foi traduzida pela API Cloud Translation.

Encontrar e explorar traces

Para encontrar e explorar traces individuais em detalhes, use o Explorador de traces página. 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 os 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 como conceder papéis, consulte Gerenciar acesso.

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

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

Exibir traces recentes

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

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 abaixo mostra um exemplo do Explorador de traces página:

O gráfico de dispersão exibe um ponto para cada solicitação na intervalo de tempo:
- As coordenadas (x,y) para uma solicitação correspondem à tempo e latência da solicitação.
- As informações de erro são codificadas com a cor de um ponto. A cor azul indica sucesso e a cor vermelha indica falha. Na última captura de tela, a maioria dos comandos foi concluída com sucesso.
- A dica que é ativada quando você mantém o ponteiro sobre um ponto, exibe a data, a hora, o URI e a latência:
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 é 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 traces no intervalo de tempo selecionado são exibidos. Para limitar a exibição aos traces com latência de 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 traces que atendem a todos os filtros são exibidos. Por exemplo, para mostrar todos os traces que contêm um comando HTTP GET e cuja latência seja 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 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 com períodos raiz 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.
  - MinLatency: exibe traces com uma latência no mínimo tão grande quanto como 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: exibir 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 for 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 marcadores 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 realizar uma correspondência exata, adicione um sinal de adição antes do valor do filtro (+). Se você omitir o sinal de adição, a correspondência será determinada pelo realizando um teste de prefixo com o valor do filtro. Para mais detalhes sobre as opções de filtragem, consulte Filtros de traces.

Encontrar um trace por ID

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

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.
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 em que é possível configurar o rastreamento entre projetos e que permite que você visualize dados de trace de qualquer projeto na organização. Para mais informações, consulte Visualizar traces entre projetos.
Insira 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.

Explorar um trace

Para explorar um rastro, 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 é uma 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 existe um registro ou evento, um círculo é adicionado ao o período de trace. 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 for 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 no e a barra de latência.

Confira a seguir um exemplo do painel Detalhes do trace:

Exemplos do painel de detalhes do Cloud Trace.

Pesquisar períodos em um trace

É possível pesquisar os períodos e atributos em um trace por palavras-chave. Por exemplo: na captura de tela anterior, alguns períodos e uma chave de atributo estão destacados. Esses campos são destacados porque correspondem ao termo de pesquisa, que foi 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 maiúsculas e minúsculas. Os seguintes campos 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 cujo a chave é /http/method e o valor dela é GET está 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 em registros, eventos ou metadados.

Mais detalhes do período

Para visualizar informações detalhadas sobre o trace ou sobre um período específico, No painel Detalhes do trace, clique na barra de latência da entrada. Quando você Selecione a barra de latência, o painel Detalhes do trace será redesenhado e exibirá uma tabela com guias com mais informações sobre a entrada.

Se você selecionar a barra de latência da primeira linha da tabela, a linha com o nome Trace ID a tabela terá duas guias: Resumo e Registros. O 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, consulte a guia Atributos. Para informações sobre rótulos, consulte Rótulos de trace. A captura de tela abaixo 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 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 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 stack traces disponíveis, informações detalhadas sobre um stack trace capturado, use a API 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 de término
- Tabela com links para outros períodos
  
  Cada linha na tabela chamada Links lista um link entre o período atual. e outro período. O campo Attributes lista os pares de chave-valor para o período vinculado. O campo Trace é vinculado ao trace para vinculado ao período. Quando esse campo contém Current trace, a vinculado ao período está no mesmo trace que o período 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: