Referência de esquema de tabela de traços unificada

A tabela unificada de traços segue o modelo de dados de abrangência OpenTelemetry. Cada fileira tem um vão. A tabela é agrupada por time.

Coluna Description Tipo
record_id Identificador único para esta linha da tabela. STRING
time Carimbo de data e hora em que o vão foi registrado. TIMESTAMP
date Data UTC quando o vão foi registrado. Útil para poda de divisórias. DATE
service_name Nome do serviço Unity Gateway (nome do endpoint). STRING
service_id Identificador para o serviço nomeado em service_name. STRING
trace_id Identificador compartilhado por todos os abrangentes em uma única árvore de requisição. Filtre isso para reconstruir um traço completo. STRING
span_id Identificador único para esse trecho. STRING
trace_state Valor do cabeçalho OpenTelemetry tracestate , se presente. STRING
parent_span_id span_id da extensão dos pais. NULL para spans de raiz (um por solicitação). STRING
flags Rastreamento OpenTelemetry sinaliza bitmask. INT
name Nome de span legível por humanos, por my-endpoint-mlflow/v1/chat/completionsexemplo. STRING
kind Tipo de span: SPAN_KIND_SERVER (root, um por requisição) ou SPAN_KIND_CLIENT (chamada a jusante). STRING
start_time_unix_nano Tempo de início em nanossegundos desde a época do Unix. BIGINT
end_time_unix_nano Tempo de fim em nanossegundos desde a época do Unix. BIGINT
attributes Atributos de expansão como um objeto VARIANTE. Nomes de chaves contêm pontos; use sintaxe entre colchetes para acessá-los: attributes:['enduser.id']. Veja atributos principais abaixo. VARIANT
dropped_attributes_count Número de atributos perdidos devido a limites. INT
events Uma variedade de eventos cronometrados ao longo do período. O tipo de evento primário é policy_evaluated, que registra detalhes de avaliação por apólice. Veja eventos de avaliação de políticas. ESTRUTURA DE MATRIZ<>
dropped_events_count O número de eventos foi reduzido devido aos limites. INT
links Array de links para outros vaidados ou trilhos. ESTRUTURA DE MATRIZ<>
dropped_links_count Número de links perdidos devido a limites. INT
status Status de expansão com code (STATUS_CODE_OK ou STATUS_CODE_ERROR) e opcional message. STRUCT
resource Atributos de recursos que descrevem a entidade instrumentada, por exemplo service.name , e metadados do SDK. STRUCT
resource_schema_url URL do esquema para as convenções semânticas de recursos. STRING
instrumentation_scope Nome e versão da biblioteca de instrumentação que produziu o trecho. STRUCT
span_schema_url URL de esquema para as convenções semânticas span. STRING

A tabela também contém colunas necessárias para sua otimização física, notadamente clustering, que não são úteis para consultas. Essas colunas recebem um _ prefixo. Trate-os como detalhes de implementação que podem mudar em versões futuras.

Atributos de chave

A coluna attributes é uma coluna VARIANT. Campos de acesso usando sintaxe de colchete para chaves que contêm pontos: attributes:['gen_ai.request.model']. Retorna NULL a sintaxe de backticks para essas chaves. As chaves presentes dependem se o span é uma chamada de serviço modelo (LLM) ou uma chamada de serviço MCP.

Serviço de modelo (LLM) abrange:

Attribute Description
databricks.api_type Tipo API de entrada, por openai/v1/responsesexemplo.
workspace_id Workspace a solicitação foi recebida.
enduser.id Usuário ou principal de serviço que fez o pedido.
databricks.requester_type Tipo de solicitante, USERpor exemplo.
databricks.request_id ID de request gerado por Azure Databricks.
databricks.url URL completa da solicitação.
databricks.latency_ms Latência de solicitação de ponta a ponta em milissegundos.
databricks.time_to_first_byte_ms Tempo para o primeiro byte em milissegundos.
databricks.action Tipo de tentativa, por exemplo initial_attempt ou retry.
databricks.destination_id Modelo alvo, databricks-claude-sonnet-4-6por exemplo.
databricks.outcome success ou failure.
gen_ai.operation.name Operação, por chatexemplo .
gen_ai.request.model Modelo solicitado.
gen_ai.provider.name Provedor, por databricksexemplo.
gen_ai.usage.input_tokens Tokens de entrada consumidos.
gen_ai.usage.output_tokens Tokens de saída gerados.
http.response.status_code Código de status HTTP.
error.type Tipo de erro nas falhas, por invalid_requestexemplo.
mlflow.chat.tokenUsage Uso detalhado de tokens como uma string JSON.
mlflow.spanInputs Carga útil de requisição serializada.
mlflow.spanOutputs Carga útil de resposta serializada (vazia em caso de falha).

O serviço MCP abrange:

Attribute Description
mcp.method.name Método MCP, por exemplo tools/list ou tools/call.
gen_ai.operation.name Operação, por exemplo execute_tool para tools/call.
gen_ai.tool.name Nome da ferramenta invocada, por atlassianUserInfoexemplo.
gen_ai.tool.call.arguments Argumentos extraídos da ferramenta, como uma string JSON.
gen_ai.tool.call.result Resultado extraído da ferramenta, como uma string JSON.
databricks.requester_type Tipo de solicitante, USERpor exemplo.
databricks.request_id ID de request gerado por Azure Databricks.
databricks.tool.connection_type Tipo de conexão MCP, por EXTERNAL_MCPexemplo.
tool_source Conexão de backup ou nome de servidor MCP gerenciado, por exemplo main.default.gh-conn (externo) ou code_interpreter (gerenciado). O nome do serviço MCP está na service_name coluna.
tool_type Tipo de ferramenta, por external_connectionexemplo .
workspace_id ID do workspace.
enduser.id Usuário ou principal de serviço que fez o pedido.
http.response.status_code Status HTTP da chamada MCP.
rpc.response.status_code JSON-RPC código de status, -32003por exemplo. O sinal principal de falha do MCP.
error.type Classificação de falhas, por exemplo policy_deny, upstream_error, ou internal_error.
mlflow.spanType Tipo de vão. TOOL para os tramos MCP. Útil para WHERE filtrar.
mlflow.spanInputs Pedido de JSON-RPC serializado.
mlflow.spanOutputs Resposta serializada MCP/JSON-RPC.

Atributos de aplicação de políticas (abrangências de serviço modelo e MCP):

Quando uma política bloqueia uma requisição, o server span (o alcance raiz) define os seguintes atributos escalares. Como eles são configurados apenas quando uma política interrompe a solicitação, eles também servem como um filtro rápido para "alguma política bloqueou essa solicitação?"

Attribute Description
databricks.policy.name A política que bloqueou o pedido. A função do Catálogo Unity FQN para uma política personalizada, ou o rótulo de anexo para uma política embutida. <unknown> se a política não for nomeada.
databricks.policy.action Ação forçada, ou DENY .ASK

Eventos de avaliação de políticas

A events coluna contém um array de policy_evaluated eventos, um por par avaliado (política, fase). É aqui que reside o detalhe por política, além dos atributos escalares databricks.policy.* no servidor span. Cada evento carrega as seguintes chaves:

Chave Description
policy.name Nome da apólice avaliada.
policy.type Tipo de política, ou CUSTOM .BUILTIN
policy.handler Responsável pela apólice. Apenas políticas integradas.
policy.options Opções de manejo. Apenas políticas integradas.
policy.action Ação avaliada, uma de ALLOW, DENY, ou ASK.
policy.phase Fase de avaliação, ou on_call ou on_result. Apenas apólices personalizadas.

Quando uma política roda em modo de teste (monitor ou sombra) com dry_run=true, a ação imposta é rebaixada para ALLOW que a solicitação prossiga, e o veredito potencial seja registrado sobre o mesmo evento:

Chave Description
policy.dry_run_action A ação que teria sido aplicada, por DENYexemplo. Sua presença sinaliza que a política foi executada em modo de ensaio geral.
policy.dry_run_reason Motivo para a ação que se tornou.
policy.dry_run_transformed_message A carga útil que uma política de transformação ou máscara teria escrito.