从PromQL到Categraf指标：Grafana面板与告警规则迁移实战指南

从PromQL到Categraf指标：Grafana面板与告警规则迁移实战指南

当监控系统从Prometheus原生采集切换到Categraf作为统一采集器后，许多工程师会遇到一个典型困境：数据管道已经打通，但在Grafana中却不知道如何基于这些新指标构建有效的监控视图。本文将带您完成从指标探查到可视化落地的完整迁移过程，解决"数据在手却不会用"的实操难题。

1. Categraf指标体系解析

1.1 指标命名空间特征

与Prometheus原生指标不同，Categraf采集的指标具有独特的命名规则：

• 采用measurement_field格式（如mem_used）
• 自动附加agent_hostname标签标识来源主机
• 数值类型统一为浮点数（包括整数场景）

通过命令行工具探查指标结构：

./categraf --test --inputs mem # 典型输出示例 12:01:43 mem_used agent_hostname=node1 667467776 12:01:43 mem_commit_limit agent_hostname=node1 3063525376

1.2 核心指标对照表

注意：部分指标需要单位换算，特别是CPU和磁盘IO类指标通常需要额外计算

2. 查询语句转换技巧

2.1 基础查询转换

将PromQL转换为Categraf兼容查询时需注意：

# 原PromQL rate(node_cpu_seconds_total{mode="user"}[5m]) # 转换后 rate(cpu_usage_user[5m]) * 100

2.2 标签操作特殊处理

Categraf指标默认携带agent_hostname标签，但缺少instance标签。在Grafana中使用时需要重命名：

# 在Grafana变量查询中使用 label_values(mem_used, agent_hostname) # 面板中使用标签过滤器 {agent_hostname=~"$host"}

3. Grafana面板迁移实战

3.1 内存监控面板改造

原始Prometheus内存面板通常包含这些元素：

1. 内存使用量时序图
2. 内存使用百分比仪表盘
3. SWAP空间监控

转换后的Categraf查询示例：

# 内存使用量 mem_used{agent_hostname=~"$host"} # 内存使用率 (mem_used / mem_total) * 100 # SWAP空间使用 (swap_used / swap_total) * 100

3.2 磁盘监控最佳实践

Categraf的磁盘指标需要特别注意设备筛选：

# 各磁盘使用率 disk_used{agent_hostname=~"$host", device=~"sd.*"} / disk_total * 100 # IO负载计算 rate(diskio_read_bytes[5m]) / 1024 / 1024 # MB/s

4. 告警规则迁移指南

4.1 阈值规则转换对照

4.2 告警规则优化建议

1. 为关键业务指标添加for持续时间
2. 使用max_over_time平滑瞬时波动
3. 添加severity标签分级管理

# 示例告警规则 - alert: HighMemoryUsage expr: (mem_used / mem_total) * 100 > 90 for: 5m labels: severity: critical annotations: summary: "High memory usage on {{ $labels.agent_hostname }}"

5. 高级调试技巧

5.1 指标探查方法进阶

# 查看所有可用输入插件 ls conf/input.* # 测试特定插件的指标输出 ./categraf --test --inputs disk --debug

5.2 性能优化配置

在config.toml中调整这些参数可提升采集效率：

[global] interval = 15 # 采集间隔(秒) precision = "ms" # 时间戳精度 [writer_opt] batch = 2000 # 每次推送数据批大小 timeout = "10s" # 写入超时时间

实际迁移过程中发现，Categraf的processes插件能提供比Prometheus更详细的进程级监控，但需要特别注意指标命名差异。例如进程CPU使用率指标在Categraf中表现为process_cpu_usage而非Prometheus的process_cpu_seconds_total。