Aller au contenu principal

Créer et surveiller des budgets

Cet article explique comment utiliser les budgets pour suivre les dépenses de votre compte Databricks.

Les budgets vous permettent de surveiller l'utilisation sur votre compte. Vous pouvez définir des budgets pour suivre les dépenses à l'échelle du compte ou appliquer des filtres pour suivre les dépenses de certaines équipes, projets ou Workspace. Pour les budgets limités à Unity Gateway, vous pouvez suivre les dépenses de chaque utilisateur par rapport aux threshold quotidiens et mensuels par utilisateur.

Les budgets sont mesurés en USD et utilisent le prix catalogue du SKU, y compris les modules complémentaires de plateforme.

Exigences​

  • Vous devez être administrateur de compte pour créer et gérer des budgets.
  • Les administrateurs de Workspace peuvent créer et gérer des budgets étendus aux workspaces qu'ils administrent à l'aide de Governance Hub.

Pour permettre à d’autres utilisateurs d’afficher ou de gérer un budget, attribuez-leur un rôle budgétaire. Consultez la page Gérer les autorisations de budget.

Créer un budget​

  1. Dans la barre latérale de la console du compte, cliquez sur Utilisation .

  2. Cliquez sur l'onglet **Budgets**, puis sur **Ajouter un budget**.

  3. Saisissez un **Nom** pour votre budget.

  4. Dans la section **Définitions**, vous pouvez limiter les dépenses suivies du budget en fonction du produit, du Workspace et des tags personnalisés. Si vous laissez ces champs vides, votre budget mesurera l'utilisation sur l'ensemble de votre compte.

    1. Dans la liste déroulante Workspaces , sélectionnez les Workspaces que vous souhaitez inclure dans votre budget. Laissez le champ vide pour suivre l’utilisation de l’intégralité de votre compte.

    2. Dans la liste déroulante Resource types , sélectionnez All pour suivre les dépenses de chaque produit Databricks, ou Unity Gateway pour suivre uniquement les dépenses via les endpoints Unity Gateway.

    3. (Facultatif) Dans la section Tags de ressources , vous pouvez délimiter le budget à une sélection de tags personnalisés. Si vous ajoutez des tags à cette section, le budget ne suivra que l'utilisation incluant les tags personnalisés spécifiés. Pour les budgets Unity Gateway, les tags sont mis en correspondance avec les tags d'Endpoint.

attention

Les données des tags sont stockées en texte brut et peuvent être répliquées à l’échelle mondiale. N’utilisez pas de noms de tags, de valeurs ou de descripteurs qui pourraient compromettre la sécurité de vos ressources. Par exemple, n’utilisez pas de noms de tags, de valeurs ou de descripteurs contenant des informations personnelles ou sensibles.

  1. Créez jusqu'à quatre thresholds partagés, qui surveillent les dépenses mensuelles par rapport à un threshold spécifié. Pour chaque threshold :

    1. Cliquez sur le bouton **Add threshold**.
    2. Saisissez un montant en dollars dans le champ Monthly threshold .
    3. (Facultatif) Cochez Envoyer un e-mail et saisissez une liste d’adresses e-mail séparées par des virgules. Ces adresses reçoivent des alertes lorsque les dépenses dépassent le threshold. Si vous n’envoyez pas d’e-mail, vous pouvez toujours suivre le budget dans la console de compte.
    4. (Facultatif) Cochez Bloquer l’utilisation pour empêcher les utilisateurs d’effectuer d’autres demandes via Unity Gateway lorsque le threshold est atteint. Un seul threshold partagé peut bloquer l’utilisation, et il doit s’agir du threshold partagé le plus élevé.
    5. (Facultatif) Cochez Trigger un webhook et sélectionnez une ou plusieurs destinations pour envoyer une charge utile de webhook lorsque le threshold est atteint. Voir Trigger des webhooks personnalisés.
    6. Cliquez sur **Ajouter**.
  2. (Budgets pour Unity Gateway uniquement) Vous pouvez également définir des threshold par utilisateur dans la section Groupes et utilisateurs . Un threshold par utilisateur effectue le suivi de la dépense Unity Gateway de chaque utilisateur dans le cadre du budget, et chaque utilisateur obtient sa propre copie du threshold. Vous pouvez définir un threshold quotidien, un threshold mensuel ou les deux. Les threshold quotidiens effectuent le suivi de la dépense pour chaque jour calendaire UTC et effectuent un Reset à 00 h 00 UTC. Les threshold mensuels effectuent un Reset le premier jour de chaque mois.

    1. Cliquez sur Ajouter un default threshold . Les threshold default s'appliquent à chaque utilisateur du périmètre du budget qui n'est pas couvert par une règle de remplacement.

    2. Sous threshold quotidien , threshold mensuel , ou les deux, cliquez sur Ajouter default et entrez un montant en dollars. Définissez le threshold quotidien plus bas que le threshold mensuel.

    3. Cliquez sur Enregistrer .

    4. (Facultatif) Pour donner à un utilisateur ou à un groupe une limite supérieure à celle par default, ajoutez un override :

      1. Cliquez sur Ajouter un groupe ou un utilisateur et sélectionnez l’utilisateur ou le groupe dans la liste déroulante Groupe ou utilisateur .
      2. Sous Daily threshold ou Monthly threshold , cliquez sur Ajouter un remplacement et saisissez un montant supérieur au default pour cette période. Si un utilisateur appartient à plusieurs groupes, le threshold le plus élevé pour chaque période s'applique.
      3. Cliquez sur Enregistrer . Répétez cette opération pour chaque utilisateur ou groupe.
    5. Sous Actions , cliquez sur Modifier les actions . Pour la période quotidienne , la période mensuelle ou les deux, sélectionnez une ou plusieurs actions. Les actions pour une période s'appliquent au threshold default et à tous les remplacements pour cette période.

      • Envoyer un e-mail : saisissez une liste d'adresses e-mail séparées par des virgules dans le champ Adresses e-mail . Ces adresses reçoivent des alertes lorsque les dépenses d'un utilisateur dépassent son threshold. La notification identifie l’utilisateur, la période, ses dépenses et le budget.
important

Les notifications budgétaires par e-mail et les payloads de webhook incluent le nom du budget, le filtre de workspace, l’identité utilisateur pour les threshold par utilisateur et les tags personnalisés définis. Les destinataires des e-mails n’ont pas besoin d’être des utilisateurs de Databricks, et les destinations des webhooks peuvent être des Endpoint externes. Assurez-vous de protéger les données sensibles lorsque vous nommez le budget, sélectionnez des tags, ajoutez des destinataires d’e-mails et choisissez des destinations de webhook.

  • Trigger webhook : sélectionnez une ou plusieurs destinations pour envoyer un payload de webhook lorsqu'un utilisateur atteint son threshold. Voir Trigger des webhooks personnalisés.

  • Bloquer l'utilisation : empêcher l'utilisateur d'effectuer d'autres demandes via Unity Gateway lorsqu'il atteint son threshold, jusqu'à ce que la période Reset.

  1. Cliquez sur Enregistrer .

  2. Cliquez sur Créer .

Trigger des webhooks personnalisés​

info

Bêta

Cette fonctionnalité est en Bêta. Les administrateurs de compte peuvent gérer l’accès à cette fonctionnalité à partir de la page Prévisualisations de la console de compte. Consultez Gérer les prévisualisations au niveau du compte.

Un threshold de budget peut envoyer une requête HTTP POST à un webhook lorsqu'il est atteint, afin que vous puissiez acheminer les événements de budget vers des outils de gestion des incidents, de billetterie ou d'automatisation. Pour utiliser cette fonctionnalité, un administrateur de compte doit activer la prévisualisation Destinations de webhook au niveau du compte .

Les webhooks de budget utilisent les destinations de notification au niveau du compte. Les administrateurs de compte créent ces destinations dans la console de compte. Une fois qu’une destination est créée, n’importe quel utilisateur du compte peut la voir et la sélectionner en tant qu’action de threshold. Les destinations de notification au niveau du compte ne prennent en charge que les webhooks. Les destinations de notification au niveau du workspace ne peuvent pas être utilisées dans les budgets.

Créer une destination webhook​

Vous devez être un administrateur de compte pour créer une destination de webhook.

  1. Ouvrez la page des destinations de notification dans la console de compte.

    Allez directement à la page des destinations de notification, ou :

    1. Dans la barre latérale de la console de compte, cliquez sur Paramètres .
    2. Cliquez sur le tab Notifications .
  2. Cliquez sur Ajouter une destination .

  3. Saisissez un Nom et l' URL du webhook. L'URL doit utiliser HTTPS.

  4. (Facultatif) Saisissez un Nom d'utilisateur et un Mot de passe pour authentifier les demandes avec une authentification HTTP de base.

  5. Cliquez sur Créer .

Les destinations de webhook au niveau du compte fonctionnent comme les destinations de webhook au niveau du Workspace. Voir Gérer les destinations de notification.

Charge utile du webhook​

Lorsqu'un threshold de budget avec Trigger webhook activé est atteint, Databricks envoie une charge utile JSON à chaque destination sélectionnée. La charge utile comprend le budget, le threshold (quantity_threshold), les dépenses en temps quasi réel (current_spend) et un event_id que vous pouvez utiliser pour supprimer les livraisons en double. Pour les threshold par utilisateur, la charge utile comprend également le principal_id et le user_name de l'utilisateur qui a atteint le threshold, et les valeurs de threshold et de dépenses sont celles de cet utilisateur pour la période.

L’exemple suivant montre une charge utile pour un threshold partagé. Les montants sont des chaînes décimales en dollars US au prix catalogue, et les heures sont des Timestamp RFC 3339 en UTC.

JSON
{
"event_type": "budgets.on_threshold_exceeded",
"event_id": "<event-id>",
"schema_version": "1",
"account_id": "<account-id>",
"budget": {
"budget_configuration_id": "<budget-id>",
"display_name": "ML team AI Gateway budget",
"resource_type": "BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY",
"filter": {
"workspace_id": { "operator": "IN", "values": [1234567890123456] },
"tags": [{ "key": "team", "value": { "operator": "IN", "values": ["ml"] } }]
}
},
"alert": {
"alert_configuration_id": "<alert-configuration-id>",
"scope_type": "ALERT_CONFIGURATION_SCOPE_TYPE_SHARED",
"time_period": "MONTH",
"trigger_type": "CUMULATIVE_SPENDING_EXCEEDED",
"quantity_type": "LIST_PRICE_DOLLARS_USD"
},
"evaluation": {
"evaluated_at": "2026-10-12T00:00:00Z",
"quantity_threshold": "50.00",
"current_spend": "50.02",
"period": {
"start": "2026-10-01T00:00:00Z",
"end": "2026-11-01T00:00:00Z"
}
}
}

Pour un threshold par utilisateur, scope_type est ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER et la charge utile ajoute un objet principal :

JSON
{
"principal": {
"principal_id": 1234567890,
"user_name": "user@example.com"
}
}

Ce que couvre un budget Unity Gateway​

Lorsque vous définissez un budget pour le produit Unity Gateway , le budget suit toutes les dépenses associées aux Endpoint Unity Gateway définis dans la portée. Cela couvre Pay-Per-Token (également appelé paiement à l'utilisation), l'inférence ai_query (batch) et l'utilisation optionnelle de modèles externes via des services de fournisseurs de modèles.

Les tags d'endpoint et de Unity Catalog sont pris en compte. Si vous ajoutez un filtre de tag au budget (par exemple, team=ml-platform), seuls les Unity Gateway Endpoint portant ce tag sont comptabilisés dans le budget. Les tags de requête n'affectent pas la correspondance budgétaire.

Les demandes d'inférence de throughput provisionné ne sont pas suivies par les budgets Unity Gateway.

Pour une analyse plus approfondie des coûts de Unity Gateway, y compris les tableaux de bord et les détails d’utilisation, voir Analyser le coût de Unity Gateway.

Les administrateurs de compte et de Workspace peuvent consulter un résumé de l’état du budget et des dépenses globales sur la page Coût de Governance Hub.

Pour les budgets qui suivent l'utilisation de Genie, consultez Gérer les budgets et les contrôles des coûts pour Genie.

Afficher les détails du budget​

Vous pouvez utiliser les notifications par e-mail pour savoir quand les dépenses ont dépassé un threshold de budget.

Vous pouvez également suivre le statut d’un budget en cliquant sur le nom du budget dans la console de compte. La page des détails du budget affiche les dépenses du mois en cours, le budget restant et une visualisation des dépenses cumulées au jour le jour. Les threshold d’alerte apparaissent sous forme de lignes pointillées sur le graphique.

Détails du budget

Pour les budgets limités à Unity Gateway, la page des détails du budget affiche également un tableau des dépenses par utilisateur. Le tableau répertorie chaque utilisateur ayant une utilisation de Unity Gateway dans le périmètre du budget, ses dépenses pour chaque période ayant un threshold par utilisateur et son statut par rapport à son threshold quotidien ou mensuel (en dessous, approche ou dépassé).

Tableau des dépenses par utilisateur pour un budget Unity Gateway

Mettre à jour ou supprimer un budget​

Pour mettre à jour ou supprimer un budget, cliquez sur le Icône du menu kebab. menu kebab dans la colonne la plus à droite de la ligne du budget et sélectionnez **Modifier le budget** ou **Supprimer le budget**.

Limitations connues​

important

Les budgets pour Unity Gateway fournissent une estimation en quasi-temps réel des dépenses suivies par rapport aux threshold configurés, et les coûts réels encourus peuvent différer des threshold configurés. Cette fonctionnalité est destinée à aider au contrôle des coûts en quasi-temps réel. N'utilisez pas cette fonctionnalité comme moyen de garantir un plafond de dépenses absolu sur les montants finaux facturés. Databricks n'est pas responsable des coûts encourus dépassant les threshold budgétaires configurés.

  • Vous pouvez configurer jusqu'à quatre threshold partagés par budget. Chaque threshold partagé doit avoir une valeur de threshold mensuelle unique. Les threshold partagés sont uniquement mensuels.

  • Les budgets pour Unity Gateway peuvent également avoir un threshold journalier par utilisateur default et un threshold mensuel par utilisateur default, qui ne sont pas pris en compte dans la limite du threshold partagé. Les remplacements par utilisateur pour des utilisateurs ou groupes spécifiques doivent être supérieurs au threshold par utilisateur default pour la même période. Pour ajouter un remplacement pour une période, le budget doit avoir un threshold par utilisateur default pour cette période. La suppression d’un threshold default supprime également ses remplacements.

  • Un seul threshold partagé par budget peut bloquer l’utilisation et il doit s’agir du threshold ayant la valeur la plus élevée.

  • Votre compte peut avoir un maximum de 1 000 budgets.

  • Il peut y avoir un délai de 24 heures maximum entre l’utilisation et l’envoi d’une notification par e-mail. Pour les budgets Unity Gateway, ce délai est considérablement plus court et en quasi-temps réel.

  • Après avoir créé un nouveau budget, il peut y avoir un délai avant que vous ne puissiez voir les détails du budget.

  • Les webhooks de budget ne sont pas disponibles dans les environnements gouvernementaux ou réglementés.

  • Les budgets ne tiennent pas compte des crédits de facturation ou des remises négociées que votre compte pourrait avoir. Le montant dépensé est calculé en multipliant l'utilisation par le prix catalogue SKU.

  • Les threshold de blocage de l'utilisation sont appliqués de manière approximative. L'application utilise une estimation du coût en temps réel, de sorte que les dépenses réelles peuvent varier au-dessus ou en dessous du threshold configuré. Cela signifie :

    • Un utilisateur peut être bloqué avant que ses dépenses réelles n'atteignent le threshold.
    • Un montant de dépenses supérieur au threshold peut survenir avant que l’application ne prenne effet. Les requêtes actives en cours lorsque le threshold est atteint ne sont pas interrompues.

    system.billing.usage reste la source unique de vérité pour l'utilisation facturable réelle. En cas de divergence entre l’utilisation suivie par rapport à un budget et les coûts réels, Databricks peut ajuster rétroactivement les estimations budgétaires afin de les réconcilier.

  • Les montants des dépenses dans les e-mails d’alerte budgétaire, la page des détails du budget et system.billing.usage peuvent différer lorsqu’ils sont comparés au même moment. Ceci est attendu, car chaque source se met à jour à un rythme différent :

    • E-mails d'alerte de budget : Reflètent les dépenses au moment où l'alerte a été Trigger.
    • Page de détails du budget : des mises à jour fréquentes peuvent afficher un montant inférieur à celui d’un e-mail d’alerte récent si elles sont consultées peu après.
    • system.billing.usage : Mises à jour toutes les quelques heures. L'interrogation des tables système peu après avoir reçu une alerte peut renvoyer un chiffre de dépenses inférieur à celui de la page des détails du budget ou des e-mails d'alerte.

    Pour Unity Gateway et les budgets Genie, l’application (blocage de l’utilisation et thresholds d’alerte) est basée sur un suivi des dépenses en temps quasi réel et n’est pas affectée par le timing de refresh des tables système.