# Explore monitoring data and traces

> Explore monitoring data and traces - Explore traces from a Workload to understand the order and
> duration of actions carried out by the Workload.

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-07-30T11:40:01.821195+00:00` (UTC).

## Primary page

- [Explore monitoring data and traces](https://docs.datarobot.com/ja/docs/workload-api/monitor-workloads/monitoring-ui/data-exploration.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.html.md#filter-tracing-logs): In-page section heading.
- [トレーステーブルのOTel属性](https://docs.datarobot.com/ja/docs/workload-api/monitor-workloads/monitoring-ui/data-exploration.html.md#tracing-table-otel-attributes): In-page section heading.

## Documentation content

> [!NOTE] プレミアム機能
> トレースはプレミアム機能です。 この機能を有効にする方法については、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.

タブの上部にある アーティファクト ドロップダウンを使用して、アーティファクトのバージョンごとにトレースをフィルターできます。 これにより、トレーステーブルが当該アーティファクトによって処理されたリクエストに絞り込まれます。これは、アーティファクトの置き換え前後のトレースの挙動を比較する際に役立ちます。 また、このドロップダウンでは、このページから直接 [アーティファクトの置き換え](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#step-5-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) を参照してください。

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

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

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

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

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

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

**チャートビュー:**
[https://docs.datarobot.com/ja/docs/images/nxt-tracing-table-spans.png](https://docs.datarobot.com/ja/docs/images/nxt-tracing-table-spans.png)

**リストビュー:**
[https://docs.datarobot.com/ja/docs/images/nxt-tracing-table-spans-list.png](https://docs.datarobot.com/ja/docs/images/nxt-tracing-table-spans-list.png)

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


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

**チャートビュー:**
[https://docs.datarobot.com/ja/docs/images/nxt-tracing-table-span-tabs.png](https://docs.datarobot.com/ja/docs/images/nxt-tracing-table-span-tabs.png)

**リストビュー:**
[https://docs.datarobot.com/ja/docs/images/nxt-tracing-table-span-tabs-list-view.png](https://docs.datarobot.com/ja/docs/images/nxt-tracing-table-span-tabs-list-view.png)


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

リストビューから、スパンのOTelログを表示できます。 表示される結果は [完全なデプロイログ](https://docs.datarobot.com/ja/docs/workbench/nxt-console/nxt-activity-log/nxt-otel-logs.html.md) のサブセットであり、以下のようにアクセスされます。

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

### トレーステーブルの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) を参照してください。