
前提条件
Weave エクスポーター が認証を行い、トレースを正しい project に送信できるように、エージェントを実行する前に次の環境変数を設定する必要があります。[YOUR-API-KEY] は Weave APIキーに、[YOUR-ENTITY] は W&B のチーム名または entity 名に置き換えてください。WEAVE_PROJECT_NAME には任意のプロジェクト名を指定できます。Weave は初回使用時に project を作成します。
Koog をインストールする (Gradle)
環境変数を設定したら、Koog を Kotlin プロジェクトに追加します。これにより、エージェントとそのエクスポーターを設定できるようになります (Kotlin DSL の例を使用) :Weave エクスポートを有効にする (OpenTelemetry)
Koog をインストールしたら、Koog の OpenTelemetry 機能をインストールし、Weave エクスポーターを追加します。これにより、Koog のスパンが Weave の OpenTelemetry エンドポイントを介して Weave トレースにマッピングされます。 次の例は、addWeaveExporter の使い方を示しています。
weaveEntityとweaveProjectNameを使用して、トレースを特定のチームとプロジェクトにルーティングします。weaveOtelBaseUrlをトレースのエンドポイント (例:https://[YOUR-SUBDOMAIN].wandb.io/[PATH]) に設定します。専用の Weave インスタンスでは、このパラメーターを使用してください。
- エクスポーターの詳細については、Koog の Weave exporter ガイド
- OpenTelemetry が Koog とどのように連携するかの基本概念については、Koog の OpenTelemetry サポートガイド
- Weave が OTLP データをどのように取り込むかについては、Weave OTEL ドキュメント
トレースされる内容
エクスポーターを有効にしてエージェントを実行すると、Koog はトレースを Weave プロジェクトに転送します。Koog の Weave エクスポーター は、Koog の一般的な OTEL インテグレーションと同じスパンをキャプチャします。これには次が含まれます。- エージェントのライフサイクルイベント (開始、停止、エラー)
- LLM とのやり取り (プロンプト、コンプリーション、token 使用量、レイテンシ)
- ツールおよび API の call (function call と外部リクエスト)
- システムコンテキスト (モデル名、Koog バージョン、環境メタデータ)
サンプルノートブック
Weave にトレースをストリーミングする実行可能なノートブックについては、Koog のドキュメントを参照してください。トラブルシューティング
Koog エージェントが想定どおりにトレースをエクスポートしない場合は、次を確認してください。- トレースが表示されない場合は、まず
WEAVE_API_KEY、WEAVE_ENTITY、WEAVE_PROJECT_NAMEが正しく設定されていることを確認してください。 - お使いの環境から
https://trace.wandb.aiにアクセスできること、およびエクスポーターが前述の例で示したとおりに設定されていることを確認してください。 - 追加のトラブルシューティングとサンプリングのガイダンスについては、Koog の OpenTelemetry サポート を参照してください。