Riferimento unificato dello schema della tabella di traccia

La tabella di traccia unificata segue il modello di dati span OpenTelemetry. Ogni fila è una campata. La tabella è raggruppata da time.

Column Description Type
record_id Identificatore unico per questa riga della tabella. filo
time Timestamp in cui è stata registrata la campata. TIMESTAMP
date Data UTC in cui la campata è stata registrata. Utile per la potatura delle partizioni. DATE
service_name Nome del servizio Unity Gateway (nome dell'endpoint). filo
service_id Identificatore per il servizio nominato in service_name. filo
trace_id Identificatore condiviso da tutti gli span in un unico albero di richieste. Filtra su questo per ricostruire una traccia completa. filo
span_id Identificatore unico per questo intervallo. filo
trace_state Valore dell'intestazione OpenTelemetry tracestate , se presente. filo
parent_span_id span_id della durata dei genitori. NULL per le campate di radici (una per richiesta). filo
flags OpenTelemetry trace segnala la bitmask. INT
name Nome di span leggibile dall'uomo, ad my-endpoint-mlflow/v1/chat/completionsesempio . filo
kind Tipo di span: SPAN_KIND_SERVER (root, una per richiesta) oppure SPAN_KIND_CLIENT (chiamata a valle). filo
start_time_unix_nano L'intervallo di inizio in nanosecondi dall'epoca di Unix. BIGINT
end_time_unix_nano Span del tempo di fine in nanosecondi dall'epoca Unix. BIGINT
attributes Espandere gli attributi come oggetto VARIANTE. I nomi delle chiavi contengono puntini; usa la sintassi di backtick per accedervi: attributes:\enduser.id''. Vedi attributi chiave qui sotto. VARIANT
dropped_attributes_count Numero di attributi eliminati a causa dei limiti. INT
events Una serie di eventi a tempo nel corso di tempo. Il tipo di evento principale è policy_evaluated, che registra i dettagli di valutazione per policy. Vedi eventi di valutazione delle politiche. STRUTTURA DI ARRAY<>
dropped_events_count Numero di eventi eliminati a causa dei limiti. INT
links Array di collegamenti ad altre campate o tracce. STRUTTURA DI ARRAY<>
dropped_links_count Numero di link eliminati a causa dei limiti. INT
status Stato di espansione con code (STATUS_CODE_OK o STATUS_CODE_ERROR) e opzionale message. STRUCT
resource Attributi della risorsa che descrivono l'entità strumentata, ad esempio service.name e i metadati SDK. STRUCT
resource_schema_url URL dello schema per le convenzioni semantiche delle risorse. filo
instrumentation_scope Nome e versione della libreria strumentale che ha prodotto la campata. STRUCT
span_schema_url URL dello schema per le convenzioni semantiche span. filo

La tabella contiene anche le colonne necessarie per la sua ottimizzazione fisica, in particolare il clustering, che non sono utili per le query. Queste colonne sono denominate con un _ prefisso. Trattali come dettagli di implementazione che potrebbero cambiare nelle versioni future.

Attributi chiave

La colonna attributes è di tipo VARIANT. Accedi ai campi usando la sintassi backtick per le chiavi che contengono punti: attributes:\gen_ai.request.model''. Le chiavi presenti dipendono dal fatto che lo span sia una chiamata di servizio modello (LLM) o una chiamata di servizio MCP.

Il servizio modello (LLM) comprende:

Attribute Description
databricks.api_type Tipo API in entrata (inbound API type), ad openai/v1/responsesesempio .
enduser.id L'utente o il committente del servizio che ha fatto la richiesta.
databricks.requester_type Tipo richiedente, ad USEResempio .
databricks.request_id Azure Databricks-generated request ID.
databricks.url URL completo della richiesta.
databricks.latency_ms Latenza di richiesta end-to-end in millisecondi.
databricks.time_to_first_byte_ms Tempo per il primo byte in millisecondi.
databricks.action Tipo di tentativo, ad esempio initial_attempt o retry.
databricks.destination_id Modello target, ad databricks-claude-sonnet-4-6esempio .
databricks.outcome success o failure.
gen_ai.operation.name Operazione, ad chatesempio .
gen_ai.request.model Modello richiesto.
gen_ai.provider.name Fornitore, per esempio databricks.
gen_ai.usage.input_tokens Token di input consumati.
gen_ai.usage.output_tokens Output token generati.
http.response.status_code Codice stato HTTP.
error.type Tipo di errore sui guasti, ad invalid_requestesempio .
mlflow.chat.tokenUsage Uso dettagliato del token come stringa JSON.
mlflow.spanInputs Payload di richieste serializzate.
mlflow.spanOutputs Payload di risposta serializzato (vuoto in caso di guasto).

Il servizio MCP si estende a:

Attribute Description
mcp.method.name Metodo MCP, ad esempio tools/list o tools/call.
gen_ai.operation.name Operazione, ad esempio execute_tool per tools/call.
gen_ai.tool.name Nome dello strumento invocato, ad esempio atlassianUserInfo.
gen_ai.tool.call.arguments Argomenti estratti degli strumenti, come stringa JSON.
gen_ai.tool.call.result Risultato estratto dello strumento, come stringa JSON.
databricks.requester_type Tipo richiedente, ad USEResempio .
databricks.request_id Azure Databricks-generated request ID.
databricks.tool.connection_type Tipo di connessione MCP, ad EXTERNAL_MCPesempio .
tool_source Connessione di backup o nome server MCP gestito, ad esempio main.default.gh-conn (esterno) o code_interpreter (gestito). Il nome del servizio MCP è nella service_name colonna.
tool_type Tipo di strumento, ad external_connectionesempio.
workspace_id ID area di lavoro.
enduser.id L'utente o il committente del servizio che ha fatto la richiesta.
http.response.status_code Stato HTTP dalla chiamata MCP.
rpc.response.status_code JSON-RPC codice di stato, ad -32003esempio . Il segnale principale di guasto MCP.
error.type Classificazione dei guasti, ad esempio policy_deny, upstream_error, o internal_error.
mlflow.spanType Tipo span. TOOL per le campate MCP. Utile per WHERE filtrare.
mlflow.spanInputs Richiesta JSON-RPC serializzata.
mlflow.spanOutputs Risposta serializzata MCP/JSON-RPC.

Attributi di enforcement delle policy (servizi modello e coperture MCP):

Quando una policy blocca una richiesta, lo span server (lo span radice) imposta i seguenti attributi scalari. Poiché vengono impostate solo quando una policy interrotta la richiesta, servono anche come filtro rapido per "qualche policy ha bloccato questa richiesta?"

Attribute Description
databricks.policy.name La politica che ha bloccato la richiesta. La funzione Unity Catalog FQN per una policy personalizzata, oppure l'etichetta di allegato per una policy integrata. <unknown> se la polizza non è specificata.
databricks.policy.action Azione forzata, oppure DENYASK.

Eventi di valutazione delle politiche

La events colonna contiene un array di policy_evaluated eventi, uno per ogni coppia valutata (policy, fase). Qui risiede il dettaglio per policy, oltre agli attributi scalari databricks.policy.* sull'espansione del server. Ogni evento porta con sé le seguenti chiavi:

Chiave Description
policy.name Nome della polizza valutata.
policy.type Tipo di policy, o l'uno CUSTOM o BUILTINl'altro.
policy.handler Referente per la polizza. Solo polizze integrate.
policy.options Opzioni di controllo. Solo polizze integrate.
policy.action Azione valutata, una di ALLOW, DENY, o ASK.
policy.phase Fase di valutazione, o on_call oppure on_result. Solo polizze personalizzate.

Quando una policy viene eseguita in modalità di esecuzione (monitor o shadow) con dry_run=true, l'azione applicata viene declassata in ALLOW modo che la richiesta proceda e il verdetto potenziale venga registrato sullo stesso evento:

Chiave Description
policy.dry_run_action L'azione che sarebbe stata applicata, ad esempio DENY. La sua presenza segnala che la politica è stata eseguita in modalità di prova a zero.
policy.dry_run_reason Motivo della presunta azione.
policy.dry_run_transformed_message Il carico utile che una politica di trasformazione o mascherina avrebbe scritto.
  • Last updated on