Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

使用 Bindplane 将 OpenTelemetry 发送到 ClickStack

View as MarkdownEdit this pageReport an issueSet up docs MCP
合作伙伴集成

什么是 Bindplane？

Bindplane 是一个 OpenTelemetry 原生遥测管道，可为 OpenTelemetry Collectors 提供集中式管理。它通过提供可视化配置编辑、安全滚动发布和管道智能分析，简化了大规模 collector 集群的运维。

为什么选择 Bindplane + ClickStack？

在大规模环境中，管理大批 OpenTelemetry Collectors 往往会成为运维瓶颈。ClickStack 已经证明自己能够承受极高的摄取量——客户正以每秒数 GB 的速度摄取遥测数据，并存储数百 PB 的数据。此时，挑战的重点不再是查询性能，而是如何可靠地运维为 ClickHouse 提供数据的 collector 基础设施。

Bindplane 通过以下能力解决这一问题：

  • 为从数千到超过一百万的 OpenTelemetry Collectors 提供集中管理
  • 提供可视化配置编辑和安全的一键滚动发布
  • 在数据到达 ClickStack 之前，统一执行自动资源检测与富集
  • 支持扇出路由，使同一遥测数据流能够同时发送到 ClickStack 和其他目标端
  • 提供完整的管道可观测性，包括 collector 健康状态、吞吐量和端到端性能

前置条件

  • 正在运行的 ClickStack 实例 (本地、Server 或 ClickHouse Cloud)
  • Bindplane 账户 (在 app.bindplane.com 创建账户)
  • 已安装 Bindplane OTel Collector (参见安装你的第一个 Collector)
  • Bindplane collectors 与 ClickStack OTLP 端点之间具备网络连通性
  • ClickStack API 摄取密钥 (可在 ClickStack Team Settings > API Keys 中找到，参考此文档)
  • 已开放相应的网络端口 (HTTP/s 使用 4318，gRPC 使用 4317)

将 ClickStack 与 Bindplane 集成

将 ClickStack 配置为目标端

  1. 登录你的 Bindplane 账户
  2. 进入 Library
  3. 点击 Add Destination
  4. 从可用目标端列表中选择 ClickStack
  5. 配置连接：
    • Protocol：选择 HTTP 或 gRPC (默认使用 HTTP，端口为 4318)
    • Hostname：输入你的 ClickStack OTLP 端点主机名或 IP 地址
    • Port：输入端口 (HTTP 为 4318，gRPC 为 4317)
    • API 摄取密钥：输入你的 ClickStack API 摄取密钥
  6. 为目标端命名 (例如“ClickStack Production”)
  7. 点击 Save 创建目标端

创建配置

配置好 ClickStack 目标端后，创建一个配置来处理并路由遥测数据：

  1. 进入 Configurations → Create Configuration
  2. 为配置命名 (例如“ClickStack Pipeline”)
  3. 为你的部署选择 Collector Type 和 Platform
  4. 添加源：
    • 点击 Add Source，从 80 多个可用源中选择
    • 如需测试，你可以添加一个遥测生成器源来模拟流量
    • 在生产环境中，请为实际遥测数据 (日志、指标、链路追踪) 添加源
  5. 添加 ClickStack 目标端：
    • 点击 Add Destination
    • 选择你在上一步创建的 ClickStack 目标端
    • 选择要发送的遥测类型 (Logs、Metrics、Traces 或全部)

添加处理器 (可选)

Bindplane 提供管道智能分析和处理器推荐。你可以添加处理器来执行以下操作：

  • Filter：排除不必要的遥测数据，以减少数据量
  • Sample：对高数据量的链路追踪应用采样策略
  • Enrich：添加资源属性、标记或元数据
  • Transform：修改遥测数据的结构或内容
  • Batch：优化批次大小以提高传输效率

这些处理器会在数据到达 ClickStack 之前，在你的 collector 集群中统一应用。

部署 collectors 并开始滚动发布

  1. 将一个 collector (BDOT Collector) 添加到你的配置中：

    • 在 Bindplane 中进入 Agents
    • 按照 Bindplane 的安装说明 在目标系统上安装 Bindplane collector
    • 连接成功后，该 collector 就会出现在你的 collector 列表中

  2. 将配置分配给你的 collectors：

    • 选择你要使用的 collectors
    • 将 ClickStack 配置分配给它们

  3. 开始滚动发布：

    • 点击 Start Rollout 部署配置
    • Bindplane 会在滚动发布前验证配置
    • 在 Bindplane UI 中监控滚动发布状态
通过 Bindplane 在 ClickStack 中查看遥测信号

在 ClickStack 中验证遥测数据

配置完成滚动发布后，遥测数据会从你管理的 collector 集群流入 ClickStack：

  1. 登录你的 ClickStack 实例 (HyperDX UI)
  2. 进入 Logs、Metrics 或 Traces 浏览页面
  3. 你应该能看到来自 Bindplane 管理的 collectors 的遥测数据开始出现
  4. 到达 ClickStack 的数据已由 Bindplane 处理器完成富集和结构化
通过 Bindplane 在 ClickStack 中查看遥测信号

高级配置

扇出路由

Bindplane 支持扇出路由，让您能够同时将相同的遥测数据流发送到多个目标端。您可以：

  • 将日志、指标和链路追踪发送到 ClickStack，以便长期存储和分析
  • 将相同的数据路由到其他可观测性平台，以实现实时告警
  • 将特定遥测数据转发到 SIEM 平台，以进行安全分析

这可以通过在 Bindplane 配置中添加多个目标端来实现。

压缩与性能

对于高流量场景，请在 ClickStack 目标端中配置压缩：

  • HTTP：支持 gzip、deflate、snappy、zstd 或 none (默认值：gzip)
  • gRPC：支持 gzip、snappy、zstd 或 none (默认值：gzip)

将遥测数据发送到 ClickStack 时，压缩可减少带宽占用，在大规模场景下尤为重要。

后续步骤

现在，既然来自 Bindplane 的遥测数据已经流入 ClickStack，你可以：

  • 构建仪表盘：在 ClickStack (HyperDX) 中为日志、指标和链路追踪创建可视化
  • 设置告警：在 ClickStack 中为关键情况配置告警
  • 扩展部署规模：随着可观测性需求增长，添加更多 collector 和数据源
  • 优化管道：使用 Bindplane 的管道智能功能识别优化机会

延伸阅读

Navigation