GitHub - alexander-akhmetov/grafana-agento11y-hermes: Unofficial Grafana Agent Observability plugin for Hermes Agent · GitHub
/" data-turbo-transient="true" />
Skip to content
Search/
Sign in<br>Sign upAppearance settings
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
alexander-akhmetov
grafana-agento11y-hermes
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>39 Commits<br>39 Commits
.github
.github
scripts
scripts
src/grafana_agento11y_hermes
src/grafana_agento11y_hermes
tests
tests
.gitignore
.gitignore
CHANGELOG.md
CHANGELOG.md
CLAUDE.md
CLAUDE.md
LICENSE
LICENSE
Makefile
Makefile
README.md
README.md
img.png
img.png
llms.txt
llms.txt
plugin.yaml
plugin.yaml
pyproject.toml
pyproject.toml
uv.lock
uv.lock
View all files
Repository files navigation
grafana-agento11y-hermes
Grafana Agent Observability plugin for Hermes Agent. Records LLM calls and tool executions as generations and emits OTel traces + metrics.
Install
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<br>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.
Manual
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:<br>enabled:<br>- 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<br>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.
Configure
Everything comes from one page in your stack:
https://.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:
.grafana.net<br>AGENTO11Y_PROTOCOL=http<br>AGENTO11Y_AUTH_MODE=basic<br>AGENTO11Y_AUTH_TENANT_ID=123456<br>AGENTO11Y_AUTH_TOKEN=glc_...<br>OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp-gateway-.grafana.net/otlp<br>OTEL_EXPORTER_OTLP_HEADERS='Authorization=Basic '">AGENTO11Y_ENDPOINT=https://agento11y-...>.grafana.net<br>AGENTO11Y_PROTOCOL=http<br>AGENTO11Y_AUTH_MODE=basic<br>AGENTO11Y_AUTH_TENANT_ID=123456<br>AGENTO11Y_AUTH_TOKEN=glc_...<br>OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp-gateway-...>.grafana.net/otlp<br>OTEL_EXPORTER_OTLP_HEADERS='Authorization=Basic '
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.
Verify
AGENTO11Y_DEBUG=true hermes
In ~/.hermes/logs/agent.log you should see:
grafana-agento11y-hermes: installed TracerProvider with OTLP HTTP exporter<br>grafana-agento11y-hermes: installed MeterProvider with OTLP HTTP exporter<br>grafana-agento11y-hermes: client initialized (generations=configured, otel=configured)
Ask hermes anything, then check Grafana Cloud -> Observability -> AI -> Conversations .
License
Apache-2.0.
About<br>Unofficial Grafana Agent Observability plugin for Hermes Agent<br>grafana.com/docs/grafana-cloud/observe-and-act/agent-observability/<br>Topics<br>aiai-agentgrafanahermeshermes-agent<br>Resources<br>Readme<br>Apache-2.0 license<br>Activity<br>Stars<br>6 stars<br>Watchers<br>0 watching<br>Forks<br>1 fork<br>Report repository
Releases
Used by
Contributors
Languages
You can’t perform that action at this time.