安装 ClickStack OpenTelemetry collector
要将数据发送到托管 ClickStack，应以网关角色部署一个 OTel collector。与 OTel 兼容的插桩会通过基于 HTTP 或 gRPC 的 OTLP 将事件发送到该 collector。我们建议使用 ClickStack OpenTelemetry collector这样您就可以受益于标准化摄取、强制执行的 schema，以及与 ClickStack UI (HyperDX) 的开箱即用兼容性。使用默认 schema 可启用自动 source 检测和预配置的列映射。
向 collector 发送数据
要将数据发送到托管 ClickStack，请将您的 OpenTelemetry 插桩指向 OpenTelemetry collector 提供的以下端点：
- HTTP (OTLP):
http://localhost:4318
- gRPC (OTLP):
localhost:4317
对于支持 OpenTelemetry 的语言 SDK和遥测库，您只需在应用程序中设置 OTEL_EXPORTER_OTLP_ENDPOINT 环境变量：如果以 agent 角色部署 OTel collector 的 contrib 发行版，则可使用 OTLP exporter 将数据发送到 ClickStack collector。下面展示了一个 agent 配置示例，它会读取这个结构化日志文件。大多数 ClickStack 发行版都包含 ClickStack OpenTelemetry collector，包括：安装 ClickStack OpenTelemetry collector
ClickStack OTel collector 也可以独立部署，不依赖于技术栈中的其他组件。如果你使用的是 HyperDX-only 发行版，则需要自行负责将数据传送到 ClickHouse。可通过以下方式实现：我们建议使用 ClickStack OpenTelemetry collector这样你可以受益于标准化摄取、强制执行的 schema，以及与 HyperDX UI 的开箱即用兼容性。使用默认 schema 可启用自动 source 检测和预配置的列映射。
将数据发送到 collector
要将数据发送到 ClickStack，请将你的 OpenTelemetry 插桩指向 OpenTelemetry collector 提供的以下端点：
- HTTP (OTLP):
http://localhost:4318
- gRPC (OTLP):
localhost:4317
对于支持 OpenTelemetry 的语言 SDK和遥测库，你只需在应用程序中设置 OTEL_EXPORTER_OTLP_ENDPOINT 环境变量：此外，还需要提供一个包含 API 摄取密钥的授权请求头。你可以在 HyperDX 应用中的 Team Settings → API Keys 下找到该密钥。对于语言 SDK，这既可以通过 init 函数设置，也可以通过 OTEL_EXPORTER_OTLP_HEADERS 环境变量设置，例如：agent 同样应在所有 OTLP 通信中包含此授权请求头。例如，如果以 agent 角色部署 OTel collector 的 contrib 发行版，则可以使用 OTLP exporter。下面展示了一个读取此结构化日志文件的 agent 配置示例。请注意，需要指定授权密钥，参见 <YOUR_API_INGESTION_KEY>。 
