トレース¶

トレースタブでは、テキスト生成、エージェントワークフロー、VDB、MCPなどのカスタムモデルまたは外部モデルのデプロイから、トレースを確認できます。 各トレースには、スパンリストとタイムラインが組み合わされたものが含まれ、モデルまたはエージェントによって実行されたアクションの順序と所要時間が示されます。 デプロイのトレースでは、アプリケーションのトレースと同じインターフェイスが使用されます。

トレースにアクセスするには、デプロイインベントリからデプロイを選択し、トレースタブをクリックします。

トレースは、モデルまたはエージェントのワークフローに対するリクエストがたどった経路を表します。 DataRobotでは、トレースにOpenTelemetryフレームワークを使用しています。 トレースは、起点から解決まで、リクエストのエンドツーエンドの経路全体を追跡します。 各トレースには、ルートスパンから始まる1つ以上のスパンが含まれます。 ルートスパンはリクエストの経路全体を表し、プロセスの各ステップの子スパンが含まれます。 ルート（または親）スパンと各子スパンは、同じトレースIDを共有します。

組織の保持期間設定を確認または変更するには、OTelの保持期間の設定を参照してください。

トレースは、ルートスパン名ごとにリストに表示されます。 各エントリーには、トレースのステータスとタイムスタンプが表示されます。 トレースを選択すると、詳細ペインが開き、リクエストの概要メタデータ、および統合されたスパンリストとタイムラインが表示されます。

リクエストに応じて、リストおよび詳細ペインには以下のフィールドが含まれる場合があります。

トレースの検索とフィルター¶

トレースを検索するには、トレースリストの上にある検索行を使用します。

スパンの確認¶

トレースを選択すると、そのスパンを確認できます。 スパンリストとタイムラインが一緒に表示されます。各行にはスパン名、継続時間、トークンの使用量が表示され、タイムラインチャートでは、トレース全体の中でそのスパンがいつ実行されたかが示されます。 親スパンを展開すると、その子スパンが表示されます。 スパンに関連付けられたデプロイまたはサービスへのアクセス権がない場合、制限付きスパンと表示されます。

スパンビューでは、継続時間、トークン、名前、ステータスコードでスパンをフィルターしたり、同一のスパンを抽出したりできます。

スパンを選択すると、概要メタデータ、ログ、入力、出力、およびその他のメタデータが同じページで確認できます。 スパン内のフォーマット済みテキストは、属性と並んで表示されます。 スパンサービスまたはモデル名をクリックすると、デプロイまたはリソースにアクセスできます（アクセス権がある場合）。

スパンを展開すると、スパン属性、入力、出力とともにログが表示されます。 表示される結果は、完全なデプロイログの一部です。

トレーステーブルのOTel属性¶

コスト、プロンプト、補完、およびツールについては、DataRobotはトレースに属するすべてのスパンにわたる特定のスパン属性を読み取ります。 その他のフィールド（タイムスタンプ、レイテンシー、トークンなど）は、これらの属性ではなく、トレースおよびスパンのメタデータから取得されます。

属性キーは完全に一致する必要があります（gen_ai内のアンダースコアも含みます）。 genai.promptやGenAI.promptといった名前は、プロンプトおよび補完列では読み込まれません。

自動計装（DataRobotのエージェントテンプレートを含む）では、多くの場合、gen_ai.prompt、gen_ai.completion、そして場合によってはtool_nameが設定されます。 カスタムモデルや外部モデルの場合、フレームワークが異なります。ツールが実行されても（たとえば、一部のLangGraphコールバックフロー）、実行時にtool_nameが出力されない場合があります。 その場合、プロンプトと補完には値を設定できますが、ツールについては、ツール内で実行されるスパンにtool_nameが設定されるまでは空のままになります。トレースの実装を参照してください。