Como visualizar detalhes do trace

Se você selecionar um trace, o Cloud Trace mostrará os detalhes de um trace na página Lista de traces. Ela mostra um resumo de detalhes sobre a solicitação, uma linha de tempo gráfica que mostra a extensão da raiz para a solicitação e subextensões para qualquer chamada RPC e uma visão detalhada dos dados de latência coletados para as extensões.

Como visualizar detalhes do trace

  1. No Console do Google Cloud, acesse a página Lista de traces:

    Acessar a lista de traces

  2. Há várias maneiras de exibir informações detalhadas sobre um trace:

    • Clique no URI listado na tabela.
    • Clique no ponto no gráfico.
    • Na visualização Detalhes do trace selecionado, insira o ID do trace no formato hexadecimal. Se você inserir um ID do trace, poderá ver uma mensagem Selected trace may not match current filters ou Selected trace is outside the current time range. Essas mensagens informativas indicam que o trace exibido não corresponde aos seus filtros ou às configurações de intervalo de tempo.

Painel de detalhes do trace selecionado

Se você escolher um trace para analisar, os detalhes sobre o trace selecionado serão mostrados:

  • A caixa de texto Detalhes do trace selecionado exibe o identificador dele.

  • Um painel exibe uma representação gráfica dos dados de latência para a solicitação usando um gráfico de cascata. Por padrão, o período raiz do trace selecionado é destacado.

  • Um painel exibe em uma série de tabelas as informações detalhadas sobre o período destacado no gráfico de cascata.

Esses campos são atualizados com novos dados sempre que você seleciona um trace para examinar. A captura de tela a seguir ilustra esses painéis:

Painel de detalhes do Cloud Trace.

Gráfico de cascata

Cada linha no gráfico de cascata corresponde a um período no trace:

  • Se o símbolo for exibido, o Cloud Trace detectou um período cujo horário de início é anterior ao do pai do período. O Cloud Trace compensa automaticamente essa inconsistência ao exibir o período. No entanto, os dados do período não são modificados.

    A inconsistência de carimbo de data/hora pode ocorrer quando um serviço depende de várias fontes de relógio ou bibliotecas de linguagem diferentes.

  • Se o símbolo for exibido, isso indicará que o período contém um erro HTTP.

  • O nome da chamada RPC no formato service_name.call_name. Por exemplo, datastore_v3.RunQuery.

    Para o ambiente padrão do App Engine, o nome interno informado aqui pode não corresponder ao nome de uma API de serviço específica da linguagem.

  • O tempo necessário para completar a chamada de RPC de ida e volta.

Caixa de seleção Mostrar eventos

Se você marcar em Mostrar eventos, o gráfico de cascata será redesenhado e as anotações de eventos serão incluídas como linhas no gráfico. Para mais informações sobre anotações, consulte Como anotar períodos.

Clique para copiar

É possível copiar o URL da visualização detalhada para um trace específico na área de transferência clicando em Copiar .

Tabelas com detalhes do período

Essas tabelas contêm informações detalhadas sobre a linha destacada no gráfico de cascata. Cada linha no gráfico de cascata corresponde a um período de trace.

Se você destacar uma linha, os detalhes desse período incluirão o nome do URI, o horário de início relativo e o nome da chamada de RPC.

Os dados exibidos nas tabelas variam de acordo com o elemento destacado. No entanto, os dados listados na tabela a seguir sempre são exibidos:

Property Descrição
Horário de início relativo A primeira entrada é o horário de início relativo do período.

Para períodos raiz, esse valor é sempre @0 ms.

Para subperíodos, este é o momento em que o subperíodo foi iniciado em relação ao início da solicitação. Ou seja, esse valor exibe quanto tempo leva desde o início da solicitação geral para que essa chamada RPC seja iniciada.
Nome A próxima entrada é o nome da chamada RPC. Os nomes são formatados como service_name.call_name. Por exemplo, datastore_v3.RunQuery.

No ambiente padrão do App Engine, o nome interno informado aqui pode não corresponder ao nome de uma API de serviço específica da linguagem.

Se um período raiz for destacado e a solicitação for HTTP, uma tabela chamada Resumo será exibida. Há uma linha na tabela para o período raiz e uma linha para cada RPC:

Coluna da tabela
de resumo
Descrição
Nome Nome da chamada RPC no formato service_name.call_name. Exibido no marcador de extensão.
RPCs O número de vezes que o procedimento foi chamado.
Duração total O tempo total gasto realizando as RPCs.

Na tabela Detalhe listamos metadados sobre o período. As seguintes propriedades são sempre exibidas:

Propriedade da tabela
de detalhes
Descrição
Carimbo de data/hora Hora em que o aplicativo recebeu a solicitação de entrada.
Registro Um link para uma entrada de registro se os dados de registro estiverem disponíveis. Se os dados de registro não estiverem disponíveis, essa linha será omitida.
Relatório Um link para o relatório de análise mais recente que inclui esse trace. Se nenhum relatório incluir esse trace, essa linha será omitida.
ID do Trace Para visualizar esse campo, clique no menu Detalhes .

