Referencia de la API de la telemetría REST (OTLP)

En esta página, se describe la API de Telemetry (OTLP), que implementa el protocolo OTLP de OpenTelemetry. Para obtener información sobre esta API, consulta Descripción general de la API de Telemetry.

Extremo de servicio

Un extremo de servicio es una URL base que especifica la dirección de red de un servicio de API. Un servicio puede tener varios extremos de servicio. Este servicio admite un extremo de servicio global.

Solicitud HTTP

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de ExportTraceServiceRequest. Para obtener información sobre esta estructura, consulta trace_service.proto y trace.proto.

Si agregas attributes a un Span, asegúrate de seguir las instrucciones de OpenTelemetry. Para obtener más información, consulta Conceptos comunes de las especificaciones: Atributo.

Para obtener información sobre el envío de solicitudes y el protocolo OTLP, consulta Detalles del protocolo.

Cuerpo de la respuesta

El cuerpo de la respuesta contiene una instancia de ExportTraceServiceResponse. Para obtener información sobre esta estructura, consulta trace_service.proto.

La respuesta puede indicar un éxito total, parcial o una falla. Para obtener más información, consulta Respuesta de OTLP/gRPC.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta el archivo Authentication Overview.