Écouter vos notifications Pub/Sub

Exemple d'architecture de référence

Schéma d'un exemple d'utilisation de notifications automatisées d'alerte budgétaire pour automatiser une réponse de contrôle des coûts.
Figure 1 : exemple d'utilisation des alertes de budget pour automatiser les réponses de contrôle des coûts à l'aide de Pub/Sub pour les notifications automatisées et des fonctions Cloud Run pour automatiser une réponse.

Ce document explique comment écouter vos notifications de budget programmatiques en vous abonnant à votre sujet Pub/Sub avec des déclencheurs de fonction Cloud Run. Sans abonné, Pub/Sub abandonne les messages publiés et vous ne pouvez pas les récupérer ultérieurement. Dans ce document, vous allez apprendre à effectuer les tâches suivantes :

  1. Créez une fonction Cloud Run qui écoute les notifications.
  2. Affichez les événements Cloud Run Functions.
  3. Tester une fonction Cloud Run

Avant de commencer

Avant de commencer, vous devez effectuer les tâches suivantes :

  1. Créer un budget
  2. Configurer les notifications programmatiques

Créer une fonction Cloud Run

Pour créer une fonction Cloud Run :

  1. Dans la console Google Cloud , accédez à la page Fonctions Cloud Run.

    Accéder aux fonctions Cloud Run

  2. Cliquez sur CRÉER UN SERVICE.

  3. Sélectionnez Utiliser un éditeur intégré pour créer une fonction.

  4. Saisissez un nom de service en rapport avec la notification budgétaire.

  5. Sélectionnez la région dans laquelle vos fonctions Cloud Run seront exécutées. Vous ne pouvez pas modifier ce paramètre après avoir déployé votre fonction.

  6. Cliquez sur Ajouter un déclencheur, puis sélectionnez Cloud Pub/Sub.

  7. Si vous y êtes invité, activez les API requises.

  8. Dans le panneau Déclencheur Eventarc, procédez comme suit :

    1. Saisissez un nom de déclencheur.
    2. Définissez Type de déclencheur sur Sources Google.
    3. Définissez Fournisseur d'événements sur Cloud Pub/Sub.
    4. Sélectionnez le sujet Cloud Pub/Sub que vous avez configuré dans votre budget.
    5. Sélectionnez une Région.
    6. Cliquez sur Enregistrer le déclencheur.

  9. Modifiez les paramètres Identity-Aware Proxy, Facturation, Scaling du service, Entrée et Conteneur(s), volume, mise en réseau, sécurité selon vos besoins, puis cliquez sur Créer.

  10. Écrivez le code à l'aide de l'éditeur intégré ou importez un fichier indiquant à votre fonction comment gérer les notifications.

    Consultez les exemples de code suivants :

    Pour en savoir plus sur les notifications que le code recevra, consultez la section Format des notifications.

  11. Définissez le point d'entrée de la fonction sur la fonction à exécuter :

  12. Cliquez sur DÉPLOYER.

Afficher les événements Cloud Run Functions

Après avoir déployé la fonction Cloud Run, cliquez sur JOURNAUX pour afficher les journaux des appels de votre fonction.

Tester une fonction Cloud Run

Les notifications sont envoyées à Pub/Sub et les abonnés reçoivent les messages. Pour tester un exemple de notification et vous assurer que votre fonction s'exécute comme prévu, publiez un message dans Pub/Sub en utilisant l'objet suivant comme corps du message :

{
    "budgetDisplayName": "name-of-budget",
    "alertThresholdExceeded": 1.0,
    "costAmount": 100.01,
    "costIntervalStart": "2019-01-01T00:00:00Z",
    "budgetAmount": 100.00,
    "budgetAmountType": "SPECIFIED_AMOUNT",
    "currencyCode": "USD"
}

Vous pouvez également ajouter des attributs de messages, tels que l'ID du compte de facturation. Pour en savoir plus, consultez Format des notifications.

Étapes suivantes

Pour en savoir plus sur l'utilisation des notifications programmatiques, consultez les exemples suivants de réponses programmatiques de contrôle des coûts :