Sobre o Stackdriver Trace

Com o Stackdriver Trace, um sistema de rastreamento distribuído para o Google Cloud Platform (GCP), você entende quanto tempo um aplicativo leva para lidar com solicitações recebidas de usuários ou outros aplicativos e quanto tempo ele leva para concluir operações como chamadas RPC durante o processamento dessas solicitações.

Como o Stackdriver Trace coleta dados de latência do App Engine, balanceadores de carga HTTP (S) e aplicativos instrumentados com a API Stackdriver Trace (conteúdo dos links em inglês), ele pode ajudá-lo a responder às seguintes perguntas:

  • Quanto tempo meu aplicativo leva para lidar com uma determinada solicitação?
  • Por que meu aplicativo está demorando tanto para processar uma solicitação?
  • Por que algumas das minhas solicitações demoram mais que outras?
  • Qual é a latência geral das solicitações para meu aplicativo?
  • A latência para meu aplicativo aumentou ou diminuiu ao longo do tempo?
  • O que eu posso fazer para reduzir a latência do aplicativo?
  • Quais são as dependências do meu aplicativo?

Para informações sobre depuração ou criação de perfil do aplicativo, acesse Gerenciamento do desempenho de aplicativos.

Suporte ao ambiente

O Stackdriver Trace é executado no Linux nos seguintes ambientes:

O Stackdriver Trace é integrado ao ambiente padrão do App Engine (em inglês). Durante o tempo de execução do aplicativo, o ambiente padrão do App Engine envia automaticamente dados de latência ao Stackdriver Trace para solicitações de URIs do aplicativo. Essas solicitações incluem dados de latência para chamadas RPC de ida e volta aos serviços do App Engine. O Stackdriver Trace funciona com todas as APIs do App Engine, com exceção do Cloud SQL.

Os aplicativos em VMs ou contêineres (incluindo o Compute Engine, o ambiente flexível do App Engine, o GKE e aqueles em execução com outros provedores de nuvem ou locais) devem usar as bibliotecas do cliente para instrumentar o aplicativo para capturar informações de trace. Para instruções de configuração por idioma, consulte Como configurar o Stackdriver Trace.

Compatibilidade de linguagens

Bibliotecas de clientes estão disponíveis para todas as principais linguagens. Para algumas, uma biblioteca OpenCensus (em inglês) para o Stackdriver Trace está disponível:

Linguagem Biblioteca OpenCensus
C# ASP.NET Core Não
C# ASP.NET Não
Go Sim
Java Sim
Node.js Sim
PHP Sim
Python Sim
Ruby Não

Recomendamos usar a biblioteca do OpenCensus quando ela estiver disponível para sua linguagem. O OpenCensus simplifica a instrumentação porque esconde parte da complexidade da biblioteca de cliente correspondente do Stackdriver Trace.

Para instruções gerais de configuração, acesse Como configurar o Stackdriver Trace.

Componentes

O Stackdriver Trace consiste em um cliente de rastreamento, que coleta dados e os envia para o projeto do GCP, além de uma interface no console do GCP, que permite visualizar e analisar os dados coletados pelo agente.

Cliente de rastreamento

Se você estiver usando o ambiente padrão do App Engine, não precisará fazer nada. Este ambiente captura automaticamente os rastreamentos e os envia ao projeto do GCP.

Se você estiver instrumentando seu código, importe a biblioteca Trace SDK, crie dados de rastreamento e envie-os para o projeto do GCP usando a API Stackdriver Trace. A biblioteca do OpenCensus simplifica o processo de criação e envio de dados de rastreamento. Além disso, ela pode melhorar o desempenho porque agrupa dados de rastreamento e os envia em segundo plano.

Interface de rastreamento

Depois que o agente coletar dados de rastreamento, será possível visualizar e analisar esses dados quase em tempo real na interface do Stackdriver Trace. A interface contém três janelas: Visão geral, Lista de rastreamento e Relatórios de análise.

Para começar a usar o Stackdriver Trace no Console do GCP, abra a janela Visão geral:

Abrir a visão geral do Trace (em inglês)