O identificador globalmente exclusivo do trace. Esse identificador é um formulário numérico de 128 bits representado como uma string hexadecimal de 32 bytes. Para detalhes, consulte: Resource: Trace.

ID do período Para visualizar esse campo, clique no menu Detalhes .

O identificador do período. Esse identificador é um número inteiro de 64 bits diferente de zero. Para detalhes, consulte: TraceSpan.

Contêiner do GKE

Quando essa tabela é exibida, o período contém rótulos canônicos para um contêiner do GKE. Cada linha na tabela é para um rótulo específico e o valor é um link que pode ser usado para exibir informações sobre o recurso mais detalhadamente. Para ver informações detalhadas sobre todos os rótulos, consulte Rótulos do trace.

Os rótulos e o significado deles estão listados na tabela a seguir:

Marcador Valor
Project ID O projeto do Google Cloud que hospeda o cluster do GKE. Clique no nome do projeto para acessar o painel do GKE no Console do Google Cloud.
Cluster Name Identifica o cluster do GKE. Para acessar a página de configuração Clusters, clique nesse valor.
Namespace Identifica o namespace. Para acessar a página Cargas de trabalho do GKE, clique nesse valor.
Pod Name Identifica o pod do GKE. Clique no valor para acessar o painel Detalhes do pod.
Container Name Identifica o contêiner do GKE. Para acessar a página de detalhes do contêiner, clique nesse valor.
Rótulos Uma tabela de rótulos e valores na solicitação. Os rótulos são específicos do aplicativo. Para ver informações detalhadas sobre todos os rótulos, consulte Rótulos do trace.

Alguns rótulos comuns e seus significados estão listados na tabela a seguir:

Marcador Valor
http/host Nome do host em que o aplicativo está sendo executado.
http/response/size Número de bytes no corpo de resposta do HTTP.
http/url URL relativo da solicitação.
gae/request_log_id ID da solicitação interna do App Engine.

Outras propriedades podem ser listadas quando o tipo de solicitação é HTTP ou quando o aplicativo está em execução no App Engine. A tabela a seguir exibe uma lista parcial de algumas propriedades comumente observadas:

Property Descrição
Tempo rastreado (Somente HTTP) O tempo agregado necessário para que todas as chamadas RPC sejam concluídas.
Tempo não rastreado (Somente HTTP) O tempo durante o qual nenhuma chamada RPC foi feita. Ou seja, isso mede o tempo gasto localmente no aplicativo. Observe que um tempo não rastreado maior que o comum no início de uma solicitação pode ser causado por uma nova instância criada para processar a carga.
Método HTTP (Somente HTTP) O método HTTP da solicitação.
Serviço (Somente App Engine) O serviço do App Engine que processou a solicitação. Para mais informações, acesse App Engine.
versão (Somente App Engine) A versão do aplicativo que processou a solicitação.

Se você destacar um evento, os detalhes dele serão exibidos no painel de detalhes. Por padrão, os eventos não são exibidos no gráfico de cascata. Para incluí-los no gráfico de cascata, clique em Mostrar eventos.

Insights

Os insights sobre o desempenho da solicitação são exibidos abaixo da linha do tempo, quando estiverem disponíveis.

Veja mais informações em Insights.

Como anotar períodos

É possível anotar um trace usando a API Cloud Trace v1 ou a API Cloud Trace v2. Esta seção descreve as diferentes opções disponíveis para você.

Para associar um trace a um objeto LogEntry do Cloud Logging, use anotações. Para mais informações sobre a integração entre o Cloud Trace e o Cloud Logging, consulte Como integrar ao Cloud Logging.

Como anotar com rótulos

É possível adicionar anotações a períodos criando um objeto labels e anexando-o ao objeto TraceSpan ao usar a API Cloud Trace v1 patchTraces.

Essas anotações são exibidas como rótulos quando você visualiza os detalhes de um trace. Para mais informações sobre os rótulos, consulte Rótulos de trace.

Como anotar com atributos

É possível anotar períodos criando um objeto attributes e anexando-o ao objeto Span ao usar a API Cloud Trace v2 batchWrite.

Essas anotações são exibidas como rótulos quando você visualiza os detalhes de um trace. Para mais detalhes, acesse Como visualizar detalhes do trace nesta página.

Como anotar com eventos de hora

É possível adicionar anotações e eventos de mensagens a períodos criando um objeto TimeEvents e anexando-o ao objeto Período ao usar a API Cloud Trace v2 batchWrite.

O objeto TimeEvents é uma matriz de objetos TimeEvent, cada um contém um evento de mensagem e uma anotação.

Para visualizar o TimeEvents de um trace, acesse o gráfico de cascata do trace e clique em Mostrar eventos. Se você selecionar um TimeEvent, os detalhes dele serão exibidos no painel de detalhes.

A seguir