統合トレーステーブルスキーマのリファレンス

統合トレーステーブルは、OpenTelemetry スパンデータモデルに準拠しています。各行は1つのスパンです。テーブルは time によってクラスタリングされています。

列	説明	Type
record_id	このテーブル行の一意の識別子。	STRING
time	スパンが記録された時点のTimestamp。	TIMESTAMP
date	スパンが記録されたUTC日時。パーティションプルーニングに役立ちます。	DATE
service_name	Unity AI Gateway サービスの名前 (Endpoint名)。	STRING
service_id	service_name で指定されたサービスの識別子。	STRING
trace_id	単一のリクエストツリー内のすべてのスパンで共有される識別子。完全なトレースを再構築するには、これでフィルター処理します。	STRING
span_id	このスパンの一意の識別子。	STRING
trace_state	OpenTelemetry tracestateヘッダー値（存在する場合）。	STRING
parent_span_id	span_id 親スパンの。ルートスパンの NULL （リクエストごとに1つ）。	STRING
flags	OpenTelemetryトレースフラグのビットマスク。	INT
name	人間にとってわかりやすいスパン名（例：my-endpoint-mlflow/v1/chat/completions）。	STRING
kind	スパンの種類: SPAN_KIND_SERVER (ルート、リクエストごとに1つ) または SPAN_KIND_CLIENT (ダウンストリーム呼び出し)。	STRING
start_time_unix_nano	Unixエポックからのナノ秒単位のスパン起動時間。	BIGINT
end_time_unix_nano	UNIX エポックからのナノ秒単位のスパン終了時刻。	BIGINT
attributes	VARIANT オブジェクトとしてのスパン属性。キー名にドットが含まれている場合は、バッククォート構文を使用してアクセスしてください: attributes:\enduser.id``。以下の「重要な属性」を参照してください。	バリエーション
dropped_attributes_count	制限により削除された属性の数。	INT
events	スパン内のタイムイベントの配列。プライマリ イベント タイプは policy_evaluated で、ポリシーごとの評価詳細を記録します。ポリシー評価イベントを参照してください。	array<struct>
dropped_events_count	制限によりドロップされたイベント数。	INT
links	他のスパンまたはトレースへのLinkの配列。	array<struct>
dropped_links_count	制限によりドロップされたLinkの数。	INT
status	code（STATUS_CODE_OKまたはSTATUS_CODE_ERROR）およびオプションのmessageを含むスパンステータス。	構造体
resource	計測対象のエンティティを記述するリソース属性（例：service.nameやSDKメタデータ）。	構造体
resource_schema_url	リソースセマンティック規則のスキーマ URL。	STRING
instrumentation_scope	スパンを生成したインストルメンテーションライブラリの名前とバージョン。	構造体
span_schema_url	スパンセマンティック規則のスキーマURL。	STRING

列	説明	Type
record_id	このテーブル行の一意の識別子。	STRING
time	スパンが記録された時点のTimestamp。	TIMESTAMP
date	スパンが記録されたUTC日時。パーティションプルーニングに役立ちます。	DATE
service_name	Unity AI Gateway サービスの名前 (Endpoint名)。	STRING
service_id	service_name で指定されたサービスの識別子。	STRING
trace_id	単一のリクエストツリー内のすべてのスパンで共有される識別子。完全なトレースを再構築するには、これでフィルター処理します。	STRING
span_id	このスパンの一意の識別子。	STRING
trace_state	OpenTelemetry tracestateヘッダー値（存在する場合）。	STRING
parent_span_id	span_id 親スパンの。ルートスパンの NULL （リクエストごとに1つ）。	STRING
flags	OpenTelemetryトレースフラグのビットマスク。	INT
name	人間にとってわかりやすいスパン名（例：my-endpoint-mlflow/v1/chat/completions）。	STRING
kind	スパンの種類: SPAN_KIND_SERVER (ルート、リクエストごとに1つ) または SPAN_KIND_CLIENT (ダウンストリーム呼び出し)。	STRING
start_time_unix_nano	Unixエポックからのナノ秒単位のスパン起動時間。	BIGINT
end_time_unix_nano	UNIX エポックからのナノ秒単位のスパン終了時刻。	BIGINT
attributes	VARIANT オブジェクトとしてのスパン属性。キー名にドットが含まれている場合は、バッククォート構文を使用してアクセスしてください: attributes:\enduser.id``。以下の「重要な属性」を参照してください。	バリエーション
dropped_attributes_count	制限により削除された属性の数。	INT
events	スパン内のタイムイベントの配列。プライマリ イベント タイプは policy_evaluated で、ポリシーごとの評価詳細を記録します。ポリシー評価イベントを参照してください。	array<struct>
dropped_events_count	制限によりドロップされたイベント数。	INT
links	他のスパンまたはトレースへのLinkの配列。	array<struct>
dropped_links_count	制限によりドロップされたLinkの数。	INT
status	code（STATUS_CODE_OKまたはSTATUS_CODE_ERROR）およびオプションのmessageを含むスパンステータス。	構造体
resource	計測対象のエンティティを記述するリソース属性（例：service.nameやSDKメタデータ）。	構造体
resource_schema_url	リソースセマンティック規則のスキーマ URL。	STRING
instrumentation_scope	スパンを生成したインストルメンテーションライブラリの名前とバージョン。	構造体
span_schema_url	スパンセマンティック規則のスキーマURL。	STRING

