Referência da API REST Telemetry (OTLP)

Esta página descreve a API Telemetry (OTLP), que implementa o protocolo OTLP OpenTelemetry. Para obter informações sobre esta API, consulte a Vista geral da API Telemetry.

Ponto final do serviço

Um ponto final de serviço é um URL base que especifica o endereço de rede de um serviço de API. Um serviço pode ter vários pontos finais de serviço. Este serviço suporta um ponto final de serviço global.

Pedido HTTP

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

Corpo do pedido

O corpo do pedido contém uma instância de ExportTraceServiceRequest. Para obter informações sobre esta estrutura, consulte os ficheiros trace_service.proto e trace.proto.

Se adicionar attributes a um Span, certifique-se de que segue as instruções da OpenTelemetry. Para mais informações, consulte o artigo Conceitos comuns de especificações: atributo.

Para obter informações sobre o envio de pedidos e sobre o protocolo OTLP, consulte os detalhes do protocolo.

Corpo da resposta

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

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

Âmbitos de autorização

Requer um dos seguintes âmbitos do OAuth:

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

Para mais informações, consulte o Authentication Overview.