SuperAPI AI 工具集

clickhouse-monitoring

部署与运维

查看项目

更新于 10-15 21:36

技能介绍

用途:为 ClickHouse Monitor 项目(ClickHouse 集群实时监控与可观测性仪表盘)提供开发所需的领域知识,适用于处理监控面板、分析查询性能数据以及扩展图表和表格页面。

主要能力:仪表盘覆盖系统概览、运行中查询、数据库结构浏览器、合并操作、集群与 ZooKeeper 状态;查询监控包括历史查询、失败查询、昂贵查询、查询缓存、线程与并行度分析;表管理包括数据浏览器、表概览、副本、复制队列、投影、物化视图刷新、分区信息、字典;合并监控包括合并、变异、性能趋势与新分区创建;系统指标包括 Metrics、Async Metrics、磁盘与设置;安全与日志包括会话、登录尝试、审计日志、文本日志、堆栈跟踪与崩溃报告。

使用方式:该面板为纯静态站点,客户端通过 SWR 拉取数据,路由使用查询参数区分多主机(如 /overview?host=0)。多主机通过逗号分隔的环境变量配置,如 CLICKHOUSE_HOST=prod.example.com,staging.example.com,配合 CLICKHOUSE_USER、CLICKHOUSE_PASSWORD、CLICKHOUSE_NAME,访问时用 ?host=0、?host=1。图表接口为 GET /api/v1/charts/{chartName},表格接口为 GET /api/v1/tables/{queryConfigName},结构浏览接口为 /api/v1/explorer/...。新增图表需在 lib/api/charts/ 定义查询构建器并注册到 chartRegistry,再创建使用 useChartData 的客户端组件。

适用场景:开发或维护该监控仪表盘,增加图表、表格视图与 API 端点,排查监控数据为空、表不存在或多主机配置异常等问题。

限制:依赖 ClickHouse 系统日志表(如 query_log、metric_log、part_log)是否启用;不同版本系统表结构有差异,需使用版本感知查询;部分表(backup_log、error_log、zookeeper、monitoring_events)为可选。本文档同步自主仓库,具体版本与部署细节暂未提供。