ObservabilityOntology and AIP observabilityトレーシング

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

トレース表示

トレース表示では、ワークフローの実行を視覚的なタイムラインで確認でき、さまざまなサービスがどのように連携し、どこで時間がかかっているかを把握できます。具体的には、分散トレースとは、リクエストの生成からレスポンスの受信までのすべてのイベントで構成されるタイムラインです。これらのイベントは、プロセス、ネットワーク、セキュリティの境界をまたぐ場合があります。分散トレースは、アプリケーション内でリクエストがたどる経路を理解するうえで重要です。

必要な権限

トレースとサービスログを閲覧するには、管理者が該当するプロジェクトのログアクセスを有効にする必要があります。ユーザーは、過去24時間以内の自身の実行のログには常にアクセスできます。ただし、CBAC スタックでは、トレースとサービスログを閲覧するためにログアクセスを有効にする必要があります。

トレース表示の主要な要素

トレース表示を含む Workflow Lineage の例

  • タイムラインの可視化: 水平のバーで各操作の実行時間を示します。
  • サービス階層: ネストされたスパンで操作間の親子関係を示します。
  • リソースタイプ: 各スパンが関数、アクション、自動化、モデル、LLM 呼び出しのいずれから生成されたかを色分けで示します。
  • パフォーマンスメトリクス: 各スパンに実行時間が表示されます。

トレースの詳細を分析する

任意のスパンを選択すると、その操作のトレースログの詳細をすべて表示できます。

トレースの詳細には、次の情報が含まれます。

  • 操作名: 実行されている具体的な関数、アクション、言語モデル、自動化、モデル、または内部操作。
  • 実行時間: 操作の実行にかかった時間。
  • 入力/出力データ: 関数実行リクエストでは、操作に渡されたパラメーターと操作から返されたパラメーターを表示できます。
  • モデルのインタラクション: LLM 呼び出しでは、プロンプト、レスポンス、トークン使用量を表示できます。
  • エラー情報: 失敗した操作のスタックトレースとエラーメッセージ。
  • トレース識別子: テレメトリーの取得に使用される、Foundry が割り当てた識別子 foundryTraceId と、各サービスログエントリーのタグフィールドに含まれる標準の分散トレース識別子 x-b3-traceid(ベストエフォートで記録されるため、オントロジー SDK で構築されたアプリケーションなど、Foundry 外部で生成されたログには含まれない場合があります)。

トレースログの詳細を含む Workflow Lineage の例

関連機能

  • 実行履歴:トレースを詳しく調べる前に、最近の実行をすべて表示します。
  • サービスログ:各スパンの詳細なログメッセージにアクセスします。
  • パフォーマンス監視:トレースデータを分析して、最適化できる箇所を特定します。