跳转到主要内容
ClickStack 使用 OpenTelemetry (OTel) collector 从 Kubernetes 集群中收集日志、指标和 Kubernetes 事件,并将其转发到 ClickStack。我们支持原生 OTel 日志格式,无需任何额外的厂商专用配置。 本指南集成以下内容:
  • 日志
  • 基础设施指标
如需发送应用层指标或 APM/链路追踪,你还需要为应用添加相应的语言集成。
以下指南假设你已部署了作为网关的 ClickStack OTel collector,并使用摄取 API key 对其进行了保护。

创建 OTel Helm 图表配置文件

为了同时从各个节点和集群本身收集日志与指标,我们需要部署两个独立的 OpenTelemetry Collector。一个将作为 DaemonSet 守护进程集部署,用于从各个节点收集日志与指标;另一个将作为部署来运行,用于从集群本身收集日志与指标。

创建 API key Secret

使用 HyperDX 中的摄取 API key创建一个新的 Kubernetes Secret。下方安装的组件将使用它安全地将数据摄取到你的 ClickStack OTel collector 中:
此外,创建一个包含 ClickStack OTel collector 位置的 ConfigMap:

创建 DaemonSet 守护进程集配置

DaemonSet 守护进程集会从集群中的每个节点采集日志和指标,但不会采集 Kubernetes 事件或集群级指标。 下载 DaemonSet 守护进程集清单:

创建部署配置

要收集 Kubernetes 事件和集群级指标,我们需要单独部署一个以部署形式运行的 OpenTelemetry Collector。 下载安装清单:

部署 OpenTelemetry Collector

现在,您可以使用 OpenTelemetry Helm 图表 在 Kubernetes 集群中部署 OpenTelemetry Collector。 添加 OpenTelemetry Helm 仓库:
按上述配置安装 chart:
copy
现在,来自 Kubernetes 集群的指标、日志和 Kubernetes 事件应该已经显示在 HyperDX 中了。

将资源标签传递到 pod (容器组) (推荐)

为了将应用层的日志、指标和链路追踪与 Kubernetes 元数据 (例如 pod 名称、命名空间等) 关联起来,您需要使用 OTEL_RESOURCE_ATTRIBUTES 环境变量 将 Kubernetes 元数据传递给应用程序。 以下是一个示例部署,演示如何使用环境变量将 Kubernetes 元数据传递给 应用程序:
最后修改于 2026年7月2日