Explore monitoring data and traces¶
On the Monitoring > Data exploration tab, you can explore traces from the Workload. トレースは、ルートスパン名、タイムスタンプ、ステータス別にリストに表示されます。 トレースを選択すると、ワークロードによって実行されたアクションのスパンリストとタイムラインをまとめて確認できます。 最新のタイムスタンプ、ステータス、タイプでトレースを絞り込むには、検索行を使用します。
タブの上部にあるアーティファクトドロップダウンを使用して、アーティファクトのバージョンごとにトレースをフィルターできます。 これにより、トレーステーブルが当該アーティファクトによって処理されたリクエストに絞り込まれます。これは、アーティファクトの置き換え前後のトレースの挙動を比較する際に役立ちます。 また、このドロップダウンでは、このページから直接アーティファクトの置き換えを開始することもできます。
ワークロードでDataRobot Moderationsライブラリが使用されている場合、モデレーションのスパンは、アプリケーションのトレースとともにトレーステーブルに表示されます。 コストガードが設定されると、datarobot.moderation.costというスパン属性の値が、トレース内のすべてのスパンについて集計され、コスト列に表示されます。
トレースは、モデルまたはエージェントのワークフローに対するリクエストがたどった経路を表します。 DataRobotでは、トレースにOpenTelemetryフレームワークを使用しています。 トレースは、起点から解決まで、リクエストのエンドツーエンドの経路全体を追跡します。 各トレースには、ルートスパンから始まる1つ以上のスパンが含まれます。 ルートスパンはリクエストの経路全体を表し、プロセスの各ステップの子スパンが含まれます。 ルート（または親）スパンと各子スパンは、同じトレースIDを共有します。
アクセスと保持
トレースは、カスタムアプリケーション、カスタムおよび外部モデルのデプロイ、ワークロードで利用可能です。 アプリケーション、デプロイ、およびワークロードは、同じトレースインターフェイスを共有しています。
保持期間は、システム管理者が組織レベルで設定し、その組織内のすべてのユーザーに適用されます。 ポリシーが明示的に設定されていない場合、トライアル版利用の組織には14日間のポリシーが、有料版利用の組織には30日間のポリシーが適用されます。 管理者は、シグナルタイプ（トレース、ログ、メトリクス）ごとに、保持期間を14、30、60、90、180、または360日に設定できます。
組織の保持期間設定を確認または変更するには、OTelの保持期間の設定を参照してください。
トレースは、ルートスパン名ごとにリストに表示されます。 各エントリーには、トレースのステータスとタイムスタンプが表示されます。 トレースを選択すると、詳細ペインが開き、リクエストの概要メタデータ、および統合されたスパンリストとタイムラインが表示されます。
リクエストに応じて、リストおよび詳細ペインには以下のフィールドが含まれる場合があります。
| フィールド | 説明 |
|---|---|
| ルートスパン名 | トレースのルートスパンの名前。 |
| タイムスタンプ | トレースの日付と時刻。 |
| ステータス | すべてのスパンを含む、トレースの全体的なステータス（例：成功）。 依存タスクが失敗した場合、ステータスはエラーになります。 |
| トレースID | トレースの一意の識別子。 |
| ユーザーID | リクエストに関連付けられたユーザー（存在する場合）。 |
| 待ち時間 | トレースが完了するまでにかかった時間。 この値はルートスパンの継続時間と等しく、子スパンによって表されるすべてのアクションが含まれます。 |
| トークン | トレースにおけるトークンの使用量。 |
| スパン | トレースに含まれる完了したスパン（アクション）の数。 |
| エラー | エラーが記録されたトレース内のスパン数。 |
| コスト | コストデータが指定されている場合は、トレースの総コスト。 |
| プロンプト | トレースに関連するユーザープロンプト。 |
| 補完 | トレースのプロンプトに関連付けられているエージェントまたはモデルの回答（補完）。 |
| ツール | トレースで表されたリクエスト中に呼び出されるツールまたはツール群。 |
トレースの検索とフィルター¶
トレースを検索するには、トレースリストの上にある検索行を使用します。
| フィルター | 説明 |
|---|---|
| 最新のタイムスタンプ | トレース内の最新のアクティビティの時刻に基づいてトレースを絞り込みます。 |
| ステータス | 成功またはアラートのステータスに基づいてトレースを絞り込みます。 |
| タイプ | 生成タイプを含むタイプに基づいてトレースを絞り込み、運用スパンと生成固有のスパンを区別します。 |
スパンの確認¶
トレースを選択すると、そのスパンを確認できます。 スパンリストとタイムラインが一緒に表示されます。各行にはスパン名、継続時間、トークンの使用量が表示され、タイムラインチャートでは、トレース全体の中でそのスパンがいつ実行されたかが示されます。 親スパンを展開すると、その子スパンが表示されます。 スパンに関連付けられたデプロイまたはサービスへのアクセス権がない場合、制限付きスパンと表示されます。
スパンビューでは、継続時間、トークン、名前、ステータスコードでスパンをフィルターしたり、同一のスパンを抽出したりできます。
スパンを選択すると、概要メタデータ、ログ、入力、出力、およびその他のメタデータが同じページで確認できます。 スパン内のフォーマット済みテキストは、属性と並んで表示されます。 スパンサービスまたはモデル名をクリックすると、デプロイまたはリソースにアクセスできます（アクセス権がある場合）。
スパンを展開すると、スパン属性、入力、出力とともにログが表示されます。 表示される結果は、完全なデプロイログの一部です。
トレーステーブルのOTel属性¶
コスト、プロンプト、補完、およびツールについては、DataRobotはトレースに属するすべてのスパンにわたる特定のスパン属性を読み取ります。 その他のフィールド（タイムスタンプ、レイテンシー、トークンなど）は、これらの属性ではなく、トレースおよびスパンのメタデータから取得されます。
| 列 | OpenTelemetryのマッピング |
|---|---|
| コスト | トレース内のスパンにある datarobot.moderation.cost属性の数値を合計します（その属性が存在する場合）。 |
| プロンプト | gen_ai.prompt属性を使用します。 複数のスパンにgen_ai.promptが含まれている場合、トレース順で最初に検出された値が表示されます。 |
| 補完 | gen_ai.completion属性を使用します。 複数のスパンにgen_ai.completionが含まれている場合、トレース順で最後に検出された値が表示されます。 |
| ツール | トレース内のスパンで検出されたtool_name属性の一意の値をすべて収集し、それらのツール名を列に一覧表示します。 |
属性キーは完全に一致する必要があります（gen_ai内のアンダースコアも含みます）。 genai.promptやGenAI.promptといった名前は、プロンプトおよび補完列では読み込まれません。
自動計装（DataRobotのエージェントテンプレートを含む）では、多くの場合、gen_ai.prompt、gen_ai.completion、そして場合によってはtool_nameが設定されます。 カスタムモデルや外部モデルの場合、フレームワークが異なります。ツールが実行されても（たとえば、一部のLangGraphコールバックフロー）、実行時にtool_nameが出力されない場合があります。 その場合、プロンプトと補完には値を設定できますが、ツールについては、ツール内で実行されるスパンにtool_nameが設定されるまでは空のままになります。トレースの実装を参照してください。