Como criar e visualizar relatórios de análise

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. O relatório diário é exibido na página Visão geral do Trace e está listado na página Relatório de análise.

Para detalhes sobre como visualizar o relatório de análise diário, consulte Como visualizar 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.

Como criar um novo relatório

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

  1. No Console do Google Cloud, acesse Trace:

    Acessar o "Trace"

  2. Na guia Relatórios de análise, 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 do trace.

      Por exemplo, quando um período raiz do projeto é Recv, para incluir todas as solicitações, digite 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.

      Você também pode 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 do 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.

Como duplicar um relatório

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

  1. No Console do Google Cloud, acesse Trace:

    Acessar o "Trace"

  2. Na guia Relatórios de análise, clique no nome do relatório cuja estrutura 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.

Como visualizar um relatório

Para visualizar um relatório de análise:

  1. No Console do Google Cloud, acesse Trace:

    Acessar o "Trace"

  2. Para ver a lista de relatórios diários gerados pelo sistema e relatórios personalizados disponíveis para visualização, clique na guia Relatórios de análise.

  3. 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.

Painel de latência

O painel Latência abaixo da visualização do gráfico mostra percentis de latência e inclui links para traces para solicitações de amostra representativas. Ao clicar em um número de trace, a página Lista de traces é aberta e exibe informações detalhadas sobre o período raiz. Para mais detalhes, consulte Como visualizar detalhes do trace.

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.

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 um painel Gargalos 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