Explore monitoring data and traces¶

プレミアム機能

トレースはプレミアム機能です。この機能を有効にする方法については、DataRobotの担当者または管理者にお問い合わせください。

On the Monitoring > Data exploration tab, you can explore traces from the Workload. Each trace—identified by a timestamp and a trace ID—contains a visual timeline that represents actions carried out by the Workload and reveals the order and duration of these actions.

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

アクセスと保持

トレーステーブルは、すべてのカスタムモデルおよび外部モデルのデプロイで利用できます。トレースデータは30日間保存され、その後自動的に削除されます。

トレーステーブルでは、各トレースに関連する以下のフィールドを確認できます。

列	説明
タイムスタンプ	`YYYY-MM-DD HH：MM`形式でのトレースの日時。
ステータス	すべてのスパンを含むトレースの全体的なステータス。依存タスクが失敗した場合、ステータスはエラーになります。
トレースID	トレースの一意の識別子。
期間	トレースの完了にかかった時間（ミリ秒単位）。この値は、（四捨五入された）ルートスパンの期間と同じで、子スパンによって表されるすべてのアクションが含まれます。
スパン数	トレースに含まれる完了したスパン（アクション）の数。
コスト	コストデータが指定されている場合は、トレースの総コスト。
プロンプト	トレースに関連するユーザープロンプト。
補完	トレースのプロンプトに関連付けられているエージェントまたはモデルの回答（補完）。
ツール	トレースで表されたリクエスト中に呼び出されるツールまたはツール群。

フィルターをクリックして、最小スパン期間、最大スパン期間、最小トレースコスト、最大トレースコストでフィルターします。スパンフィルターの単位はナノ秒（ns）です。チャートにはスパンがミリ秒（ms）で表示されます。

フィルターのアクセシビリティ

スパンが詳細ビューに展開されると、 フィルターボタンは非表示になります。フィルターを適用したチャートビューに戻るには、 詳細パネルを表示しないをクリックします。

トレースに含まれるスパンとトレースの詳細を確認するには、トレーステーブルのトレース行をクリックします。スパンの色は、スパンサービス（通常はデプロイ）に対応します。スパンに関連付けられたデプロイまたはサービスへのアクセス権がない場合、制限されたスパンが表示されます。スパンはチャート形式またはリスト形式で表示できます。

スパンの詳細をコントロール

どちらのビューからでも、 テーブルを表示しないをクリックしてタイムスタンプテーブルを折りたたんだり、 詳細パネルを表示しないをクリックして展開されたトレーステーブルビューに戻ったりすることができます。

チャートビューリストビュー

トレースの詳細

リストビューでトレースの詳細をクリックすると、現在のスパンに関連付けられているトレースに関する入力/出力（プロンプトと補完）および評価の詳細を表示できます。

どちらのビューでも、スパンサービス名をクリックして、デプロイまたはリソースにアクセスします（アクセス権がある場合）。生成AIモデルまたはエージェントワークフローの設定に応じた追加情報を、情報、リソース、イベント、入力/出力、エラー、ログの各タブで入手できます。 エラータブは、トレースでエラーが発生した場合にのみ表示されます。

チャートビューリストビュー

トレースログをフィルター¶

リストビューから、スパンのOTelログを表示できます。表示される結果は完全なデプロイログのサブセットであり、以下のようにアクセスされます。

リストビューを開き、トレースの詳細でスパンを選択します。
ログタブをクリックします。
ログを表示をクリックします。

トレーステーブルの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が設定されるまでは空のままになります。トレースの実装を参照してください。