Referencia de la API Telemetry REST (OTLP)

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

Punto final de servicio

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

Solicitud HTTP

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

Cuerpo de la solicitud

En el cuerpo de la solicitud se incluye una instancia de ExportTraceServiceRequest. Para obtener información sobre esta estructura, consulta trace_service.proto y trace.proto.

Si añades 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 cómo enviar solicitudes y sobre 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 que la operación se ha completado correctamente, que se ha completado parcialmente o que ha fallado. Para obtener más información, consulta Respuesta de OTLP/gRPC.

Permisos de autorización

Debes disponer de 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 artículo Authentication Overview.