Como visualizar detalhes do trace

O Stackdriver Trace mostra os detalhes de um trace na visualização de Detalhes do trace. 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.

Detalhes do trace

Para visualizar os detalhes de um trace:

  1. Vá para sua lista de traces em Stackdriver > Trace > Lista de traces no Console do Google Cloud Platform ou clique no seguinte botão:

    Acessar a página "Lista de traces"

    Para mais informações sobre como encontrar traces, consulte Como encontrar traces.

  2. Na lista de traces, clique em qualquer URI de solicitação. Os detalhes do trace aparecem abaixo:

    Detalhes do Stackdriver Trace

Resumo da solicitação

O painel à direita na visualização de detalhes do trace inclui um resumo e detalhes da solicitação. Os detalhes incluem as seguintes informações:

Propriedade Descrição
Carimbo de data/hora Hora em que o aplicativo recebeu a solicitação de entrada.
Tempo rastreado O tempo total que demorou para que todas as chamadas de RPC fossem concluídas.
Tempo não rastreado Tempo em que nenhuma chamada de RPC foi feita, ou seja, o tempo gasto localmente no aplicativo. O tempo não rastreado mais longo que o normal no início de uma solicitação, muitas vezes pode ser causado por uma nova instância criada para gerenciar a carga.
Registro Um link para as entradas de registro associadas.
Relatório Um link para os detalhes do relatório de análise associado.
Serviço O serviço do App Engine que gerenciou a solicitação. Consulte a documentação para Java, Python, Go e PHP.
Versão Versão do aplicativo do App Engine que processou a solicitação.
Método HTTP Método HTTP da solicitação.
Código de status Status do HTTP retornado pela solicitação.

Entradas de registro

O Stackdriver Trace associa os registros com traces usando anotações nas entradas de registros. O App Engine Standard associa automaticamente suas entradas de registro com traces, mas nem todos os serviços fazem isso.

Se você usar o SDK do Trace, terá a opção de anotar uma entrada de registro ao definir o campo trace do objeto LogEntry como um código de trace no seguinte formato:

projects/[PROJECT-ID]/traces/[TRACE-ID]

Você também pode associar uma entrada de registro a um período de trace específico. Para isso, defina o campo LogEntry span_id com a codificação hexadecimal de 16 caracteres do código do período. Por exemplo, um período com código "74" seria representado como "000000000000004a".

Na exibição de detalhes do trace do Console do GCP, existem várias maneiras de encontrar entradas de registro:

  • Clique no botão Mostrar registros no painel da linha do tempo para exibir entradas de registro ao lado do trace. Esse botão aparece quando há entradas de registro associadas ao trace.

  • Clique no link Registro: visualização no painel "Resumo" para abrir uma janela do Stackdriver Logging e ver as entradas de registro associadas ao seu trace. Se nenhuma entrada de registro estiver associada ao seu trace, a janela de geração de registro estará vazia.

  • Clique no link Registro da VM: visualização no painel "Resumo", que está presente para traces gerados pelo Cloud Load Balancer. O link abre uma janela do Stackdriver Logging e mostra os registros da instância de VM que veiculou a solicitação. A exibição da janela do Logging é restrita ao intervalo do carimbo de data/hora do trace.

Permissões exigidas

Para visualizar quaisquer entradas de registro, é preciso ter a permissão logging.logEntries.list no seu projeto. Essa permissão é fornecida pelos papéis do IAM do Visualizador de registros do Logging e do Visualizador do projeto.

Para visualizar os registros de instâncias de VM, você precisa ter a permissão compute.instances.get em seu projeto. Essa permissão é oferecida pelos papéis do IAM do Visualizador de rede do Compute Engine e do Visualizador do projeto.

Para mais informações sobre como visualizar entradas de registro no Stackdriver Logging, consulte o Visualizador de registros.

Anotações de período e eventos de mensagem (Beta)

As anotações de período e os eventos de mensagens podem ser gravados com a API Stackdriver Trace v2. Se houver, eles serão mostrados na linha de tempo do trace. Assim como acontece com os períodos e entradas de registro, você pode selecionar uma anotação ou um evento de mensagem para ver os detalhes completos no painel de detalhes à direita.

Para mais informações, consulte o objeto TimeEvents na API Stackdriver Trace v2.

Linha do tempo

A linha do tempo é uma representação gráfica dos dados de latência da solicitação. Ela mostra uma extensão da raiz que representa o tempo que levou para o aplicativo processar a solicitação de ponta a ponta, bem como subextensões que representam o tempo necessário para completar as chamadas de RPC realizadas ao gerenciar a solicitação.

Você pode clicar em qualquer extensão na linha do tempo para ver os detalhes dela. As relações pai-filho entre a extensão selecionada e as subextensões são mostradas na linha do tempo, e os dados adicionais relatados ao Stackdriver Trace durante o tempo de execução do aplicativo são exibidos no painel à direita.

Para a extensão da raiz, o Stackdriver Trace exibe as seguintes propriedades:

Propriedade Descrição
Nome URL relativo para a solicitação. Exibido no marcador da extensão.
Latência O tempo que levou o aplicativo para processar a solicitação de ponta a ponta. Exibido no marcador de extensão.
gae/request_log_id Código da solicitação do App Engine interno. Exibido no painel de detalhes abaixo da linha de tempo.
http/host Nome do host em que o aplicativo está sendo executado. Exibido no painel de detalhes abaixo da linha de tempo.
http/resposta/tamanho Número de bytes no corpo de resposta do HTTP. Exibido no painel de detalhes abaixo da linha de tempo.
http/url URL relativo para a solicitação. Exibido no painel de detalhes abaixo da linha de tempo.

A informação exibida para subextensões varia dependendo da chamada de RPC. No entanto, o Stackdriver Trace sempre exibe o seguinte:

Propriedade Descrição
Nome Nome da chamada de RPC no formato service_name.call_name. Por exemplo, datastore_v3.RunQuery). Exibido no marcador de extensão. Observação: o nome da chamada é um nome interno do App Engine e pode não ser exatamente o mesmo que o nome da chamada na API de serviço específico do idioma.
Latência O tempo necessário para completar a chamada de RPC de ida e volta. Exibida no marcador de extensão.

Insights

Se disponíveis, os insights sobre o desempenho da solicitação serão mostrados abaixo da linha do tempo.

Para mais informações, consulte Insights de desempenho.

Visualizar traces em projetos

Você pode configurar o Stackdriver Trace para mostrar períodos de trace de projetos que chamam seu projeto de destino, além de períodos de trace de outros projetos que atendem a solicitações do seu projeto de destino.

Consulte Como visualizar traces em projetos para saber mais.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Stackdriver Trace