Este documento descreve a API Telemetry (OTLP), que implementa o protocolo OTLP OpenTelemetry. Esta API foi concebida para utilização com aplicações instrumentadas através de um dos SDKs OpenTelemetry.
Por que motivo deve usar a API Telemetry
A API Telemetry suporta a ingestão de dados de rastreio no formato OTLP. Quando usa a API Telemetry, os seus dados são armazenados no formato OTLP sem nunca serem convertidos num formato proprietário, e aplicam-se os limites da API Telemetry. Estes limites são frequentemente mais generosos do que os da Cloud Trace API. Por último, a sua instrumentação não depende de um exportador específico do Google Cloud.
O OpenTelemetry é um projeto de código aberto suportado pela Google com engenheiros responsáveis por garantir o suporte para carregar e visualizar os seus dados de rastreio. Google CloudGoogle Cloud
Quando usar a API Telemetry
Quando instrumentar as suas aplicações para enviar dados de rastreio para o seu Google Cloud projeto, recomendamos que faça uma das seguintes ações:
- Use um exportador que escreva OTLP num coletor, que, em seguida, envia os seus dados de rastreio para a API Telemetry.
- Use um exportador OTLP no processo suportado por uma biblioteca OpenTelemetry que envie telemetria para a API Telemetry. Não existe um coletor com esta configuração.
Para ver informações sobre como usar a API Telemetry, consulte o artigo Migre do exportador do Cloud Trace para o ponto final OTLP.
Onde ver os dados carregados
Os dados de rastreio carregados através da API Telemetry podem ser vistos na página Explorador de rastreios. Para obter informações sobre como ver os dados de rastreio, consulte o artigo Encontre e explore rastreios.
Os dados de rastreio carregados através da API Telemetry não estão disponíveis na página do Explorador de rastreios antigo. Para mais informações, consulte o artigo Explorador de rastreios antigo: problemas conhecidos.
Autenticação
Os exportadores têm de ter autorização para enviar dados para o seu Google Cloud projeto. Por exemplo, pode configurar o exportador com as suas Google Cloud credenciais predefinidas da aplicação (ADC) adicionando uma biblioteca de autenticação Google específica do idioma à sua aplicação. Para mais informações e código de exemplo, consulte o artigo Configure a autenticação.
Suporte dos VPC Service Controls
O serviço da API Telemetry, cujo nome de serviço é telemetry.googleapis.com, é um serviço suportado pelos VPC Service Controls. Quaisquer restrições dos VPC Service Controls
que criar para o serviço da API Telemetry aplicam-se
apenas a esse serviço. Essas restrições não se aplicam a outros serviços, incluindo serviços como o serviço cloudtrace.googleapis.com, que também podem carregar dados de rastreio.
Para mais informações, consulte o seguinte: