Show HN: Hermes Agent 用 Grafana Agent Observability

grafana-agento11y-hermes Grafana Agent Observability プラグイン for 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 セットアップページからの認証情報について案内します。また、デフォルトでどのような会話データが流れるか、および有効にする前にどのように調整できるかについても説明します。 手動 pip install grafana-agento11y-hermes hermes が実行されているのと同じ Python 環境にインストールします (hermes の確認方法については、hermes を参照してください)。 その後、~/.hermes/config.yaml でプラグインを有効にします: plugins: enabled: - agento11y Hermes のプラグインは、まだ CLI で pip インストールされたプラグインを認識しません。~/.hermes/plugins/ およびバンドルされたディレクトリのみをスキャンします。YAML を直接編集するのが回避策です。 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 トークンを作成をクリックします。 環境変数としてコピーをクリックします。 そのブロックを 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_...">' 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。