Criar e visualizar relatórios

Os relatórios de análise no Cloud Trace mostram uma visão geral da latência de todas as solicitações ou de um subconjunto de solicitações para seu aplicativo.

Relatórios diários

O Trace cria automaticamente um relatório diário que compara o desempenho do dia anterior com o desempenho do mesmo dia da semana anterior para os três principais endpoint.

Para detalhes sobre como visualizar o relatório de análise diária, consulte Ver um relatório.

Relatórios de análise personalizados

O relatório de análise diário é criado automaticamente e não permite que você escolha o conteúdo do relatório. No entanto, você pode criar um relatório de análise personalizado e selecionar quais traces serão incluídos no relatório.

Os relatórios personalizados incluem:

  • Um histograma de dados de latência.
  • Uma tabela que lista a latência por percentil com links para traces de amostra.
  • (Opcional) Dados de latência de um período diferente usado para comparação.
  • Um painel de gargalo que lista as chamadas de RPC que contribuem significativamente para a latência.

Você pode criar um novo relatório inserindo os parâmetros do relatório manualmente ou duplicando um relatório existente e editando os parâmetros. Ambas as abordagens são descritas nas seções a seguir.

Criar um novo relatório

Para criar um novo relatório de análise, siga estas etapas:

  1. Na barra de pesquisa do console do Google Cloud, insira Relatórios de análise. Nos resultados da pesquisa, acesse a seção Produtos e páginas e selecione a página Relatórios de análise para o Trace:

    Acesse os Relatórios de análise

  2. Clique em Novo relatório.

  3. Insira ou selecione os seguintes parâmetros no formulário exibido:

    • Request filter: o URI completo, o prefixo do URI ou os termos do filtro de trace.

      Por exemplo, quando um período raiz do projeto for Recv, para incluir todas as solicitações, insira o nome do período raiz, Recv, ou um prefixo do nome do período raiz. Para restringir o relatório a traces com um URI prefixado por Recv/cart, insira esse prefixo no filtro.

      Também é possível filtrar traces por atributos de período. Por exemplo, quando você adiciona /http/status_code:5, o relatório inclui apenas os traces que têm um período com a chave de atributo /http/status_code e os valores de atributo prefixados por 5.
    • HTTP method: método HTTP para a solicitação. O padrão é Tudo.
    • HTTP Status: status HTTP retornado pela solicitação. O padrão é Tudo.
    • Report Name: nome legível para o relatório. Quando nenhum nome é especificado para esse campo opcional, o Trace cria um nome com base no filtro de solicitação especificado e na hora em que o relatório foi criado.
    • Module: módulo do App Engine (Java, Python, Go ou PHP) que processou a solicitação. O padrão é Tudo.
    • Version: versão do aplicativo do App Engine que processou a solicitação. O padrão é Tudo.
    • Time Range: intervalo de tempo durante que as solicitações ocorreram. Você pode selecionar Última hora, Últimas 24 horas, Última semana ou Intervalo personalizado. Ao selecionar Personalizado, você precisa especificar os horários de início e término do intervalo. O padrão é Personalizado.
  4. (Opcional) Para comparar dois conjuntos de dados de latência, selecione Comparar com o valor de referência e insira o período dos dados de comparação.

  5. Clique em Enviar.

Duplicar um relatório

No Trace, é possível duplicar os parâmetros de filtro de um relatório existente:

  1. Na barra de pesquisa do console do Google Cloud, insira Relatórios de análise. Nos resultados da pesquisa, acesse a seção Produtos e páginas e selecione a página Relatórios de análise para o Trace:

    Acesse os Relatórios de análise

  2. Clique no nome do relatório com a estrutura que você quer duplicar.

  3. Clique em Criar um relatório semelhante.

  4. Na página Nova solicitação de relatório, edite um ou mais parâmetros de relatório, incluindo o nome do relatório.

  5. Clique em Enviar.

Acessar um relatório

Para visualizar um relatório de análise:

  1. Na barra de pesquisa do console do Google Cloud, insira Relatórios de análise. Nos resultados da pesquisa, acesse a seção Produtos e páginas e selecione a página Relatórios de análise para o Trace:

    Acesse os Relatórios de análise

  2. Para visualizar um relatório, clique no nome dele.

Visualizar por distribuição de densidade

Por padrão, o botão Distribuição de densidade está ativado. Com essa configuração, o eixo x é a latência de trace em uma escala logarítmica, enquanto o eixo y é a porcentagem do total de solicitações com essa latência:

Relatório do Cloud Trace com latência exibida como um histograma.

Ao criar um relatório de comparação, o Trace sobrepõe os dados dos dois conjuntos de dados para que você possa compará-los e analisar as alterações:

Relatório de comparação do Cloud Trace com latência exibida como um histograma.

No relatório de comparação, a legenda no relatório identifica o período dos gráficos laranja e azul. Eles foram omitidos na captura de tela.

Visualizar por distribuição cumulativa

Para ver o número total de solicitações cuja latência é menor ou igual ao valor de latência no eixo x, clique em Distribuição cumulativa:

Relatório do Cloud Trace com latência exibida como uma distribuição cumulativa.

Entender o painel de latência

O painel Latência mostra os percentis de latência e inclui links de traces para solicitações de amostra representativas. Para visualizar detalhes sobre um trace específico, selecione um dos quatro traces de amostra. Quando você seleciona um dos traces de amostra, a página Explorador de traces é aberta e mostra informações detalhadas sobre o período raiz desse trace. Para mais detalhes, consulte Encontrar e explorar traces.

A imagem a seguir mostra um painel de latência para um relatório de análise. Nesse caso, há apenas um conjunto de dados indicado pela letra A:

Painel de latência do Cloud Trace.

Quando você cria um relatório de comparação, o painel de dados de latência contém informações para os dois conjuntos de dados. A legenda do painel identifica as entradas que pertencem a cada um dos conjuntos de dados.

Entender o painel de gargalos

Um gargalo indica que o valor de latência de um período em um trace específico está fora do intervalo esperado de valores de latência. O Cloud Trace determina o intervalo esperado de valores de latência usando técnicas estatísticas que dependem da computação e da comparação de distribuições de latência empíricas para subconjuntos de traces.

O painel Gargalos, quando presente, lista as chamadas RPC que contribuem significativamente para a latência nas solicitações. Esse painel exibe as chamadas de RPC por percentil com solicitações de amostra representativas. Clique em um número em Traces de amostra para ver os detalhes de um trace específico.

A imagem a seguir mostra o painel Bottlenecks para um relatório de análise. Nesse caso, há apenas um conjunto de dados indicado pela letra A:

Painel de gargalos de solicitação do Cloud Trace.

Em um relatório de comparação, os gargalos destacam as chamadas de RPC que causaram alterações na distribuição de latência entre os dois conjuntos. A legenda neste painel identifica as entradas que pertencem a cada um dos conjuntos de dados.

A seguir