Como encontrar e visualizar traces

A página Lista de traces permite encontrar e examinar traces individuais em detalhes. É possível visualizar e inspecionar todos os períodos em busca de um trace, visualizar informações resumidas de uma solicitação e visualizar informações detalhadas de cada período do trace nessa página. Para restringir os traces que estão sendo investigados, adicione filtros. Por exemplo, você pode adicionar um filtro para exibir apenas traces cuja latência exceda 1 segundo.

A página Lista de traces armazena e exibe no máximo 1.000 traces.

Como visualizar traces recentes

Para visualizar traces recentes, no Console do Google Cloud, selecione Trace e, em seguida, selecione Lista de trace ou use o seguinte botão:

Acessar a lista de traces

Se esta for a primeira vez que você usa o Trace, pode levar alguns minutos para que eles sejam exibidos. A captura de tela abaixo mostra um exemplo desta página:

Painel de rastreamento recente do Cloud Trace.

Intervalo de tempo

A página Lista de traces usa como padrão a exibição de dados da hora anterior. Altere esse intervalo para valores predefinidos usando os botões na parte superior da página. As opções predefinidas são:

  • 1 hora
  • 6 horas
  • 12 horas
  • 1 dia
  • 2 dias
  • 4 dias
  • 7 dias
  • 14 dias
  • 30 dias

Para visualizar um intervalo de tempo personalizado, faça o seguinte:

  1. Selecione uma opção predefinida maior que o intervalo de tempo personalizado desejado.
  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.
  3. (Opcional) Para visualizar um intervalo personalizado de valores de latência, coloque o ponteiro em uma extremidade do intervalo desejado e arraste-o verticalmente para a outra extremidade.

Você pode repetir essas ações até selecionar o intervalo de tempo e os intervalos de latência desejados/

Para restaurar o gráfico para o intervalo de tempo predefinido, clique em Redefinir.

Filtros

Você usa filtros para ocultar ou encontrar traces individuais. Cada filtro é especificado por um OPTION predefinido que é pareado com um VALUE. A sintaxe geral é esta:

[OPTION] : [VALUE]

Por exemplo, a captura de tela a seguir ilustra um único filtro. A opção de filtro é RootSpan e Recv. é o valor do filtro. Com esse filtro, somente os traces cujo período raiz é prefixado por Recv. são exibidos.

Exibir um filtro.

Para exibir traces que correspondam exatamente a Recv., use +Recv. como o valor do filtro. O uso do sinal de adição + indica que você quer uma correspondência exata. Para detalhes sobre a sintaxe de filtragem, consulte Filtros de trace.

Se você adicionar vários filtros, somente os traces que satisfazem todos os filtros serão exibidos.

Como adicionar um filtro

Para adicionar um filtro, faça o seguinte:

  1. Clique em Adicionar filtro de trace para exibir um menu de opções de filtro e selecione um OPTION. Você sempre tem as seguintes opções:

    • 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 a VALUE.
    • Status: exibe traces cujos períodos raiz são anotados com o rótulo /http/status_code, em que o rótulo de valor corresponde a VALUE. Nesse caso, VALUE pode conter códigos de status específicos, como 301, ou intervalos de valores de status, como 3xx.
    • LatênciaMín: exibe traces cuja latência é pelo menos tão grande quanto VALUE milissegundos.
    • TemRótulo: exibe traces em que o rótulo especificado por VALUE aparece em pelo menos um período.
    • Serviço: (somente App Engine) exibe traces que contêm pelo menos um período cujo nome de serviço corresponde a VALUE.
    • Versão: (somente App Engine) exibe traces que contêm pelo menos um período cuja versão do aplicativo corresponde a VALUE.

    Talvez você veja outras opções, como URL e RÓTULO: Cliente

  2. (Opcional) Se você quiser uma correspondência exata, insira um sinal de adição +. Por padrão, uma correspondência é determinada por meio de um teste de prefixo com VALUE. Para mais detalhes sobre as opções de filtragem, consulte Filtros de trace.

  3. Especifique o filtro VALUE seguindo um destes procedimentos:

    • Seleção no menu VALUE. Não há garantia de que as opções de menu de valor estejam completas.
    • Digite um valor manualmente e pressione return no teclado.

Por exemplo, para mostrar todos os traces que contêm um comando HTTP POST e cuja latência é de pelo menos dois segundos, adicione um filtro com a opção MinLatency cujo valor é 2000.

Como editar um filtro

Para editar um valor de filtro, clique duas vezes no ícone e posicione o ponteiro sobre o valor do filtro:

  • Você pode fazer uma seleção diferente no menu de valores de filtro.
  • É possível apagar o texto.
  • Você pode digitar o texto.

Depois que o valor de um filtro é alterado, o estilo do filtro muda rapidamente.

Gráfico de latência

O gráfico Selecionar um trace 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.

Quando você segura o ponteiro sobre um ponto, é exibida uma dica que inclui a data, a hora, o URI e a latência:

Como mostrar uma dica de trace que exibe informações de latência.

Quando você clica em um ponto, ocorrem as seguintes alterações:

  • O gráfico é atualizado, e o ponto selecionado é destacado com um círculo ao redor do ponto.
  • A tabela de solicitações destaca o URI selecionado.
  • Dois novos painéis podem ser abertos na página Lista de traces. O gráfico de cascata exibe cada período em um URI. O painel de detalhes exibe informações detalhadas sobre o URI e inclui links para registros e relatórios de análise quando estiverem disponíveis. Se esses painéis já estiverem abertos, clicar em um ponto atualizará os dados exibidos nesses painéis.

Tabela de solicitações recentes

Por padrão, a tabela de solicitações recentes exibe as cinco solicitações mais recentes. A tabela armazena 1.000 traces.

Atributo Descrição
Latência A hora de ponta a ponta do aplicativo para lidar com a solicitação.
Método HTTP Tipo de método HTTP, quando aplicável. Este campo está em branco para solicitações não HTTP.
URI O URI relativo da solicitação.
Relatório de análise Um link para o relatório de análise associado, quando houver um disponível.
Hora Quando a solicitação foi iniciada.

É possível alterar as solicitações exibidas na tabela usando qualquer um dos seguintes métodos:

  • Selecione um período.
  • Navegue para trás ou para frente usando os botões Anterior e Próxima .
  • Clique no cabeçalho de uma coluna para alterar a ordem das linhas.
  • Clique em um ponto no gráfico de latência.

A seguir