全栈可观测平台
全栈可观测平台
文档指南
请输入
- 文档首页
全栈可观测平台实践与教程AI Agent 观测实践Hermes Agent 链路监控
复制全文
下载 pdfHermes Agent 链路监控
文档反馈
问问助手Hermes Agent 是面向大模型智能体场景的核心运行组件，支持自然语言解析、智能任务拆解、大模型推理及外部工具调度能力。可通过多轮自主思考与闭环执行，自动化完成各类复杂业务任务，为智能问答、自动化运维、智能分析等 AI 应用提供基础运行能力。本文为您详细介绍如何将 Hermes 的观测数据接入 APMPlus，让 Hermes Agent 每一次执行都能被看见、被衡量、被复盘。
背景信息
APMPlus Hermes 插件主要用于采集 Hermes Agent 的对话记录、模型调用记录、工具调用记录、运行日志及各类核心指标，实现 Agent 执行链路的全量可观测，彻底解决智能体执行过程的黑盒问题。
该插件无需改造现有 Agent 业务逻辑，接入成本极低。完成接入后，用户可在 APMPlus 平台完整观测单轮请求的全生命周期链路，涵盖用户输入、大模型调用、外部工具执行到最终结果输出的全流程。同时支持持续监控各类核心运行数据，包括 Token 消耗量、模型推理耗时、工具调用耗时、响应数据体量及端到端整体耗时等关键指标。
前提条件
已经获取 Hermes 接入所需参数配置中的信息。详细参数和获取方法如下：
参数 | 是否必选 | 说明 |
--region <region> | 是 | |
--appkey <appkey> | 是 | 应用性能监控的认证信息。虽然认证信息 App Key 不区分接入的服务类型和数据采集方式，但不同工作区的认证信息 App Key 各不相同，获取方式参考：如何获取应用性能监控的认证信息 AppKey。 |
--service-name <name> | 是 | 服务名称，例如：hermes-agent。服务在应用性能监控中的显示名称，可根据实际情况自定义。 |
--version <version> | 否 | 安装指定插件版本。默认 latest，支持 0.1.0 或 v0.1.0。 |
--non-interactive | 否 | 非交互模式。首次安装或改配置时需同时传 --region、--appkey 和 --service-name。 |
--config-only | 否 | 只更新 Hermes 配置，不更新插件文件。 |
--uninstall | 否 | 卸载插件并清理 Hermes 配置，不卸载 Python 依赖。 |
--help | 否 | 查看脚本帮助。 |
操作步骤
步骤一：Hermes 接入
- 本文提供 3 种 Hermes 接入方式，可根据实际场景，选择合适的接入方式。
- 执行以下命令，一键安装 apmplus-hermes-plugin 插件，并根据操作指引，完成配置。curl -fsSL "https://apmplus-hermes-plugin.tos-cn-beijing.volces.com/install.sh" | bash通过对话方式，直接将 apmplus-hermes-plugin 插件安装和配置信息发送给 Hermes，让其自动完成安装和配置流程。参考话术如下：使用以下命令为我安装 apmplus-hermes-plugin 并配置。region 是 cn-beijing，appkey 是 xxxxxxxxx，service name 使用 hermes-agent。curl -fsSL "https://apmplus-hermes-plugin.tos-cn-beijing.volces.com/install.sh" \| bash -s -- --non-interactive --region cn-beijing --appkey xxxxxxxxx --service-name hermes-agent直接通过脚本和自动传参方式，安装并配置 apmplus-hermes-plugin 插件。适用于非交互模式，例如：CI 环境、自动化环境等。curl -fsSL "https://apmplus-hermes-plugin.tos-cn-beijing.volces.com/install.sh" \| bash -s -- --non-interactive --region cn-beijing --appkey xxxxxxxxx --service-name hermes-agent
- 安装完成后，需要手动重启 Hermes，确保插件正常运作。不同环境的重启方式各不相同，具体操作如下：
- 若使用 Hermes Gateway，手动执行 hermes gateway restart 命令，使插件生效。
- 若使用命令行，退出当前会话，并使用新会话执行 hermes 命令即可。
- 执行以下命令，检查插件状态。若插件列表中包含 apmplus_hermes_plugin 且其状态为 enabled，表示接入成功。
- hermes plugins list
-
步骤二：查看可观测数据
通过 WebUI 或其他方式与 Hermes 进行交互。对话完成后，可前往 APMPlus 控制台查看观测数据。
- 前往 服务列表，可通过服务名搜索已经接入的 Hermes。
-
- 单击服务名称，进入服务详情页，在 Trace 分析 页面查看 Hermes 服务对应的 Span 列表。
-
- 单击目标 Trace ID，切换到 LLM 数据或属性页签，可查看本次请求的详细信息，例如：请求链路详情、请求模型、Token 消耗，以及 LLM、tool、agent turn 的耗时和 Token 消耗等。
-
- 切换到 Trace 完整日志 页签，可查看 Hermes 运行过程的详细日志。
-
后续操作
- 前往 预置看板，选择 Hermes 观测大盘，可查看 APMPlus 针对 Hermes 提供的预置看板。
说明
-
- 前往 告警任务，单击 新建告警任务，可根据实际情况为 Hermes 可观测指标配置自动化告警监控，例如：Token 消耗、会话卡顿、LLM 耗时、Tool 耗时、Agent turn 耗时和错误调用等。配置告警任务可以监测目标服务的配置项指标的异常情况，并及时收到通知，帮助您及时关注 Hermes 的运行状况。
说明
- 针对 apmplus-hermes-plugin 插件提供以下管理操作。
- 重新执行插件安装命令，完成后重启 Hermes，即可更新插件。
- 已经安装过插件，默认只更新插件本身，并保留已有的 region、appkey、service name 等配置。执行以下命令：
- curl -fsSL "https://apmplus-hermes-plugin.tos-cn-beijing.volces.com/install.sh" | bash
- 若期望将插件更新到指定版本，例如：0.1.0 版本，执行以下命令：
- curl -fsSL "https://apmplus-hermes-plugin.tos-cn-beijing.volces.com/install.sh" \| bash -s -- --version 0.1.0
- 如需修改上报配置，无需更新插件文件，执行以下命令：
- curl -fsSL "https://apmplus-hermes-plugin.tos-cn-beijing.volces.com/install.sh" \| bash -s -- --config-only --region cn-beijing --appkey xxxxxxxxx --service-name hermes-agent
- 如需更新插件并覆盖配置，执行以下命令：
- curl -fsSL "https://apmplus-hermes-plugin.tos-cn-beijing.volces.com/install.sh" \| bash -s -- --region cn-beijing --appkey xxxxxxxxx --service-name hermes-agent
如需卸载 apmplus-hermes-plugin 插件，可执行以下命令，并在完成后重启 Hermes。注意- 卸载操作将删除插件目录，并从 Hermes 配置中移除 plugins.enabled、plugins.disabled 中的插件名和 apmplus_hermes_plugin 配置。
- Python 依赖可能被其他插件复用，不会被卸载。
curl -fsSL "https://apmplus-hermes-plugin.tos-cn-beijing.volces.com/install.sh" \| bash -s -- --uninstall- 关闭输入输出正文采集。敏感字段默认会做脱敏，关闭后，常见的 Token、Password、Secret、Authorization、api_key 等字段不会直接明文暴露。
- apmplus_hermes_plugin:trace_content: false
- 关闭日志或指标采集。默认开启，可根据实际需求关闭日志或指标采集。
- apmplus_hermes_plugin:logs: falsemetrics: false
最近更新时间：2026.06.24 11:21:59
这个页面对您有帮助吗？
有用
有用
无用
无用