显示 HN：Hermes Agent 的 Grafana Agent 可观测性

显示 HN：Hermes Agent 的 Grafana Agent 可观测性
Show HN: Grafana agent observability for Hermes Agent

原始链接: https://github.com/alexander-akhmetov/grafana-agento11y-hermes

Hermes 的 **Grafana Agent 可观测性插件**允许您通过直接向 Grafana Cloud 发送 OTel 追踪和指标，来跟踪大模型（LLM）调用和工具执行情况。 **设置说明：** 1. **自动安装：** 将提供的 URL（见文档）复制到您的 AI 代理（Claude、Cursor 等）中，由其处理安装和配置。 2. **手动安装：** - 在您的 Hermes 环境中运行 `pip install grafana-agento11y-hermes`。 - 更新 `~/.hermes/config.yaml`，将 `agento11y` 加入 `enabled` 插件列表。 3. **凭证：** 从 Grafana Cloud 的“Agent 可观测性”设置页面生成环境变量配置块，并将其添加到您的 Hermes 环境中。 **从 `hermes-plugin-sigil` 升级：** - 卸载旧包（`pip uninstall hermes-plugin-sigil`）。 - 将 `config.yaml` 中的键从 `sigil` 更新为 `agento11y`。 - 将所有环境变量名从 `SIGIL_*` 重命名为 `AGENTO11Y_*`。 **验证：** 在运行时设置 `AGENTO11Y_DEBUG=true` 来启动 Hermes。如果成功，日志将确认 Tracer 和 Meter 提供程序已初始化。随后，您即可通过 **Grafana Cloud AI 可观测性**仪表板监控您的对话数据。

Hacker News 最新 | 往期 | 评论 | 提问 | 展示 | 招聘 | 提交登录 Show HN: 用于 Hermes Agent 的 Grafana 代理可观测性 (github.com/alexander-akhmetov) 5 分 | eventuallyacat 发布于 3 小时前 | 隐藏 | 往期 | 收藏 | 讨论 | 帮助指南 | 常见问题 | 列表 | API | 安全 | 法律 | 申请 YC | 联系搜索:

原文

Grafana Agent Observability plugin for Hermes Agent. Records LLM calls and tool executions as generations and emits OTel traces + metrics.

Preferred: let your agent do it

Paste this into Hermes (or any Claude / Codex / Cursor / similar agent that can fetch URLs):

Install and configure the Grafana Agent Observability plugin for me by following
https://raw.githubusercontent.com/alexander-akhmetov/grafana-agento11y-hermes/main/llms.txt

The agent will walk you through pip install, ~/.hermes/config.yaml, and the credentials from the Agent Observability setup page. It will also explain what conversation data flows by default and how to tune it before turning anything on.

pip install grafana-agento11y-hermes

Install into the same Python environment hermes runs from (which hermes to check). Then enable the plugin in ~/.hermes/config.yaml:

plugins:
  enabled:
    - agento11y

Hermes's plugins enable CLI does not see pip-installed plugins yet. It only scans ~/.hermes/plugins/ and the bundled directory. Editing the YAML directly is the workaround.

Upgrading from hermes-plugin-sigil

The package, the module, the entry-point key and the env vars were all renamed.

Reinstall:

pip uninstall hermes-plugin-sigil
pip install grafana-agento11y-hermes

The uninstall is required. The new package has a different name, so pip installs it alongside the old one instead of replacing it, and both would register a plugin.

Change the key in ~/.hermes/config.yaml from sigil to agento11y. The old key no longer resolves, and hermes will not load the plugin without this.
Rename your SIGIL_* env vars to AGENTO11Y_*, keeping the suffix (SIGIL_ENDPOINT becomes AGENTO11Y_ENDPOINT). The setup page in Configure below gives you a fresh block with the new names. The plugin still reads the old names for now and logs what to rename, so nothing breaks the moment you upgrade. The SDK itself ignores them, so this fallback goes away once the SDK is fixed.

Everything comes from one page in your stack:

https://<stack>.grafana.net/a/grafana-agento11y-app/setup

Click Create token.
Click Copy as environment variables.
Put the block in the environment hermes starts from.

Create the token first.

The block you get:

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 of "123456:glc_...">'

If you do not have a Grafana Cloud account, create one at https://grafana.com/auth/sign-up/create-user/. The free tier is enough.

AGENTO11Y_DEBUG=true hermes

In ~/.hermes/logs/agent.log you should see:

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)

Ask hermes anything, then check Grafana Cloud -> Observability -> AI -> Conversations.

Apache-2.0.