本文档介绍了为什么我们建议您使用实现了 OpenTelemetry OTLP 协议的 Telemetry (OTLP) API 将跟踪记录数据发送到Google Cloud 项目。此外，它还提供了有关如何为应用插桩以及在何处查看跟踪记录数据的指南。当您使用某个 OpenTelemetry SDK 对应用进行插桩处理时，或者当您使用 OpenTelemetry 收集器时，可以使用 Telemetry API。
我们推荐使用 Telemetry API，原因如下：
此 API 可与开源 OpenTelemetry 生态系统兼容，并且其限制通常比 Cloud Trace API（一种专有 Google Cloud API）的限制更宽松。
您的跟踪记录数据以通常与 OpenTelemetry OTLP 协议定义的 proto 文件一致的格式存储。在存储之前，某些字段可能会从 OpenTelemetry 特定的数据类型转换为 JSON 数据类型。如需详细了解存储格式，请参阅跟踪记录数据的架构。
您的插桩不依赖于特定于 Google Cloud的导出器。
某些功能（如“应用监控”）依赖于仅在您将跟踪记录数据发送到 Telemetry API 时才可用的信息。
OpenTelemetry 是一个受 Google Cloud支持的开源项目，配备 Google Cloud工程师来确保支持注入和直观呈现遥测数据。
最佳做法
在对应用进行插桩处理以将跟踪记录数据发送到Google Cloud 项目时，我们建议您执行以下操作之一：
- 使用将 OTLP 写入收集器的导出器，收集器随后会将跟踪记录数据发送到 Telemetry API。
- 使用受 OpenTelemetry 库支持的进程中 OTLP 导出器，该库会将遥测数据发送到 Telemetry API。没有具有此配置的收集器。
如需了解如何使用 Telemetry API，请参阅从 Cloud Trace 导出器迁移到 OTLP 端点。
身份验证
您必须使用必要的凭据配置导出器，才能将跟踪记录数据发送到您的 Google Cloud 项目。例如，如需使用Google Cloud 应用默认凭证 (ADC) 配置导出器，请向应用添加特定于语言的 Google Auth 库。如需了解详情和查看示例代码，请参阅配置身份验证。
Cloud Trace 和数据驻留
如果您因数据驻留或影响级别 4 (IL4) 要求而使用 Assured Workloads，则不应使用 Telemetry API 将跟踪记录 span 发送到您的项目。
在何处查看注入的数据
您可以使用 Trace 探索器和 Log Analytics 页面查看跟踪记录数据。如需了解相关信息，请参阅以下内容：