Referência da API REST Telemetry (OTLP)

Esta página descreve a API de telemetria (OTLP), que implementa o protocolo OTLP do OpenTelemetry. Para saber mais sobre essa API, consulte Visão geral da API Telemetry.

Endpoint de serviço

Um endpoint de serviço é um URL de base que especifica o endereço de rede de um serviço de API. Um serviço pode ter vários endpoints de serviço. Esse serviço oferece suporte a um endpoint de serviço global.

Solicitação HTTP

POST https://telemetry.googleapis.com/v1/traces

Corpo da solicitação

O corpo da solicitação contém uma instância de ExportTraceServiceRequest. Para informações sobre essa estrutura, consulte trace_service.proto e trace.proto.

Se você adicionar attributes a um Span, siga as instruções do OpenTelemetry. Para mais informações, consulte Conceitos comuns de especificação: atributo.

Para informações sobre como enviar solicitações e sobre o protocolo OTLP, consulte Detalhes do protocolo.

Corpo da resposta

O corpo da resposta contém uma instância de ExportTraceServiceResponse. Para informações sobre essa estrutura, consulte o trace_service.proto.

A resposta pode indicar sucesso total, sucesso parcial ou falha. Para mais informações, consulte Resposta OLTP/gRPC.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/trace.append
  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.