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ário, consulte Conferir 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:
-
No console do Google Cloud, acesse a página Relatórios de análise:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Trace.
Clique em Novo relatório.
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 porRecv/cart
, insira esse prefixo no filtro.
Você também pode filtrar os rastros por atributos de período. Por exemplo, quando você adiciona/http/status_code:5
, o relatório inclui apenas os rastros que têm um período com a chave de atributo/http/status_code
e os valores de atributo prefixados por5
.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.
(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.
Clique em Enviar.
Duplicar um relatório
No Trace, é possível duplicar os parâmetros de filtro de um relatório existente:
-
No console do Google Cloud, acesse a página Relatórios de análise:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Trace.
Clique no nome do relatório cuja estrutura você quer duplicar.
Clique em Criar um relatório semelhante.
Na página Nova solicitação de relatório, edite um ou mais parâmetros de relatório, incluindo o nome do relatório.
Clique em Enviar.
Acessar um relatório
Para visualizar um relatório de análise:
-
No console do Google Cloud, acesse a página Relatórios de análise:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Trace.
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:
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:
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:
Entender o painel de latência
O painel Latência mostra percentis de latência e inclui links para rastros de solicitações de amostra representativas. Para conferir detalhes sobre um trace específico, selecione um dos quatro exemplos. Quando você seleciona um dos exemplos de trace, a página Trace Explorer é aberta e mostra informações detalhadas sobre o período raiz desse trace. Para mais detalhes, consulte Encontrar e analisar 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
:
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 um painel Gargalos para um relatório de análise.
Nesse caso, há apenas um conjunto de dados indicado pela letra A
:
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.