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.appendhttps://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.