Show HN: Hermes Agent 用 Grafana Agent Observability
Show HN: Grafana agent observability for Hermes Agent (github.com)
要約
Hermes Agent 向けの Grafana Agent Observability プラグインを紹介する投稿です。このプラグインは、LLM の呼び出しやツールの実行を記録し、OTel トレースとメトリクスとして出力します。インストール方法、設定手順、および Grafana Cloud での確認方法が詳細に説明されています。
全文翻訳
grafana-agento11y-hermes
[画像: Grafana Agent Observability UI]
Grafana Agent Observability プラグインを Hermes Agent 用に提供します。LLMの呼び出しとツールの実行をジェネレーションとして記録し、OTelトレースとメトリクスをエミットします。
インストール
推奨: エージェントに任せる
以下のテキストをHermes(またはURLを取得できるClaude / Codex / Cursor / 同様の他のエージェント)に貼り付けてください。
Install and configure the Grafana Agent Observability plugin for me by following
https://raw.githubusercontent.com/alexander-akhmetov/grafana-agento11y-hermes/main/llms.txt
エージェントが、pip install、~/.hermes/config.yaml の設定、および Agent Observability セットアップページからの認証情報の手順を案内します。また、デフォルトでどのような会話データが流れるか、そして何かを有効にする前にそれをどのように調整できるかについても説明します。
Grafana Cloud アカウントをお持ちでない場合は、https://grafana.com/auth/sign-up/create-user/ で作成してください。無料ティアで十分です。
手動
pip install grafana-agento11y-hermes
hermes が実行されているのと同じ Python 環境にインストールしてください(which hermes で確認)。その後、~/.hermes/config.yaml でプラグインを有効にします。
plugins:
enabled:
- agento11y
Hermes の
plugins enableCLI は、pip でインストールされたプラグインをまだ認識しません。~/.hermes/plugins/とバンドルされたディレクトリのみをスキャンします。YAML を直接編集するのが回避策です。hermes plugins listでもプラグインは表示されないため、Grafana Cloud でデータが到着しているか確認して動作を確認してください。
hermes-plugin-sigil からのアップグレード
パッケージ、モジュール、エントリーポイントキー、および環境変数はすべて名前が変更されました。
-
再インストール:
pip uninstall hermes-plugin-sigil pip install grafana-agento11y-hermesアンインストールが必要です。新しいパッケージは名前が異なるため、pip は古いパッケージと並べてインストールし、置き換えるのではなく両方がプラグインを登録してしまうため、アンインストールが必要です。
-
~/.hermes/config.yamlのキーをsigilからagento11yに変更します。古いキーは解決しなくなり、hermes はこの変更なしではプラグインをロードしません。 -
SIGIL_*環境変数をAGENTO11Y_*にリネームしてください。接尾辞は保持します(SIGIL_ENDPOINTはAGENTO11Y_ENDPOINTになります)。以下の「設定」のセットアップページで、新しい名前のブロックを取得できます。プラグインは現在も古い名前を読み取っており、リネームすべきものをログに記録するため、アップグレード時に即座に問題が発生することはありません。SDK自体はこれらを無視するため、SDKが修正されるとこのフォールバックはなくなります。
設定
すべては、スタック内の1つのページから行います。
https://<stack>.grafana.net/a/grafana-agento11y-app/setup
- Create token をクリックします。
- Copy as environment variables をクリックします。
- そのブロックを hermes が起動する環境に配置します。
代わりに ~/.hermes/.env に保持する場合、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 of "123456:glc_...">'
キャプチャモードが設定されていない場合、プラグインはフルコンテンツを記録するため、システムプロンプト、ツールの定義、プロンプト、アシスタントの応答、ツールの引数、ツールの結果がすべてマシンから送信されます。プロンプトやツールのI/Oをマシンから送信しないようにしながら、すべての呼び出しを記録し続けるには、AGENTO11Y_CONTENT_CAPTURE_MODE=metadata_only を設定してください。
検証
インタラクティブな hermes を使用します。ワンショットモード(-z オプション)は実行全体でロギングを無効にするため、以下の行は何も書き込まれません。
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。