Esta página foi traduzida pela API Cloud Translation.

Encontrar e explorar traces

Para encontrar e explorar traces individuais em detalhes, use a página Explorador de traces. Esta página exibe traces em que 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 traces.

Antes de começar

Para receber as permissões necessárias para visualizar dados de trace usando o console do Google Cloud, peça ao administrador para conceder a você o papel do IAM 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 receber as permissões necessárias com papéis personalizados ou 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 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, poderá levar alguns minutos para que eles apareçam. A captura de tela a seguir mostra um exemplo da página do Explorador de traces:

O gráfico de dispersão exibe 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. A cor azul indica sucesso e a cor vermelha indica falha. Na captura de tela anterior, a maioria dos comandos foi concluída com êxito.
- 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, siga um destes procedimentos:
- Filtrar por horário. Por padrão, é exibida a hora mais recente dos dados. 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. Posicione o ponteiro no gráfico Selecionar um trace em uma extremidade do intervalo e arraste-o horizontalmente até a outra extremidade.
  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 a esses 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 de filtro. Se você adicionar vários filtros, apenas os traces que atenderem a todos os filtros serão exibidos. Por exemplo, para mostrar todos os traces que contêm um comando HTTP GET e com 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 traces com períodos raiz anotados com o rótulo /http/method, em que o valor do rótulo corresponde ao 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 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 com uma 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 valor do filtro aparece em pelo menos um período.
  - Serviço: exibe traces que contêm pelo menos um período com um nome de serviço que corresponde ao valor do filtro.
    
    O nome do serviço para um período é extraído do atributo service.name do OpenTelemetry, quando esse atributo está 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 pelo menos um período com a versão do aplicativo correspondente 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, ele será prefixado com LABEL para que seja possível distinguir entre os dois. Por exemplo, se você criar um rótulo Service, verá Service e LABEL:Service no menu de filtro.
  
  Observação :para realizar uma correspondência exata, prefixe o valor do filtro com um sinal de mais (+). Se você omitir o sinal de adição, a correspondência será determinada com 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 solucionar um incidente ou uma falha, talvez você conheça 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 faça parte de uma organização. Quando um projeto faz parte de uma organização, é possível configurar o rastreamento entre projetos. Isso permite visualizar os dados de rastreamento 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 nesse painel para explorar 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 na página 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 todos os outros traces ficam esmaecidos.
O painel Detalhes do trace mostra o seguinte:
- É o identificador de rastreamento. Esse identificador globalmente exclusivo para o 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 períodos.
- Um menu Registros e 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 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 na tabela, expanda 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 e o serviço associado a ele. 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 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.
  
  A coluna Latência fornece uma representação visual da latência, do status e, quando presente, das anotações de evento. 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 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 é 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.

Em seguida, o Trace pesquisa os 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 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 os campos correspondentes são destacados.

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

Não é possível pesquisar usando uma expressão regular nem 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ê seleciona a barra de latência, o painel Detalhes do trace é redesenhado e exibe uma tabela com guias que fornece mais informações 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 Registros. 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, ela terá quatro guias: Atributos, Registros e eventos, Stacktraces, Metadados e links:

Para encontrar os rótulos anexados a um período, consulte a guia Atributos. Para saber mais sobre rótulos, consulte Rótulos de traces. 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 listará todos os rótulos em que a chave contém g.co.
Para informações sobre entradas de registro e eventos relacionados, quando existirem, consulte 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, clique em Mostrar mais para ver detalhes sobre uma entrada de registro:
Para encontrar informações sobre o número de stack traces disponíveis e informações detalhadas sobre um stack trace capturado, use a guia Stack traces.
Para encontrar informações gerais sobre o período e uma tabela de links para outros períodos, consulte a guia Metadados e links. Essas informações incluem:
- 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. O campo Attributes lista os pares de chave-valor do período vinculado. O campo Trace é vinculado ao trace do período vinculado. Quando esse campo contém Trace atual, o período vinculado está no mesmo trace que o período atual. Caso contrário, o campo conterá um ID de trace. Para informações sobre links, consulte a página de referência da API Links.
A captura de tela abaixo ilustra essa guia: