Show HN：用于 Hermes Agent 的 Grafana Agent 可观测性

Hacker News Top 工具
grafana observability ai-agent llm open-telemetry plugin hermes-agent

摘要

这是一个 Grafana Agent 可观测性插件，专为 Hermes Agent 设计，可记录 LLM 调用和工具执行，并生成 OpenTelemetry 追踪与指标，以监控 AI 代理。

暂无内容
查看原文
查看缓存全文

缓存时间: 2026/08/16 12:43

alexander-akhmetov/grafana-agento11y-hermes

来源: https://github.com/alexander-akhmetov/grafana-agento11y-hermes

grafana-agento11y-hermes

PyPI (https://pypi.org/project/grafana-agento11y-hermes/)

Grafana Agent Observability UI
Grafana Agent Observability (https://grafana.com/docs/grafana-cloud/machine-learning/ai-observability/) 插件，适用于 Hermes Agent (https://github.com/NousResearch/hermes-agent)。
记录 LLM 调用和工具执行作为生成项，并发送 OTel 追踪 + 指标数据。

安装

推荐方式：让您的代理自动完成

将以下内容粘贴到 Hermes（或任何支持获取 URL 的 Claude / Codex / Cursor / 类似代理）中：

按照 https://raw.githubusercontent.com/alexander-akhmetov/grafana-agento11y-hermes/main/llms.txt 的指引，为我安装并配置 Grafana Agent Observability 插件

代理将引导您完成 pip 安装、~/.hermes/config.yaml 配置，以及从 Agent Observability 设置页面获取凭证的过程。同时还会说明默认会传输哪些对话数据，以及在启用前如何调整设置。

手动安装

pip install grafana-agento11y-hermes

安装到 hermes 运行所使用的同一 Python 环境中（可通过 which hermes 检查）。然后在 ~/.hermes/config.yaml 中启用插件：

plugins:  
  enabled:  
    - agento11y

目前 Hermes 的 plugins enable CLI 尚无法识别 pip 安装的插件。它仅扫描 ~/.hermes/plugins/ 和内置目录。直接编辑 YAML 文件是当前的解决方法。

从 hermes-plugin-sigil 升级

包名、模块名、入口点键名和环境变量均已全部重命名。

  1. 重新安装：
pip uninstall hermes-plugin-sigil  
pip install grafana-agento11y-hermes

必须先卸载旧包。新包名称不同，pip 会将其与旧包并列安装而非替换，否则两者都会注册为插件。
2. 将 ~/.hermes/config.yaml 中的键名从 sigil 更改为 agento11y。旧键名不再有效，hermes 将无法加载插件。
3. 将环境变量 SIGIL_* 重命名为 AGENTO11Y_*，保留后缀不变（例如 SIGIL_ENDPOINT 改为 AGENTO11Y_ENDPOINT）。下方的配置页面会提供包含新名称的配置块。插件暂时仍能识别旧名称，并会日志提示重命名信息，因此升级后不会立即中断功能。SDK 本身已忽略旧名称，待 SDK 修复后此兼容性处理将移除。

配置

所有配置来源于您 Grafana Cloud 堆栈中的一个页面：
https://<your-stack>.grafana.net/a/grafana-agento11y-app/setup

  1. 点击 Create token。
  2. 点击 Copy as environment variables。
  3. 将生成的配置块放入 hermes 的启动环境中。您将获得的配置块如下：
AGENTO11Y_ENDPOINT=https://agento11y-<...>.grafana.net  
AGENTO11Y_PROTOCOL=http  
AGENTO11Y_AUTH_MODE=basic  
AGENTO11Y_AUTH_TENANT_ID=123456  
AGENTO11Y_AUTH_TOKEN=glc_...  
OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp-gateway-<...>.grafana.net/otlp  
OTEL_EXPORTER_OTLP_HEADERS='Authorization=Basic <base64-token>'

如果您没有 Grafana Cloud 账号，请访问 https://grafana.com/auth/sign-up/create-user/ 创建。免费套餐即可满足需求。

验证

AGENTO11Y_DEBUG=true hermes

在 ~/.hermes/logs/agent.log 中应看到：

grafana-agento11y-hermes: installed TracerProvider with OTLP HTTP exporter  
grafana-agento11y-hermes: installed MeterProvider with OTLP HTTP exporter  
grafana-agento11y-hermes: client initialized (generations=configured, otel=configured)

向 hermes 提问任何问题，然后查看 Grafana Cloud -> Observability -> Agent -> Conversations。

许可证

Apache-2.0.

相似文章

@KanikaBK: https://x.com/KanikaBK/status/2053845110048293272

X AI KOLs Timeline

本文提供了一份逐步指南，用于安装和配置 Hermes Agent。Hermes Agent 是由 Nous Research 开发的一款开源、具备自我改进能力的 AI 智能体。内容涵盖系统要求、通过终端安装、连接 Telegram 等消息网关，以及与各大大型语言模型（LLM）服务商的集成。

NousResearch/hermes-agent

GitHub Trending (daily)

Hermes Agent 是由 Nous Research 推出的开源、自我进化 AI 智能体框架，具备闭环学习循环、跨平台部署能力，并兼容数百种大语言模型。它提供终端界面、持久化记忆、自动化调度以及用于扩展 AI 工作流的科研级工具。