このテーブルには、物理的な最適化（特にクラスタリング）に必要な列も含まれていますが、これらはクエリーには使用されません。これらの列には_プレフィックスが付けられています。これらは将来のバージョンで変更される可能性がある実装の詳細として扱ってください。

主要な属性

attributes 列は VARIANT です。ドットを含むキーには、バックティック構文を使用してフィールドにアクセスします：attributes:\gen_ai.request.model``。存在するキーは、スパンがモデルサービス（LLM）呼び出しであるか、MCPサービス呼び出しであるかによって異なります。

モデルサービス（LLM）スパン：

属性	説明
databricks.api_type	インバウンドAPIタイプ（例：openai/v1/responses）。
enduser.id	リクエストを行ったユーザーまたはService Principal。
databricks.requester_type	リクエスタータイプ（例：USER）。
databricks.request_id	Databricks が生成したリクエスト ID。
databricks.url	完全なリクエストURL。
databricks.latency_ms	エンドツーエンドのリクエストレイテンシー（ミリ秒）。
databricks.time_to_first_byte_ms	最初のバイトまでの時間（ミリ秒単位）。
databricks.action	試行タイプ（例：initial_attempt または retry）。
databricks.destination_id	ターゲットモデル（例：databricks-claude-sonnet-4-6）。
databricks.outcome	success または failure
gen_ai.operation.name	オペレーション（例：chat）。
gen_ai.request.model	リクエストされたモデル。
gen_ai.provider.name	プロバイダー（例：databricks）。
gen_ai.usage.input_tokens	消費された入力トークン。
gen_ai.usage.output_tokens	生成された出力トークン。
http.response.status_code	HTTPステータスコード。
error.type	障害発生時のエラータイプ（例：invalid_request）。
mlflow.chat.tokenUsage	JSON 文字列としての詳細なトークン使用状況。
mlflow.spanInputs	シリアル化されたリクエストペイロード。
mlflow.spanOutputs	シリアル化された応答ペイロード（失敗時は空）。

属性	説明
databricks.api_type	インバウンドAPIタイプ（例：openai/v1/responses）。
enduser.id	リクエストを行ったユーザーまたはService Principal。
databricks.requester_type	リクエスタータイプ（例：USER）。
databricks.request_id	Databricks が生成したリクエスト ID。
databricks.url	完全なリクエストURL。
databricks.latency_ms	エンドツーエンドのリクエストレイテンシー（ミリ秒）。
databricks.time_to_first_byte_ms	最初のバイトまでの時間（ミリ秒単位）。
databricks.action	試行タイプ（例：initial_attempt または retry）。
databricks.destination_id	ターゲットモデル（例：databricks-claude-sonnet-4-6）。
databricks.outcome	success または failure
gen_ai.operation.name	オペレーション（例：chat）。
gen_ai.request.model	リクエストされたモデル。
gen_ai.provider.name	プロバイダー（例：databricks）。
gen_ai.usage.input_tokens	消費された入力トークン。
gen_ai.usage.output_tokens	生成された出力トークン。
http.response.status_code	HTTPステータスコード。
error.type	障害発生時のエラータイプ（例：invalid_request）。
mlflow.chat.tokenUsage	JSON 文字列としての詳細なトークン使用状況。
mlflow.spanInputs	シリアル化されたリクエストペイロード。
mlflow.spanOutputs	シリアル化された応答ペイロード（失敗時は空）。

MCPサービススパン:

属性	説明
mcp.method.name	MCP メソッド（例：tools/list または tools/call）。
gen_ai.operation.name	操作（例：tools/call の場合は execute_tool）。
gen_ai.tool.name	呼び出されるツールの名前（例：atlassianUserInfo）。
gen_ai.tool.call.arguments	JSON 文字列として抽出されたツール引数。
gen_ai.tool.call.result	抽出されたツール結果（JSON文字列）。
databricks.requester_type	リクエスタータイプ（例：USER）。
databricks.request_id	Databricks が生成したリクエスト ID。
databricks.tool.connection_type	MCP接続タイプ（例：EXTERNAL_MCP）。
tool_source	基盤となる接続またはマネージドMCPサーバー名（例：main.default.gh-conn（外部）またはcode_interpreter（マネージド））。MCPサービス名はservice_name列にあります。
tool_type	ツールタイプ（例：external_connection）。
workspace_id	ワークスペースID。
enduser.id	リクエストを行ったユーザーまたはService Principal。
http.response.status_code	MCP 呼び出しからの HTTP ステータス。
rpc.response.status_code	JSON-RPC ステータスコード（例: -32003）。主要な MCP 障害シグナル。
error.type	失敗の分類（例：policy_deny、upstream_error、またはinternal_error）。
mlflow.spanType	スパンタイプ。MCPスパン用のTOOL。WHEREのフィルタリングに役立ちます。
mlflow.spanInputs	シリアル化された JSON-RPC リクエスト。
mlflow.spanOutputs	シリアル化された MCP/JSON-RPC レスポンス。

