跳转到主要内容
本指南支持:
✖️ 日志✖️ ️️指标✅ 链路追踪
如需将日志发送到 ClickStack,请通过 OpenTelemetry collector 发送。

快速开始

安装 OpenTelemetry 软件包

使用以下命令安装 OpenTelemetry 软件包。

配置 OpenTelemetry + 日志记录器格式化器

接下来,你需要初始化 OpenTelemetry 链路追踪插桩, 并为 Rails logger 配置日志消息格式化器,以便日志能够 自动关联到 trace。如果没有这个自定义格式化器,日志将无法 在 ClickStack 中自动完成关联。 config/initializers 文件夹中,创建一个名为 hyperdx.rb 的文件,并将 以下内容添加到其中:

配置环境变量

接下来,你需要在 shell 中配置以下环境变量,以便通过 OpenTelemetry Collector 将遥测数据发送到 ClickStack:
OTEL_SERVICE_NAME 环境变量用于在 HyperDX 应用中标识你的服务, 你可以将它设置为任意名称。 OTEL_EXPORTER_OTLP_HEADERS 环境变量包含 API Key,可在 HyperDX 应用的 Team Settings → API Keys 中获取。
最后修改于 2026年6月10日