本文档介绍了遥测 (OTLP) API，该 API 实现了 OpenTelemetry OTLP 协议。此 API 专为使用某个 OpenTelemetry SDK 插桩的应用而设计。
为何应使用 Telemetry API
Telemetry API 支持提取 OTLP 格式的轨迹数据。使用 Telemetry API 时，您的数据会以 OTLP 格式存储，而不会转换为专有格式，并且Telemetry API 的限制也会适用。这些限制通常比 Cloud Trace API 的限制更宽松。最后，您的插桩不会依赖于特定于 Google Cloud的导出器。
OpenTelemetry 是一个由 Google Cloud支持的开源项目， Google Cloud工程师团队负责确保为您提供跟踪数据提取和可视化方面的支持。
何时使用 Telemetry API
在对应用进行插桩以将跟踪记录数据发送到 Google Cloud 项目时，我们建议您执行以下任一操作：
- 使用将 OTLP 写入收集器的导出器，然后收集器将跟踪数据发送到 Telemetry API。
- 使用由 OpenTelemetry 库支持的进程内 OTLP 导出器，将遥测数据发送到 Telemetry API。没有采用此配置的收集器。
如需了解如何使用 Telemetry API，请参阅从 Cloud Trace 导出器迁移到 OTLP 端点。
在哪里查看提取的数据
您可以使用 Trace Explorer 页面查看通过 Telemetry API 提取的轨迹数据。如需了解如何查看跟踪记录数据，请参阅查找和探索跟踪记录。
通过 Telemetry API 旧版 Trace Explorer 页面提取的跟踪数据。如需了解详情，请参阅旧版轨迹浏览器：已知问题。
VPC Service Controls 支持
Telemetry API 服务（服务名称为 telemetry.googleapis.com）是 VPC Service Controls 支持的一项服务。您为 Telemetry API 服务创建的任何 VPC Service Controls 限制仅适用于该服务。这些限制不适用于任何其他服务，包括 cloudtrace.googleapis.com 服务等也能提取轨迹数据的服务。
详情请参阅以下内容：