Note
トレーシングは現在プレビュー版です。
このクイック スタートでは、「最初のホストされたエージェントをデプロイする」でデプロイしたホストされたエージェントのエンド ツー エンドトレース を表示します。 エージェントを呼び出してトレース データを生成し、Foundry ポータルでトレースを確認します。
ホスティング ライブラリ (azure-ai-agentserver-responsesとazure-ai-agentserver-invocations) は、Microsoft Agent Framework と LangChain にすぐに使用できるインストルメンテーションを提供する Microsoft OpenTelemetry ディストリビューションをスムーズに統合し、トレースを Application Insights にエクスポートします。 さらに、Foundry Agent Service はエージェント呼び出し用のサーバー側テレメトリを自動的に出力します。コードの変更は必要ありません。
トレースを使用すると、エージェントが各要求をどのように処理するかを把握できるため、ユーザーに変更をリリースする前に、問題のデバッグ、待機時間の監視、エージェントの動作の把握を行うことができます。
前提条件
開始する前に、次のものが必要です。
デプロイされた、呼び出し可能なホスト型エージェント 。 最初のホストされたエージェントをデプロイし、そのクイック スタートで作成した
azdプロジェクト ディレクトリをデプロイします。Foundry リソースの Foundry User ロール。
UI パスを使用するには、 Foundry ポータルにアクセスします。 azd パスについては、次の要件を参照してください。
Azure Developer CLI (azd) 1.27.1 以降で、
azd microsoft.foundry拡張機能を使用します。azd ext install microsoft.foundry認証された
azdセッション。azd auth statusで状態を確認し、サインインしていない場合はazd auth loginを実行します。Important
Foundry RBAC ロールの名前が最近変更されました。 Foundry User, Foundry Owner, Foundry Account Owner、および Foundry Project Manager は、以前は、AZURE AI ユーザー、Azure AI 所有者、Azure AI アカウント所有者、および AZURE AI Project Manager という名前でした。 名前の変更がロールアウトされている間、以前の名前が表示される場合があります。ロール ID とコア アクセス許可は、名前の変更によって変更されません。
Foundry プロジェクトに接続されている Azure Monitor Application Insights リソース。 設定するには、「 Microsoft Foundry でトレースを設定する」を参照してください。
プロジェクトに接続されている Application Insights リソースのLog Analytics 閲覧者ロール。 基になるLog Analytics テーブルが保護されている場合は、特権監視データ閲覧者ロールも割り当てます。
手順 1: エージェントを呼び出す
デプロイされたエージェントに要求を送信して、トレース データを生成します。
azd プロジェクト ディレクトリから、テスト プロンプトを送信します。
azd ai agent invoke "Summarize the benefits of distributed tracing for AI agents."
数秒以内に応答が表示されます。
呼び出しごとに完全なトレースが生成されます。 トレースが充実している場合は、ツールの呼び出しまたは複数ターンの推論をトリガーするプロンプトを送信します。
手順 2: Foundry ポータルでトレースを表示する
トレースは、呼び出し後に Foundry ポータルで表示できます。
- Foundry ポータルで、プロジェクトを開きます。
- 左側のナビゲーションで、[エージェント] を選択 します。
- 上部にある [トレース] を選択 します。
- リストの中から自分の記録を探してください。 トレース ID、応答 ID、または時間範囲でフィルターで検索できます。
軌道
ユーザー ビュー
Tip
エージェントが Microsoft Agent Framework を使用している場合は、独自の OpenTelemetry スパンが自動的に出力されます。 これらのスパンは、ホスティング レイヤースパンの子として表示され、エージェント オーケストレーションを通じて HTTP 要求から個々のツール呼び出しと LLM の対話まで、完全なトレース ツリーを提供します。
リソースをクリーンアップする
トレース データは Application Insights に格納され、ワークスペースのデータ保持設定に従います。 このクイック スタートでは、追加のリソースは作成されません。 前のクイック スタートをクリーンアップするには、エージェント プロジェクト ディレクトリから azd down を実行します。 コマンドによって削除される内容は、初期化が Foundry プロジェクトを作成したか再利用したかによって異なります。
Warning
現在の azd 環境で Foundry プロジェクトが作成された場合、 azd down はプロジェクトのリソース グループとその中のすべてのリソース グループを完全に削除します。 初期化中に既存のプロジェクトを選択した場合、 azd down はプロジェクト、そのリソース グループ、ホストされているエージェント、およびその他のクイック スタート リソースはそのまま残ります。 既存のプロジェクトから不要になったリソースを削除するには、それらを個別に削除します。
Troubleshooting
| Issue | ソリューション |
|---|---|
| Foundry でホストされるエージェントを使用しておらず、トレースが表示されない | このクイック スタートでは、ホストされているエージェントについて説明します。 Foundry の外部でホストされているトレース エージェントについては、「 外部エージェントの登録」を参照してください。 |
| エージェントの呼び出し後にトレースが表示されない | Application Insights が Foundry プロジェクトに接続されていることを確認します。 有効になっていない場合は、「Microsoft Foundry でトレースを設定する」を参照してください。 エージェントが azd ai agent invokeで正常に応答したことを確認します。 |
| トレースが表示されますが、スパンに入力/出力データ属性がありません | エージェント構成で環境変数 OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true を設定して、コンテンツの記録を有効にします。 |
AuthorizationFailed トレースを表示する場合 |
Application Insights リソースのLog Analytics閲覧者ロールが必要です。 テーブルが 保護されている場合は、 Privileged Monitoring Data Reader も割り当てます。 |
| トレースは表示されますが、ツール呼び出しスパンがありません | エージェントがツールを定義し、モデルが要求中にそれらを呼び出すかどうかを確認します。 Microsoft Agent Framework を使用している場合は、Agent パラメーターを使用して、ツールが tools コンストラクターに登録されていることを確認します。
「エージェントにツールを追加する」を参照してください。 |
AuthenticationError または DefaultAzureCredential エラー |
azd auth logoutを使用して資格情報を更新し、azd auth loginします。 |
学習した内容
このクイック スタートでは、次の操作を行います。
- ホスティング ライブラリが、すぐに使用できるインストルメンテーション用の Microsoft OpenTelemetry ディストリビューションを統合することを学習しました。
- デプロイされたエージェントを呼び出してトレース データを生成します。
- Foundry ポータルでエンド ツー エンドトレースを表示しました。
次のステップ
- 詳細なトレース構成のために、Microsoft Foundry でトレースを設定します。
- LangChain やその他のフレームワークをインストルメント化するために、AI エージェント フレームワークのトレースを構成します。
- 運用監視用のエージェント監視ダッシュボードを使用して AI エージェントを監視します。