通过 Helm Chart 将 HertzBeat 集群组件整体部署到 Kubernetes

方案简介

本方案使用官方发布的 Helm Chart，一次性将 HertzBeat 的集群组件（hertzbeat 主服务、collector 采集器、postgresql 关系数据库、tsdb 时序数据库）部署到 Kubernetes 集群中，是 README 列出的五种安装方式中的云原生部署方式。HertzBeat 是无需 Agent 的实时观测系统，高性能集群，支持多采集器集群横向扩展。该方案适合已在 Kubernetes 上运行业务的团队，将监控系统纳入统一的云原生编排体系。

亮点与能力

• 一次 Chart 安装包含 hertzbeat+collector+postgresql+tsdb 全套组件
• 无需 Agent，兼容 Prometheus 的统一指标平台
• 统一日志平台，通过 OTLP 协议多日志源无缝对接上报
• 统一告警平台，灵活的实时与周期阈值规则，分组收敛，静默，抑制
• 提供强大的状态页构建能力
• 内置 MCP Server 对外能力

组成与分工

• HertzBeat：监控主服务，负责采集调度、分析、告警与通知
• Collector：采集器组件，可横向扩展承担监控数据采集
• PostgreSQL：元数据存储
• TSDB：时序指标数据存储
• Kubernetes：容器编排平台
• Helm：Kubernetes 应用包管理与部署工具

前置要求

• 一个可用的 Kubernetes 集群
• 安装 Helm 工具
• 可访问 Artifact Hub 上的 hertzbeat 仓库：Artifact Hub

实施步骤

1. 准备 Kubernetes 集群与 Helm

确保集群可用并安装好 Helm。

2. 获取 Chart 并部署

从 Artifact Hub 获取 hertzbeat 官方 Chart（https://artifacthub.io/packages/helm/hertzbeat/hertzbeat），按页面指引执行 helm install 部署，Chart 会一次性安装 hertzbeat、collector、postgresql、tsdb 集群组件。

3. 访问验证

部署完成后访问 HertzBeat 服务，浏览器访问 http://localhost:1157 即可开始，默认账号密码 admin/hertzbeat。

使用与配置要点

• 部署后可按需扩展 collector 副本实现采集能力横向扩展。
• 采集器连接主服务通过 identity、mode (public or private)、manager-host、manager-port 参数配置，需保证 identity 唯一。

注意事项与常见问题

• Oracle、DB2 仍然必须使用 JVM 采集器安装包，因为它们依赖外置 JDBC 驱动。
• 如果没有在 ext-lib 中提供 JDBC 驱动，MySQL、MariaDB、OceanBase 可以直接使用内置查询引擎。

优缺点

• ✓ 一键部署集群组件
• ✓ 适配云原生环境
• ✕ 依赖 K8s 集群环境

出处

本方案挖掘自开源项目 apache/hertzbeat，方案内容与实施命令均来自其 README 原文。