# Explore monitoring data and traces

> Explore monitoring data and traces - ワークロードのトレースを確認することで、そのワークロードによって実行されたアクションの順序と所要時間を把握できます。

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-10-09T14:18:51.490832+00:00` (UTC).

## Primary page

- [Explore monitoring data and traces](https://docs.datarobot.com/ja/docs/workload-api/monitor-workloads/monitoring-ui/data-exploration-wapi.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [トレースの検索とフィルター](https://docs.datarobot.com/ja/docs/workload-api/monitor-workloads/monitoring-ui/data-exploration-wapi.html.md#search-and-filter-traces): In-page section heading.
- [スパンの確認](https://docs.datarobot.com/ja/docs/workload-api/monitor-workloads/monitoring-ui/data-exploration-wapi.html.md#review-spans): In-page section heading.
- [トレーステーブルのOTel属性](https://docs.datarobot.com/ja/docs/workload-api/monitor-workloads/monitoring-ui/data-exploration-wapi.html.md#tracing-table-otel-attributes): In-page section heading.

## Documentation content

On the Monitoring > Data exploration tab, you can explore traces from the Workload. トレースは、ルートスパン名、タイムスタンプ、ステータス別にリストに表示されます。 トレースを選択すると、ワークロードによって実行されたアクションのスパンリストとタイムラインをまとめて確認できます。 最新のタイムスタンプ、ステータス、タイプでトレースを絞り込むには、検索行を使用します。

タブの上部にある アーティファクト ドロップダウンを使用して、アーティファクトのバージョンごとにトレースをフィルターできます。 これにより、トレーステーブルが当該アーティファクトによって処理されたリクエストに絞り込まれます。これは、アーティファクトの置き換え前後のトレースの挙動を比較する際に役立ちます。 また、このドロップダウンでは、このページから直接 [アーティファクトの置き換え](https://docs.datarobot.com/ja/docs/workload-api/update-workloads/replace-artifact-rollouts.html.md) を開始することもできます。

ワークロードで [DataRobot Moderationsライブラリ](https://docs.datarobot.com/ja/docs/workload-api/monitor-workloads/instrument-with-otel.html.md#add-datarobot-moderations-optional) が使用されている場合、モデレーションのスパンは、アプリケーションのトレースとともにトレーステーブルに表示されます。 コストガードが設定されると、 `datarobot.moderation.cost` というスパン属性の値が、トレース内のすべてのスパンについて集計され、 コスト 列に表示されます。

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

> [!NOTE] アクセスと保持
> トレースは、カスタムアプリケーション、カスタムおよび外部モデルのデプロイ、ワークロードで利用可能です。 アプリケーション、デプロイ、およびワークロードは、同じトレースインターフェイスを共有しています。
> 
> 保持期間は、システム管理者が 組織 レベルで設定し、その組織内のすべてのユーザーに適用されます。 ポリシーが明示的に設定されていない場合、トライアル版利用の組織には 14日間 のポリシーが、有料版利用の組織には 30日間 のポリシーが適用されます。 管理者は、シグナルタイプ（トレース、ログ、メトリクス）ごとに、保持期間を 14 、 30 、 60 、 90 、 180 、または 360 日に設定できます。

組織の保持期間設定を確認または変更するには、 [OTelの保持期間の設定](https://docs.datarobot.com/ja/docs/platform/admin/otel-retention.html.md) を参照してください。

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

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

| フィールド | 説明 |
| --- | --- |
| ルートスパン名 | トレースのルートスパンの名前。 |
| タイムスタンプ | トレースの日付と時刻。 |
| ステータス | すべてのスパンを含む、トレースの全体的なステータス（例：成功）。 依存タスクが失敗した場合、ステータスはエラーになります。 |
| トレースID | トレースの一意の識別子。 |
| ユーザーID | リクエストに関連付けられたユーザー（存在する場合）。 |
| 待ち時間 | トレースが完了するまでにかかった時間。 この値はルートスパンの継続時間と等しく、子スパンによって表されるすべてのアクションが含まれます。 |
| トークン | トレースにおけるトークンの使用量。 |
| スパン | トレースに含まれる完了したスパン（アクション）の数。 |
| エラー | エラーが記録されたトレース内のスパン数。 |
| コスト | コストデータが指定されている場合は、トレースの総コスト。 |
| プロンプト | トレースに関連するユーザープロンプト。 |
| 補完 | トレースのプロンプトに関連付けられているエージェントまたはモデルの回答（補完）。 |
| ツール | トレースで表されたリクエスト中に呼び出されるツールまたはツール群。 |

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

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

| フィルター | 説明 |
| --- | --- |
| 最新のタイムスタンプ | トレース内の最新のアクティビティの時刻に基づいてトレースを絞り込みます。 |
| ステータス | 成功またはアラートのステータスに基づいてトレースを絞り込みます。 |
| タイプ | 生成タイプを含むタイプに基づいてトレースを絞り込み、運用スパンと生成固有のスパンを区別します。 |

### スパンの確認

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

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

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

スパンを展開すると、スパン属性、入力、出力とともにログが表示されます。 表示される結果は、 [完全なデプロイログ](https://docs.datarobot.com/ja/docs/workbench/console/activity-log/otel-logs.html.md) の一部です。

### トレーステーブルの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` が設定されるまでは空のままになります。 [トレースの実装](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-tracing-code.html.md#surface-tool-names-in-the-tracing-table) を参照してください。