需配置prometheus数据源、导入hermes专用仪表板（id 18608）、手动创建核心指标图表、添加实例变量实现动态筛选，并启用自动刷新与告警联动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已通过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完成告警状态面板添加。
