Visão geral do Cloud Trace

O Cloud Trace, um sistema de rastreamento distribuído para Google Cloud, ajuda você a entender quanto tempo leva para o aplicativo processar solicitações recebidas de usuários ou outros aplicativos e quanto tempo leva para concluir operações como chamadas RPC realizadas ao lidar com as solicitações. O Trace também pode ajudar durante o desenvolvimento de um serviço ou solução de uma falha. Por exemplo, você entende como as solicitações são processadas em uma arquitetura de microsserviços complicada e como identificar quais registros analisar.

Como o Trace recebe dados de latência de alguns Google Cloud serviços, como o App Engine, e de aplicativos instrumentados com a API Cloud Trace, ele pode ajudar você 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?

Se quiser saber como usar o Trace para gerenciar seus aplicativos, leia o blog Solução de problemas de aplicativos distribuídos: uso de traces e registros juntos para análise da causa raiz.

Para informações sobre como criar perfil do aplicativo, consulte Cloud Profiler.

Suporte ao ambiente

O Trace é executado no Linux nos seguintes ambientes:

O Trace fornece bibliotecas de cliente para instrumentar seu aplicativo e capturar informações de rastreamento. Para instruções de configuração por linguagem, consulte Instrumentar para o Trace.

Configurações com rastreamento automático

Algumas configurações resultam na captura automática de dados de trace:

  • Ambiente padrão do App Engine

    Os aplicativos Java 8, Python 2 e PHP 5 não precisam usar as bibliotecas de cliente do Trace. Esses ambientes de execução enviam automaticamente dados de latência ao Trace para solicitações a URIs de aplicativos. As solicitações incluem dados de latência para chamadas RPC de ida e volta para os serviços do App Engine. O Trace funciona com todas as APIs administradoras do App Engine, com exceção do Cloud SQL.

  • Funções do Cloud Run e Cloud Run

    Para solicitações HTTP recebidas e enviadas, os dados de latência são enviados automaticamente ao Trace.

Suporte ao idioma

A tabela a seguir resume a disponibilidade das bibliotecas de cliente do Trace e das bibliotecas do OpenTelemetry para as quais há um exportador para o Trace.

Idioma Biblioteca de cliente
disponível		 Biblioteca/exportador do
OpenTelemetry disponível
C++ Sim Sim
C# ASP.NET Core Sim Não
C# ASP.NET Sim Não
Go Sim Sim
Java Sim Sim
Node.js Sim Sim
PHP Sim Não
Python Sim Sim
Ruby Sim Sim

As bibliotecas do OpenTelemetry são mais simples de usar do que as bibliotecas de cliente do Trace porque ocultam parte da complexidade da API Trace correspondente. Para recomendações de instrumentação, consulte Escolher uma abordagem de instrumentação.

Componentes

O Trace consiste em um cliente de rastreamento, que coleta traces e os envia ao projeto do Google Cloud . Depois, use o console do Google Cloud para conferir e analisar os dados coletados pelo agente. Para informações sobre o modelo de dados, consulte Traces e períodos.

Cliente de rastreamento

Se uma biblioteca do OpenTelemetry estiver disponível para sua linguagem de programação, você poderá simplificar o processo de criação e envio de dados de trace usando o OpenTelemetry. Além de ser mais simples de usar, o OpenTelemetry implementa lotes que podem melhorar o desempenho.

Se não existir uma biblioteca do OpenTelemetry, instrumente seu código importando a biblioteca do SDK do Trace e usando a API Cloud Trace. A API Cloud Trace envia dados de trace para seu projeto Google Cloud .

interface de rastreamento

É possível visualizar e analisar os dados de rastreamento quase em tempo real na interface do Trace.

A página Explorador de traces mostra informações agregadas sobre os dados de trace e permite examinar traces individuais em detalhes. Os dados agregados de latência são mostrados em um mapa de calor, que você pode explorar com o ponteiro. Para restringir os dados exibidos, adicione filtros. Nessa página, também é possível ver e analisar intervalos e traces individuais:

Suporte do VPC Service Controls

O Trace é um serviço compatível com o VPC Service Controls. O nome do serviço de rastreamento é cloudtrace.googleapis.com. Todas as restrições do VPC Service Controls criadas para o serviço Trace se aplicam apenas a ele. Essas restrições não se aplicam a outros serviços, incluindo aqueles como o serviço telemetry.googleapis.com, que também pode ingerir dados de rastreamento.

Para ver mais informações, consulte os seguintes tópicos:

Preços

Para saber mais sobre os preços do Cloud Trace, consulte a página Preços do Google Cloud Observability.

A seguir