This page describes the Telemetry (OTLP) API, which implements the OpenTelemetry OTLP Protocol . For information about this API, see Telemetry API overview .
Service endpoint
A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service supports a global service endpoint.
HTTP request
POST
https://telemetry.googleapis.com/v1/traces
Request body
The request body contains an instance of ExportTraceServiceRequest
.
For information about this structure, see trace_service.proto
and trace.proto
.
If you add attributes
to a Span
, then make sure you follow
OpenTelemetry's instructions. For more information, see Common specification concepts: Attribute
.
For information about sending requests and about the OTLP protocol, see Protocol Details .
Response body
The response body contains an instance of ExportTraceServiceResponse
.
For information about this structure, see the trace_service.proto
.
The response can indicate full success, partial success, or failure. For more information, see OTLP/gRPC Response .
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/trace.append -
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .

