Referencia de esquema de tabla de trazos unificada

La tabla de trazas unificada sigue el modelo de datos de abarcamiento OpenTelemetry. Cada fila tiene un tramo. La tabla está agrupada por time.

Columna Description Tipo
record_id Identificador único para esta fila de la tabla. STRING
time Marca de tiempo en la que se registró el tramo. TIMESTAMP
date Fecha UTC cuando se registró el tramo. Útil para la poda de particiones. FECHA
service_name Nombre del servicio Unity Gateway (nombre del endpoint). STRING
service_id Identificador del servicio nombrado en service_name. STRING
trace_id Identificador compartido por todos los spans en un solo árbol de solicitudes. Filtra esto para reconstruir una traza completa. STRING
span_id Identificador único para este tramo. STRING
trace_state Valor de cabecera de OpenTelemetry tracestate , si está presente. STRING
parent_span_id span_id del alcance de los padres. NULL para los tramos de raíces (uno por solicitud). STRING
flags El trazado de OpenTelemetry marca la máscara de bit. INT
name Nombre de extensión legible por humanos, por my-endpoint-mlflow/v1/chat/completionsejemplo. STRING
kind Tipo de span: SPAN_KIND_SERVER (raíz, una por petición) o SPAN_KIND_CLIENT (llamada aguas abajo). STRING
start_time_unix_nano Tiempo de inicio en nanosegundos desde la época de Unix. BIGINT
end_time_unix_nano Tiempo final en nanosegundos desde la época Unix. BIGINT
attributes Atributos de expansión como objeto VARIANTE. Los nombres de las claves contienen puntos; utiliza la sintaxis entre corchetes para acceder a ellos: attributes:['enduser.id']. Ver atributos clave más abajo. VARIANT
dropped_attributes_count Número de atributos eliminados por límites. INT
events Una variedad de eventos cronometrados dentro del lapso. El tipo de evento principal es policy_evaluated, que registra el detalle de evaluación por política. Ver eventos de evaluación de políticas. ESTRUCTURA DE MATRIZ<>
dropped_events_count Número de eventos se redujo por límites. INT
links Matriz de enlaces a otros tramos o trazas. ESTRUCTURA DE MATRIZ<>
dropped_links_count Número de enlaces eliminados por límites. INT
status Estado de expansión con code (STATUS_CODE_OK o STATUS_CODE_ERROR) y opcional message. ESTRUCTURA
resource Atributos de recursos que describen la entidad instrumentada, por ejemplo service.name , y metadatos del SDK. ESTRUCTURA
resource_schema_url URL de esquema para las convenciones semánticas de recursos. STRING
instrumentation_scope Nombre y versión de la biblioteca de instrumentación que produjo el span. ESTRUCTURA
span_schema_url URL de esquema para las convenciones semánticas de span. STRING

La tabla también contiene columnas necesarias para su optimización física, especialmente agrupamiento, que no son útiles para consultas. Estas columnas llevan un _ prefijo. Trátalos como detalles de implementación que pueden cambiar en versiones futuras.

Atributos clave

La columna attributes es una columna VARIANT. Acceder a campos usando sintaxis entre corchetes para claves que contienen puntos: attributes:['gen_ai.request.model']. Retornos NULL de sintaxis de retroactivos para estas claves. Las claves presentes dependen de si el span es una llamada de servicio modelo (LLM) o una llamada de servicio MCP.

El servicio modelo (LLM) abarca:

Attribute Description
databricks.api_type Tipo API entrante, por ejemplo openai/v1/responses.
enduser.id El usuario o principal del servicio que hizo la solicitud.
databricks.requester_type Tipo solicitante, por USERejemplo .
databricks.request_id ID request generat por Azure Databricks.
databricks.url URL completa de la solicitud.
databricks.latency_ms Latencia de petición de extremo a extremo en milisegundos.
databricks.time_to_first_byte_ms Tiempo hasta el primer byte en milisegundos.
databricks.action Tipo de intento, por ejemplo initial_attempt o retry.
databricks.destination_id Modelo objetivo, databricks-claude-sonnet-4-6por ejemplo .
databricks.outcome success o failure.
gen_ai.operation.name Operación, por chatejemplo .
gen_ai.request.model Modelo solicitado.
gen_ai.provider.name Proveedor, por databricksejemplo.
gen_ai.usage.input_tokens Tokens de entrada consumidos.
gen_ai.usage.output_tokens Tokens de salida generados.
http.response.status_code Código de estado HTTP.
error.type Tipo de error en fallos, invalid_requestpor ejemplo.
mlflow.chat.tokenUsage Uso detallado de tokens como cadena JSON.
mlflow.spanInputs Carga útil de peticiones serializadas.
mlflow.spanOutputs Carga útil de respuesta serializada (vacía en caso de fallo).

El servicio MCP abarca:

Attribute Description
mcp.method.name método MCP, por ejemplo tools/list o tools/call.
gen_ai.operation.name Operación, por ejemplo execute_tool para tools/call.
gen_ai.tool.name Nombre de la herramienta que se está invocando, por atlassianUserInfoejemplo.
gen_ai.tool.call.arguments Argumentos de herramientas extraídos, como cadena JSON.
gen_ai.tool.call.result Resultado extraído de la herramienta, como cadena JSON.
databricks.requester_type Tipo solicitante, por USERejemplo .
databricks.request_id ID request generat por Azure Databricks.
databricks.tool.connection_type Tipo de conexión MCP, por EXTERNAL_MCPejemplo.
tool_source Conexión de respaldo o nombre de servidor MCP gestionado, por ejemplo main.default.gh-conn (externo) o code_interpreter (gestionado). El nombre del servicio MCP está en la service_name columna.
tool_type Por ejemplo, el tipo external_connectionde herramienta.
workspace_id ID del área de trabajo.
enduser.id El usuario o principal del servicio que hizo la solicitud.
http.response.status_code Estado HTTP de la llamada MCP.
rpc.response.status_code JSON-RPC código de estado, -32003por ejemplo. La señal principal de fallo del MCP.
error.type Clasificación de fallos, por ejemplo policy_deny, upstream_error, o internal_error.
mlflow.spanType Tipo span. TOOL para los tramos MCP. Útil para WHERE filtrar.
mlflow.spanInputs Solicitud de JSON-RPC serializada.
mlflow.spanOutputs Respuesta MCP/JSON-RPC serializada.

Atributos de aplicación de políticas (abarca el servicio modelo y el servicio MCP):

Cuando una política bloquea una petición, el server span (el root span) establece los siguientes atributos escalares. Como solo se activan cuando una política corta la solicitud, también sirven como filtro rápido para "¿alguna política bloqueó esta petición?"

Attribute Description
databricks.policy.name La política que bloqueó la solicitud. La función FQN del Catálogo de Unity para una política personalizada, o la etiqueta adjunta para una política integrada. <unknown> si la póliza no tiene nombre.
databricks.policy.action Acción forzada, o DENY bien ASK.

Eventos de evaluación de políticas

La events columna contiene un array de policy_evaluated eventos, uno por par evaluado (política, fase). Aquí es donde reside el detalle por política, más allá de los atributos escalares databricks.policy.* en el servidor span. Cada evento lleva las siguientes llaves:

Key Description
policy.name Nombre de la póliza evaluada.
policy.type Tipo de política, cualquiera de CUSTOM las dos BUILTIN.
policy.handler Encargado de la póliza. Solo pólizas integradas.
policy.options Opciones de manejo. Solo pólizas integradas.
policy.action Acción evaluada, una de ALLOW, DENY, o ASK.
policy.phase Fase de evaluación, cualquiera de on_call las dos on_resulto . Solo pólizas personalizadas.

Cuando una política se ejecuta en modo de prueba en seco (monitor o sombra) con dry_run=true, la acción forzada se degrada a ALLOW modo que la solicitud avance y el posible veredicto se registre sobre el mismo evento:

Key Description
policy.dry_run_action La acción que se habría aplicado, por ejemplo DENY. Su presencia indica que la política se ejecutó en modo de prueba en seco.
policy.dry_run_reason Razón de la posible acción.
policy.dry_run_transformed_message La carga útil que habría escrito una posible política de transformación o máscara.