O console do Trace não exibirá dados, a menos que você tenha implantado um aplicativo no ambiente padrão do Google App Engine ou que tenha acesso a um projeto do GCP que esteja recebendo dados do Trace.

Visão geral

A janela Visão geral fornece informações resumidas sobre o aplicativo:

página de visão geral do Stackdriver Trace

O painel Insights exibe uma lista de insights de desempenho para o aplicativo, se aplicável. Esse painel destaca problemas comuns em aplicativos, como chamadas consecutivas para uma função que, se enviadas em lote, podem ser mais eficientes.

O painel Traces recentes exibe os traces mais recentes. Para cada um, são exibidas a latência, a URI e a hora. É possível usar este resumo para entender a atividade atual no aplicativo.

Os URIs mais frequentes e os RPCs mais frequentes listam os URIs e RPCs mais frequentes do dia anterior, com a latência média. Ao clicar em um link em qualquer uma dessas tabelas, você abrirá a janela Lista de trace, que é pré-configurada para exibir as solicitações correspondentes. Usando a janela Lista de trace, será possível visualizar a latência como uma função do tempo e investigar detalhes de qualquer trace individual.

O painel Extensão de trace carregável exibe o número de períodos ingeridos no mês atual e o total do mês anterior. É possível usar essas informações para monitorar os custos de uso do Stackdriver Trace. Para mais informações sobre custos, acesse Preços.

O painel Relatórios de análise diária exibe dados de latência do dia anterior e os compara aos dados de latência de sete dias anteriores. Usando esses dados, é possível ver se seu comportamento de latência está mudando com o tempo. Não é possível alterar o formato dos relatórios nesta página. No entanto, é possível criar relatórios de análise personalizados.

Para saber mais sobre a janela Visão geral do Stackdriver Trace, acesse Como visualizar traces no Console do GCP.

Rastrear lista

A janela Lista de traces permite examinar detalhes de um trace individual. Por padrão, essa visualização exibe um gráfico da latência de todos os traces e listas e, em uma tabela, os traces mais recentes.

Se você selecionar um trace específico para examinar, dois novos painéis serão abertos: um painel da Linha de tempo que exibe todos os períodos no trace e um painel de informações que exibe detalhes sobre o período selecionado. Por padrão, a extensão raiz é selecionada e os detalhes incluem informações resumidas sobre a solicitação. Para encontrar traces para investigação, use filtros.

Para mais informações sobre como filtrar e exibir detalhes de traces, acesse Usar lista de traces e Visualizar detalhes do trace.

Relatórios de análise

A janela Relatórios de análise permite criar relatórios personalizados. Esses relatórios podem incluir todos os traces ou, ao especificar filtros, incluir apenas um subconjunto de traces. Também é possível criar relatórios que comparam dois conjuntos diferentes de dados de latência. Para mais informações, acesse Como criar relatórios de análise.

Preço

Os dados de latência são empacotados em um trace, que é composto de extensões. Os períodos são ingeridos pelo back-end do Stackdriver Trace, que disponibiliza os dados para visualização e geração de relatórios em tempo real no Console do GCP. Os períodos recuperados dos back-ends de armazenamento são verificados pelo Stackdriver Trace.

O preço do Stackdriver Trace é determinado pelo número de períodos de trace ingeridos e verificados mensalmente. Para mais informações, acesse Preços do Trace.

É possível criar um alerta para notificá-lo se a contagem de extensão ingerida exceder um limite predefinido. Para mais informações, acesse Como criar políticas de alerta.

Cota

O Stackdriver Trace impõe uma cota de taxa nas solicitações de API e uma cota de processamento nos períodos enviados para o Trace. Para mais informações, consulte Cotas e limites.

Para ver o uso atual:

  1. Na página de visão geral da API Stackdriver Trace, acesse a janela Visão geral do Trace:

    Ir para a visão geral da API Trace (em inglês)

  2. Clique em Cotas.

É possível criar um alerta para notificá-lo caso as cotas tenham sido excedidas. Para mais informações, acesse Como criar políticas de alerta.

Próximas etapas

Para saber mais sobre o console do Stackdriver Trace, acesse Como visualizar traces no Console do GCP.

Para começar a usar o Stackdriver Trace:

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

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.