É possível instrumentar seus aplicativos para o Cloud Trace a fim de capturar dados de rastreamento distribuído, examinar a latência de solicitações individuais e visualizar a latência agregada em todos os serviços no console do Trace.
Este documento oferece uma visão geral das abordagens de instrumentação e das opções de configuração. Para instruções detalhadas sobre linguagens de programação específicas, consulte as páginas de configuração específicas da linguagem.
Quando instrumentar seu aplicativo
Quando os dados de rastreamento para validar o desempenho ou solucionar problemas não são capturados automaticamente, instrumente seu aplicativo.
Instrumente seu aplicativo para coletar informações específicas que ajudem você a entender o desempenho e solucionar falhas. Vários frameworks de instrumentação de código aberto coletam dados de registro, métricas e rastreamento e podem enviar esses dados a qualquer fornecedor, incluindo Google Cloud. Para seus aplicativos de agente, alguns frameworks podem coletar comandos e respostas ou transmitir o contexto que permite o rastreamento de algumas chamadas de servidores MCP remotos do Google Cloud.
Para instrumentar seu aplicativo, recomendamos que você use uma estrutura de instrumentação neutra de fornecedores e de código aberto, como o OpenTelemetry, em vez de APIs ou bibliotecas de cliente específicas do fornecedor e do produto. Para informações sobre esses frameworks, consulte Instrumentação e observabilidade e Escolher uma abordagem de instrumentação.
Como instrumentar aplicativos
Há várias abordagens que podem ser usadas para instrumentar seu aplicativo:
Recomendado: use o OpenTelemetry, configure seu aplicativo com um exportador OTLP que envia dados de rastreamento para um coletor e configure o coletor para enviar dados de rastreamento para seu Google Cloud projeto usando a API Telemetry (OTLP). Para saber mais sobre nossas recomendações, consulte Escolher uma abordagem de instrumentação.
Use o OpenTelemetry e configure seu aplicativo com um exportador OTLP que envia os dados de rastreamento para seu Google Cloud projeto usando a API Telemetry.
Se você escrever aplicativos que são executados no Compute Engine, poderá usar o Agente de operações e o receptor OpenTelemetry Protocol (OTLP) para coletar rastreamentos e métricas do aplicativo. O Agente de operações também pode coletar registros, mas não usando o OTLP. Para mais informações, consulte Usar o Agente de operações e o OTLP e Visão geral do Agente de operações.
Invoque diretamente a API Telemetry ou a API Cloud Trace.
Para aplicativos Spring Boot, configure-os para encaminhar os dados de rastreamento coletados para o Cloud Trace. Para informações sobre esse procedimento, consulte Spring Cloud para Google Cloud: Cloud Trace.
Use as bibliotecas de cliente do Cloud Trace ou o exportador do Cloud Trace para OpenTelemetry.
Exemplos de instrumentação
Os exemplos de instrumentação que fornecemos usam OpenTelemetry:
Para exemplos que usam uma exportação baseada em coletor, consulte o seguinte: