Monitorare i costi del gateway di intelligenza artificiale unity

Importante

Questa funzionalità è in versione beta.

Osservare e analizzare i costi per tutto il traffico del gateway di intelligenza artificiale Unity in base al servizio modello, al modello di destinazione e all'entità richiesta.

Note

L'osservabilità dei costi si basa su Azure Databricks record di fatturazione. Per l'analisi dell'utilizzo a livello di richiesta, ad esempio conteggi dei token, latenza, dettagli del richiedente e tag di richiesta, vedere Utilizzo del modello per i servizi gateway di intelligenza artificiale Unity.

Requirements

Attribuzione

Unity AI Gateway fornisce l'attribuzione dei costi tramite la tabella del sistema di utilizzo fatturabile (system.billing.usage).

Unity AI Gateway arricchisce i MODEL_SERVING record di fatturazione in system.billing.usage con metadati specifici del servizio, in modo da poter attribuire il costo di Azure Databricks ai servizi associati, ai modelli di destinazione, alle identità e ai tag di servizio. Per le definizioni complete dello schema e dei campi, vedere le informazioni di riferimento sulla tabella del sistema di utilizzo della fatturazione.

La tabella del sistema per l'utilizzo fatturabile include l'attribuzione dei costi per i modelli ospitati in Azure Databricks. Per la spesa del modello esterno, vedere Modelli esterni.

Per le richieste gestite tramite un servizio di modelli Unity AI Gateway, Azure Databricks compila i campi seguenti nei record MODEL_SERVING in system.billing.usage:

Field Description
usage_metadata.ai_gateway.endpoint_name Nome del servizio modello di Gateway di intelligenza artificiale Unity che ha ricevuto la richiesta. Questo è il nome completamente qualificato di Unity Catalog, nel formato <catalog>.<schema>.<modelservice>.
usage_metadata.ai_gateway.endpoint_id L'ID del servizio del modello Unity AI Gateway.
usage_metadata.ai_gateway.destination_model Modello di destinazione che ha gestito la richiesta, ad esempio GPT-5.2.
usage_metadata.ai_gateway.destination_id L'ID della destinazione che ha gestito la richiesta.
identity_metadata.run_by Utente o entità servizio che ha emesso la richiesta.
custom_tags Tag di servizio configurati nel servizio modello di Gateway di intelligenza artificiale Unity, ad esempio team o cost_center.

Unity AI Gateway popola questi campi per le richieste di inferenza in tempo reale e batch indirizzate attraverso di esso.

Modelli esterni

Per le richieste instradate verso modelli esterni tramite servizi del provider di modelli in Unity Catalog, Azure Databricks calcola la spesa stimata in USD per ogni richiesta in base all'utilizzo dei token e ai prezzi pubblicati dal provider esterno. La spesa viene aggregata ogni ora e registrata nella tabella di system.ai_gateway.external_model_spend sistema. Usare questa tabella per analizzare la spesa esterna del modello in base al servizio provider di modelli, al modello di destinazione e all'entità richiesta.

Note

La spesa per i modelli esterni viene calcolata utilizzando i prezzi pubblicati del provider esterno e viene fornita solo a scopo informativo. Queste cifre potrebbero non riflettere la fattura del provider finale e Azure Databricks non è responsabile delle discrepanze nella fatturazione di terze parti.

Schema di spesa del modello esterno

La system.ai_gateway.external_model_spend tabella presenta lo schema seguente:

Nome della colonna Tipo Description
record_id filo Identificatore univoco per il record di spesa aggregato.
account_id filo ID dell'account.
workspace_id filo ID dell'area di lavoro in cui è configurato il servizio provider di modelli.
usage_date DATE Data del record di utilizzo, derivato da usage_start_time.
usage_start_time TIMESTAMP Inizio della finestra di aggregazione oraria, in formato UTC.
usage_end_time TIMESTAMP Fine della finestra di aggregazione oraria, in formato UTC.
ingestion_date DATE Data di inserimento del record nella tabella.
usage_metadata STRUCT Metadati sull'utilizzo del modello esterno, tra cui provider, modelendpoint_id, endpoint_name, destination_id, e destination_name.
custom_tags STRUCT Tag forniti dall'utente per l'attribuzione dei costi, inclusi endpoint_tags e request_tags.
usage_unit filo Unità di misura per usage_quantity. Sempre USD.
usage_quantity DECIMALE Costo stimato, in usage_unit, per la finestra di aggregazione.
pricing_metadata STRUCT Metadati relativi ai prezzi applicati, inclusi service_tier e long_context.
identity_metadata STRUCT Identità del richiedente, inclusi run_by e run_as.

Observability

Il dashboard di utilizzo predefinito include una pagina analisi dei costi per il monitoraggio dei costi e l'analisi dei dettagli dei costi nel tempo. È possibile analizzare i costi in più dimensioni, tra cui:

  • Servizio modello
  • Modello di destinazione
  • Utente o entità servizio richiedente

Oltre al costo di Azure Databricks, la dashboard include i costi del modello esterno dalla tabella system.ai_gateway.external_model_spend.

Per aprire il dashboard, fare clic su Govern in alto a destra nella pagina Unity AI Gateway, quindi fare clic su Usage Dashboard. Per informazioni dettagliate sull'importazione e l'aggiornamento del dashboard, vedere Dashboard di utilizzo predefinito.

Dashboard di analisi dei costi del gateway di intelligenza artificiale

Analisi dettagliata dei costi di ai-gateway

Note

La osservabilità dei costi è disponibile nella versione 0.4 del dashboard e versioni successive. Gli amministratori dell'account devono aggiornare il dashboard per ricevere le modifiche del modello più recenti. Vedere Dashboard di utilizzo predefinito.

Analisi dei costi

Tip

Genie Code (modalità agente) può farlo per te. Provare questo prompt di esempio:

Query system.billing.usage to show AI Gateway DBU cost for the past 30 days, broken down by usage_metadata.ai_gateway.endpoint_name, destination model, and requesting user. Filter to MODEL_SERVING records. Show top 10 in each.

Modelli ospitati da Databricks

Le query seguenti analizzano i costi dei modelli ospitati in Azure Databricks in system.billing.usage. I costi possono essere suddivisi in base al servizio modello, al modello di destinazione e all'entità.

Per servizio modello

SELECT
  usage_metadata.ai_gateway.endpoint_name AS endpoint_name,
  SUM(usage_quantity) AS dbus
FROM system.billing.usage
WHERE billing_origin_product = 'MODEL_SERVING'
  AND usage_metadata.ai_gateway.endpoint_name IS NOT NULL
  AND usage_unit = 'DBU'
  AND usage_date >= current_date() - INTERVAL 30 DAYS
GROUP BY endpoint_name
ORDER BY dbus DESC;

Per modello di destinazione

SELECT
  usage_metadata.ai_gateway.destination_model AS destination_model,
  SUM(usage_quantity) AS dbus
FROM system.billing.usage
WHERE billing_origin_product = 'MODEL_SERVING'
  AND usage_metadata.ai_gateway.endpoint_name IS NOT NULL
  AND usage_unit = 'DBU'
  AND usage_date >= current_date() - INTERVAL 30 DAYS
GROUP BY destination_model
ORDER BY dbus DESC;

Per utente o entità di servizio

SELECT
  identity_metadata.run_by AS run_by,
  SUM(usage_quantity) AS dbus
FROM system.billing.usage
WHERE billing_origin_product = 'MODEL_SERVING'
  AND usage_metadata.ai_gateway.endpoint_name IS NOT NULL
  AND identity_metadata.run_by IS NOT NULL
  AND usage_unit = 'DBU'
  AND usage_date >= current_date() - INTERVAL 30 DAYS
GROUP BY run_by
ORDER BY dbus DESC;

Modelli esterni

Le query seguenti analizzano la spesa per modelli esterni in system.ai_gateway.external_model_spend. La spesa può essere suddivisa in base al servizio provider di modelli, al modello di destinazione e ai tag di richiesta.

Per servizio del provider di modelli

SELECT
  usage_metadata.endpoint_name AS model_provider_service,
  SUM(usage_quantity) AS usd
FROM system.ai_gateway.external_model_spend
WHERE usage_start_time >= current_timestamp() - INTERVAL 30 DAYS
GROUP BY model_provider_service
ORDER BY usd DESC;

Per modello di destinazione

SELECT
  usage_metadata.model AS destination_model,
  SUM(usage_quantity) AS usd
FROM system.ai_gateway.external_model_spend
WHERE usage_start_time >= current_timestamp() - INTERVAL 30 DAYS
GROUP BY destination_model
ORDER BY usd DESC;

Per utente o entità di servizio

SELECT
  identity_metadata.run_by AS run_by,
  SUM(usage_quantity) AS usd
FROM system.ai_gateway.external_model_spend
WHERE usage_start_time >= current_timestamp() - INTERVAL 30 DAYS
GROUP BY run_by
ORDER BY usd DESC;

Per tag di richiesta

Per aggiungere tag di richiesta alle query, consulta Aggiungere tag alle richieste per il monitoraggio dell'utilizzo.

SELECT
  custom_tags.request_tags['team'] AS team,
  SUM(usage_quantity) AS usd
FROM system.ai_gateway.external_model_spend
WHERE usage_start_time >= current_timestamp() - INTERVAL 30 DAYS
GROUP BY team
ORDER BY usd DESC;

Limitations

  • L'attribuzione dei costi per i modelli ospitati in Azure Databricks si applica ai record MODEL_SERVING in system.billing.usage.
  • Per i servizi del modello con più destinazioni, ad esempio la suddivisione del traffico o il fallback, ai_gateway.destination_model e ai_gateway.destination_id identificano la destinazione che ha infine gestito la richiesta.
  • La spesa per modelli esterni è supportata solo per i servizi del provider di modelli in Unity Catalog.