属性	説明
mcp.method.name	MCP メソッド（例：tools/list または tools/call）。
gen_ai.operation.name	操作（例：tools/call の場合は execute_tool）。
gen_ai.tool.name	呼び出されるツールの名前（例：atlassianUserInfo）。
gen_ai.tool.call.arguments	JSON 文字列として抽出されたツール引数。
gen_ai.tool.call.result	抽出されたツール結果（JSON文字列）。
databricks.requester_type	リクエスタータイプ（例：USER）。
databricks.request_id	Databricks が生成したリクエスト ID。
databricks.tool.connection_type	MCP接続タイプ（例：EXTERNAL_MCP）。
tool_source	基盤となる接続またはマネージドMCPサーバー名（例：main.default.gh-conn（外部）またはcode_interpreter（マネージド））。MCPサービス名はservice_name列にあります。
tool_type	ツールタイプ（例：external_connection）。
workspace_id	ワークスペースID。
enduser.id	リクエストを行ったユーザーまたはService Principal。
http.response.status_code	MCP 呼び出しからの HTTP ステータス。
rpc.response.status_code	JSON-RPC ステータスコード（例: -32003）。主要な MCP 障害シグナル。
error.type	失敗の分類（例：policy_deny、upstream_error、またはinternal_error）。
mlflow.spanType	スパンタイプ。MCPスパン用のTOOL。WHEREのフィルタリングに役立ちます。
mlflow.spanInputs	シリアル化された JSON-RPC リクエスト。
mlflow.spanOutputs	シリアル化された MCP/JSON-RPC レスポンス。

ポリシー適用属性（モデルサービスおよびMCPサービススパン）：

ポリシーがリクエストをブロックすると、サーバー スパン（ルート スパン）は以下のスカラー属性を設定します。これらはポリシーがリクエストをショートサーキット（短絡）させた場合にのみ設定されるため、「ポリシーによってこのリクエストがブロックされたか？」を素早くフィルタリングする役割も果たします。

属性	説明
databricks.policy.name	リクエストをブロックしたポリシー。カスタムポリシーの Unity Catalog 関数 FQN、または組み込みポリシーの添付ラベル。ポリシーに名前がない場合は <unknown>。
databricks.policy.action	強制アクション。DENY または ASK のいずれかが必要です。

属性	説明
databricks.policy.name	リクエストをブロックしたポリシー。カスタムポリシーの Unity Catalog 関数 FQN、または組み込みポリシーの添付ラベル。ポリシーに名前がない場合は <unknown>。
databricks.policy.action	強制アクション。DENY または ASK のいずれかが必要です。

ポリシー評価イベント

events列には、評価された（ポリシー、フェーズ）ペアごとに1つずつ、policy_evaluatedイベントの配列が保持されます。ここには、サーバー範囲上のスカラーdatabricks.policy.*属性を超えた、ポリシーごとの詳細が格納されます。各イベントには、以下のキーが含まれます。

キー	説明
policy.name	評価されたポリシーの名前。
policy.type	ポリシータイプ（CUSTOMまたはBUILTIN）。
policy.handler	ポリシーのハンドラー。組み込みポリシーのみ。
policy.options	ハンドラーオプション。組み込みポリシーのみ。
policy.action	評価されたアクション（ALLOW、DENY、またはASKのいずれか）。
policy.phase	評価フェーズ（on_callまたはon_resultのいずれか）。カスタムポリシーのみ。

キー	説明
policy.name	評価されたポリシーの名前。
policy.type	ポリシータイプ（CUSTOMまたはBUILTIN）。
policy.handler	ポリシーのハンドラー。組み込みポリシーのみ。
policy.options	ハンドラーオプション。組み込みポリシーのみ。
policy.action	評価されたアクション（ALLOW、DENY、またはASKのいずれか）。
policy.phase	評価フェーズ（on_callまたはon_resultのいずれか）。カスタムポリシーのみ。

dry_run=true を使用してポリシーがドライラン（モニターまたはシャドウ）モードで実行されると、強制アクションは ALLOW にダウングレードされてリクエストが続行され、想定される判定が同じイベントに記録されます：

キー	説明
policy.dry_run_action	強制適用されるはずだったアクション（例：DENY）。これが存在することは、ポリシーがドライランモードで実行されたことを示します。
policy.dry_run_reason	実行予定のアクションの理由。
policy.dry_run_transformed_message	実行予定の変換またはマスクポリシーによって書き込まれるはずだったペイロード。

キー	説明
policy.dry_run_action	強制適用されるはずだったアクション（例：DENY）。これが存在することは、ポリシーがドライランモードで実行されたことを示します。
policy.dry_run_reason	実行予定のアクションの理由。
policy.dry_run_transformed_message	実行予定の変換またはマスクポリシーによって書き込まれるはずだったペイロード。