Gérer les alertes de facturation

Cette page explique comment créer et désactiver des alertes et des règles d'alerte concernant la facturation.

Avant de commencer

Avant de continuer, assurez-vous de disposer du rôle requis suivant :

  • MonitoringRule PA Creator : permet de créer et de gérer les ressources MonitoringRule personnalisées. Demandez à l'administrateur IAM de votre organisation de vous attribuer le rôle monitoringrule-pa-creator.

Créer des règles d'alerte

Vous pouvez créer des règles d'alerte basées sur les métriques des factures et vos seuils de dépenses à l'aide de la ressource MonitoringRule dans l'API Observability.

Pour savoir comment créer des alertes à l'aide de la console GDC, consultez Créer des règles d'alerte.

Pour créer une règle d'alerte, procédez comme suit :

  1. Créez un fichier YAML, puis ajoutez-y la ressource MonitoringRule et le contenu suivant :

    apiVersion: monitoring.gdc.goog/v1
    kind: MonitoringRule
    metadata:
      name: MONITORING_RULE_NAME
      namespace: PROJECT
    spec:
      interval: INTERVAL
      limit: LIMIT
      alertRules:
      - alert: ALERT
        expr: EXPRESSION
        labels:
          severity: SEVERITY
          code: BILLING_CODE
          resource: BILLING
        annotations:
          message: MESSAGE
    

    Remplacez les variables suivantes :

    Variable Description
    MONITORING_RULE_NAME Nom de la règle de surveillance.

     Par exemple : invoice-total-cost.
    PROJECT Espace de noms du projet dans lequel se trouve la facture.

     Par exemple : platform-obs.
    INTERVAL Durée pendant laquelle l'alerte est réexécutée au cours d'une période donnée.

    Par exemple, 60s définit que l'alerte s'exécute toutes les 60 secondes.
    LIMIT Nombre de fois qu'une alerte peut s'exécuter.

     Par exemple, 0 pour aucune limite.
    ALERT Nom de l'alerte.

     Par exemple : invoice_total_cost_approaching_limit.
    EXPRESSION Expression PromQL décrivant la règle d'alerte. Pour récupérer une expression PromQL, consultez Interroger les alertes à partir de l'API HTTP.

    Par exemple, pour définir une règle d'alerte avec un seuil de dépenses à 80 % de votre budget de 500 000 $, utilisez l'expression suivante :

    sum(metering_invoice_line_item_total_cost{task_order_number="TASK_ORDER", clin_number="CLIN"}) / 500000 > 0.8

    Remplacez TASK_ORDER par votre bon de commande et CLIN par le numéro de ligne de votre contrat.
    SEVERITY Gravité de la règle d'alerte. Les valeurs de gravité incluent error, critical, warning et info.
    BILLING_CODE Code de facturation que vous définissez pour la règle d'alerte.

     Par exemple : "BILLING-100".
    MESSAGE Description de l'alerte qui s'affiche lorsque la règle d'alerte est exécutée.

     Par exemple : "Spending exceeded limit".
  2. Appliquez le contenu du fichier YAML et définissez la règle d'alerte :

    kubectl apply -f FILENAME.yaml
    

Créer des alertes de seuil de dépenses

Votre opérateur d'infrastructure (OI) crée des règles d'alerte de seuil de dépenses dans la console GDC. Les alertes de seuil de dépenses sont des alertes de facturation personnalisées qui indiquent quand les coûts de facturation dépassent le seuil que vous avez défini. Par exemple, votre OI crée des alertes sur le coût total de la facturation et les configure en fonction d'un montant fixe en dollars ou d'un pourcentage du montant budgétisé initial.

Pour créer des alertes de seuil de dépenses et d'autres alertes de facturation au niveau de l'organisation, envoyez une demande à votre OI. Incluez les paramètres suivants dans votre demande :

  • Numéro de bon de commande.
  • CLIN
  • Montant total du budget pour la TO et le CLIN spécifiés.
  • Seuil budgétaire.

Couper le son des alertes

Vous pouvez mettre en sourdine et réactiver les règles d'alerte dans la console GDC. Suivez les instructions de la section Mettre une alerte en sourdine.

Configurer les notifications de facturation

Pour configurer les notifications de facturation, suivez les instructions de la section Configurer des canaux de notification.