HermesAgentGrafana配置教程详解

本文详细介绍了如何在Grafana中完整配置Hermes Agent的监控可视化体系——从正确添加Prometheus数据源、一键导入专属仪表板（ID 18608），到手动编写精准PromQL查询构建核心性能图表（如请求成功率、首Token响应P50、GPU缓存使用率等），再到通过实例变量实现多部署环境下的动态筛选，最后整合自动刷新与告警状态面板，形成一套开箱即用、可定制、可观测、可告警的MLOps实时监控闭环，助你快速掌握Hermes Agent运行健康度，让大模型服务的稳定性一目了然。

如果您已通过Prometheus成功采集Hermes Agent的指标数据，但Grafana中尚未展示可视化图表，则可能是由于数据源未正确配置或面板未导入。以下是完成Grafana展示Hermes Agent监控数据的具体操作步骤：

一、添加Prometheus为Grafana数据源

该步骤确保Grafana能从Prometheus拉取Hermes Agent暴露的实时指标。必须准确填写Prometheus服务地址，并验证连通性。

1、打开浏览器，访问Grafana Web界面（默认地址为http://localhost:3000）。

2、使用管理员账号登录后，点击左侧导航栏的Configuration → Data Sources。

3、点击Add data source按钮，在搜索框中输入“Prometheus”并选择对应选项。

4、在HTTP设置区域的URL字段中填入Prometheus服务地址，例如：http://localhost:9090（若Prometheus运行在其他主机，请替换为实际IP与端口）。

5、向下滚动至底部，点击Save & Test；页面显示Data source is working即表示连接成功。

二、导入适配Hermes Agent的Grafana面板

直接使用通用Docker或Kubernetes面板无法准确映射Hermes Agent特有的指标命名与语义，需导入专为vLLM及Hermes MLOps模块设计的仪表板模板。

1、在Grafana首页左侧菜单中，点击Dashboards → Import。

2、在导入界面，选择以下任一方式之一：

　　a、粘贴面板ID：输入18608（该ID对应社区维护的vLLM专用Dashboard，兼容Hermes Agent指标路径）；

　　b、上传JSON文件：从Grafana Dashboards网站下载ID为18608的JSON文件，点击Upload .json file按钮上传；

3、在Import Settings区域，确认Data source下拉菜单中已选中上一步配置的Prometheus数据源。

4、点击Import按钮，等待面板加载完成。

三、手动创建关键指标图表

当预置面板不完全匹配当前部署的指标路径或需定制化视图时，可直接在Grafana中新建Panel并编写PromQL查询语句，确保指标语义与Hermes Agent实际暴露一致。

1、进入任意已有Dashboard，点击Add panel → Add new panel。

2、在Query编辑区，将Query Type设为Prometheus，并确认Data source已指向正确的Prometheus实例。

3、在Expression输入框中，逐条输入以下核心指标PromQL表达式（每条对应一个独立图表）：

　　a、请求成功率：rate(vllm_request_success_total[5m])；

　　b、首Token响应时间P50：histogram_quantile(0.5, vllm_time_to_first_token_seconds_bucket)；

　　c、GPU缓存使用率：vllm_gpu_cache_usage_perc；

　　d、活跃请求数：vllm_num_requests_running。

4、为每个图表设置合适的标题（如“首Token响应时间P50（秒）”）、单位（Seconds / Percent / Count）和显示样式（Time series或Stat）。

5、点击右上角Apply保存该Panel。

四、配置面板变量实现动态筛选

当Hermes Agent部署多个实例或启用多模型服务时，需通过Grafana变量支持按实例、模型名称等维度动态切换视图，避免重复创建多个面板。

1、进入目标Dashboard，点击右上角Settings（齿轮图标）→ Variables → Add variable。

2、设置Name为instance，Label为Instance，Type选择Query。

3、在Query字段中输入PromQL：label_values(vllm_request_success_total, instance)（确保Hermes Agent指标已打上instance标签）。

4、勾选Multi-value与Include All option以支持多选与全选。

5、在各Panel的Query表达式中，将target替换为变量引用，例如：vllm_request_success_total{instance=~"$instance"}。

6、点击Update保存变量配置。

五、启用自动刷新与告警面板联动

持续可观测要求面板具备实时更新能力，并与Alertmanager告警状态同步显示，便于快速响应异常。

1、在Dashboard右上角时间范围选择器旁，点击Refresh every下拉菜单，选择10s或30s刷新间隔。

2、点击Add panel → Add new panel，选择Visualization类型为State timeline或Status history。

3、在Query中输入Alertmanager相关指标，例如：ALERTS{alertstate="firing", job="hermes-agent"}。

4、设置Legend格式为{{alertname}} on {{instance}}，启用Color mode为Background。

5、点击Apply完成告警状态面板添加。

好了，本文到此结束，带大家了解了《HermesAgentGrafana配置教程详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多科技周边知识！