Este documento descreve a API de telemetria (OTLP), que implementa o protocolo OTLP do OpenTelemetry. Essa API foi projetada para uso com aplicativos instrumentados usando um dos SDKs do OpenTelemetry.
Por que usar a API Telemetry
A API Telemetry oferece suporte à ingestão de dados de rastreamento no formato OTLP. Quando você usa a API Telemetry, seus dados são armazenados no formato OTLP sem serem convertidos em um formato proprietary, e os limites da API Telemetry são aplicados. Esses limites geralmente são mais generosos do que os da API Cloud Trace. Por fim, sua instrumentação não depende de um exportador específico de Google Cloud.
O OpenTelemetry é um projeto de código aberto com suporte do Google Cloud, com Google Cloud engenheiros contratados para garantir o suporte para a ingestão e visualização dos dados de rastreamento.
Quando usar a API Telemetry
Ao instrumentar seus aplicativos para enviar dados de trace ao seu projeto do Google Cloud, recomendamos que você faça uma das seguintes ações:
- Use um exportador que grava OTLP em um coletor, que, por sua vez, envia os dados de trace para a API Telemetry.
- Use um exportador OTLP em processo com suporte de uma biblioteca do OpenTelemetry que envia telemetria para a API Telemetry. Não há coletor com essa configuração.
Para informações sobre como usar a API Telemetry, consulte Migrar do exportador do Cloud Trace para o endpoint OTLP.
Onde consultar os dados ingeridos
Os dados de trace ingeridos pela API Telemetry podem ser visualizados usando a página Trace Explorer. Para saber como conferir seus dados de trace, consulte Encontrar e analisar traces.
Dados de trace ingeridos pela página Trace Explorer legado da API Telemetry. Para mais informações, consulte Trace Explorer legado: problemas conhecidos.
Suporte do VPC Service Controls
O serviço da API Telemetry, cujo nome é telemetry.googleapis.com,
é um serviço compatível com o VPC Service Controls. Todas as restrições do VPC Service Controls
criadas para o serviço da API Telemetry se aplicam
apenas a esse serviço. Essas restrições não se aplicam a nenhum
outro serviço, incluindo aqueles como o serviço cloudtrace.googleapis.com,
que também pode processar dados de rastreamento.
Para ver mais informações, consulte os seguintes tópicos: