若grafana无法展示hermes agent监控数据，需依次检查：一、确认prometheus已抓取hermes_前缀指标；二、用stat面板展示uptime等关键状态；三、用time series绘制rate(hermes_pipeline_processed_total[5m])趋势；四、用bar gauge对比各pipeline backlog；五、用text面板添加部署说明。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署Hermes Agent并将其指标暴露于Prometheus可采集端点，但Grafana中无法正确展示相关监控数据，则可能是由于数据源未正确关联、查询语句不匹配或面板类型不适配所致。以下是配置Grafana面板以展示Hermes Agent监控数据的具体步骤：
一、确认Prometheus数据源已接入Hermes Agent指标
需确保Prometheus已成功抓取Hermes Agent暴露的/metrics端点，并在Prometheus Graph界面可查到以hermes_为前缀的指标（如hermes_agent_uptime_seconds、hermes_pipeline_processed_total等）。该步骤是后续所有面板配置的前提。
1、登录Prometheus Web界面，在Graph页输入hermes_agent_uptime_seconds并执行查询。
2、确认返回非空时间序列，且样本值随时间递增或变化。
3、若无结果，检查Prometheus配置文件中是否添加了对应job，目标地址格式应为http://<hermes-agent-host>:<port>/metrics</port></hermes-agent-host>。
4、重启Prometheus服务使配置生效。
二、创建Stat面板展示关键状态值
Stat面板适用于高亮单个核心指标，例如Agent运行时长、当前活跃Pipeline数或最近处理消息总数，适合放置在仪表盘顶部作为概览区域。
1、在Grafana Dashboard中点击“+”→“Add new panel”，选择Stat类型。
2、在Query选项卡中，数据源选择已配置的Prometheus实例。
3、在Metrics字段输入查询语句：hermes_agent_uptime_seconds。
4、在Options选项卡中，将Text mode设为“Value and name”，Color mode设为“Background”，并设置阈值：0–3600显示红色，3600–86400显示黄色，>86400显示绿色。
5、在Panel title栏填写“Agent运行时长”，点击Apply保存。
三、使用Time series面板绘制消息处理趋势
Time series面板能直观呈现指标随时间变化的趋势，适用于展示每秒消息处理量、延迟P95、错误率等连续型监控信号。
1、新增一个Time series面板。
2、在Query中输入：rate(hermes_pipeline_processed_total[5m])，用于计算过去5分钟平均每秒处理消息数。
3、为多Pipeline实例添加Legend，使用{{pipeline}}作为显示标签。
4、在Display选项卡中启用Stacking，并将Y轴单位设为“ops/s”。
5、调整X轴时间范围为Last 6 hours，确保趋势具备可观测性。
四、配置Bar gauge面板对比各Pipeline负载
Bar gauge适用于横向对比多个同类型实体的数值大小，例如不同Pipeline的当前积压消息数（backlog）或平均处理耗时，便于快速识别瓶颈节点。
1、新增Bar gauge面板。
2、Query中输入：hermes_pipeline_backlog{job="hermes-agent"}。
3、在Options中将Orientation设为“Horizontal”，Display mode设为“Gradient”，Min值设为0，Max值设为自动（Auto）。
4、勾选“Show all values”，并在Value options → Decimals中设为0，避免小数干扰视觉判断。
5、在Legend字段填写{{pipeline}}，确保每个条形对应唯一Pipeline名称。
五、添加Text面板说明Hermes Agent部署拓扑
Text面板不依赖查询，可用于嵌入静态说明、部署版本信息或告警联系人，增强仪表盘可维护性与上下文完整性。
1、新增Text面板，选择Mode为“Markdown”。
2、在Content区域输入以下内容：
```markdown
**Hermes Agent 部署说明**
- 当前版本：v1.8.3
- 所属集群：kafka-prod-east
- 核心组件：Kafka Producer + Schema Registry Client + Metrics Exporter
- 告警通道：企业微信 @SRE-Messaging
```
