This document describes the Telemetry (OTLP) API, which implements the OpenTelemetry OTLP Protocol. This API is designed for use with applications that are instrumented by using one of the OpenTelemetry SDKs.
Why you should use the Telemetry API
The Telemetry API supports the ingestion of trace data that is in the OTLP format. When you use the Telemetry API, your data is stored in the OTLP format without ever being converted into a proprietary format, and the limits for the Telemetry API apply. These limits are often more generous than those for the Cloud Trace API. Lastly, your instrumentation doesn't rely on a Google Cloud-specific exporter.
OpenTelemetry is a Google Cloud-supported open source project with Google Cloud engineers staffed to ensure support for ingesting and visualizing your trace data.
When to use the Telemetry API
When instrumenting your applications to send trace data to your Google Cloud project, we recommend that you do one of the following:
- Use an exporter that writes OTLP to a collector, which then sends your trace data to the Telemetry API.
- Use an in-process OTLP exporter supported by an OpenTelemetry library that sends telemetry to the Telemetry API. There is no collector with this configuration.
For information about how to use the Telemetry API, see Migrate from the Cloud Trace exporter to the OTLP endpoint.
Where to view ingested data
Trace data that is ingested through the Telemetry API can be viewed using the Trace Explorer page. For information about how to view your trace data, see Find and explore traces.
Trace data ingested through the Telemetry API legacy Trace Explorer page. For more information, see Legacy Trace Explorer: Known issues.
VPC Service Controls support
The Telemetry API service, whose service name is telemetry.googleapis.com,
is a VPC Service Controls-supported service. Any VPC Service Controls restrictions
that you create for the Telemetry API service apply
only to that service. Those restrictions don't apply to any
other services, including those like the cloudtrace.googleapis.com service,
which can also ingest trace data.
For more information, see the following: