Pub/Sub-Benachrichtigungen abhören

Beispielreferenzarchitektur

Diagramm eines Beispiels mit programmatischen Benachrichtigungen für Budgetbenachrichtigungen zur Automatisierung einer Kostenkontrollenantwort
Abbildung 1: Ein Beispiel für die Verwendung von Budgetbenachrichtigungen zur Automatisierung von Kostenkontrollantworten mit Pub/Sub für programmatische Benachrichtigungen und Cloud Run Functions zur Automatisierung einer Antwort.

In diesem Dokument wird erläutert, wie Sie Ihre programmatischen Budgetbenachrichtigungen abhören, indem Sie Ihr Pub/Sub-Thema mit Cloud Run Functions-Triggern abonnieren. Ohne Abonnenten werden veröffentlichte Nachrichten von Pub/Sub verworfen und können später nicht mehr abgerufen werden. In diesem Dokument erfahren Sie, wie Sie die folgenden Aufgaben ausführen:

  1. Erstellen Sie eine Cloud Run-Funktion, die auf Benachrichtigungen wartet.
  2. Cloud Run-Funktionsereignisse ansehen
  3. Cloud Run-Funktion testen

Hinweis

Die folgenden Voraussetzungen müssen erfüllt sein:

  1. Budget erstellen
  2. Programmatische Benachrichtigungen einrichten

Cloud Run-Funktion erstellen

So erstellen Sie eine Cloud Run-Funktion:

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Run-Funktionen.

    Zu den Cloud Run-Funktionen

  2. Klicken Sie auf Funktion schreiben.

  3. Wählen Sie Funktion mit einem Inline-Editor erstellen aus.

  4. Geben Sie einen Dienstnamen ein, der für Ihre Budgetbenachrichtigung aussagekräftig ist.

  5. Wählen Sie die Region aus, in der Ihre Cloud Run-Funktionen ausgeführt werden sollen. Diese Einstellung kann nach der Bereitstellung der Funktion nicht mehr geändert werden.

  6. Klicken Sie auf Trigger hinzufügen und wählen Sie Cloud Pub/Sub aus.

  7. Aktivieren Sie alle erforderlichen APIs, wenn Sie dazu aufgefordert werden.

  8. Führen Sie im Bereich Eventarc-Trigger die folgenden Schritte aus:

    1. Geben Sie einen Triggernamen ein.
    2. Legen Sie den Triggertyp auf Google-Quellen fest.
    3. Setzen Sie Ereignisanbieter auf Cloud Pub/Sub.
    4. Wählen Sie das Cloud Pub/Sub-Thema aus, das Sie für Ihr Budget konfiguriert haben.
    5. Wählen Sie eine Region aus.
    6. Klicken Sie auf Trigger speichern.

  9. Bearbeiten Sie die Einstellungen für Identity-Aware Proxy, Abrechnung, Dienstskalierung, Eingehender Traffic und Container, Volume, Netzwerk, Sicherheit nach Bedarf und klicken Sie dann auf Erstellen.

  10. Schreiben Sie Code mit dem Inline-Editor oder laden Sie eine Datei hoch, die Ihrer Funktion mitteilt, wie Benachrichtigungen verarbeitet werden sollen.

    In den folgenden Beispielen finden Sie Codebeispiele:

    Weitere Informationen zu den Benachrichtigungen, die Ihr Code erhält, finden Sie unter Benachrichtigungsformat.

  11. Legen Sie für Funktionseinstiegspunkt die richtige auszuführende Funktion fest:

  12. Klicken Sie auf DEPLOY (Bereitstellen).

Cloud Run Functions-Ereignisse ansehen

Klicken Sie nach der Bereitstellung der Cloud Run-Funktion auf LOGS, um die Logs Ihrer Funktionsaufrufe aufzurufen.

Cloud Run-Funktion testen

Wenn Benachrichtigungen an Pub/Sub gesendet werden, erhalten Abonnenten die Nachrichten. Wenn Sie eine Beispielbenachrichtigung testen möchten, um zu prüfen, ob sich Ihre Funktion wie erwartet verhält, veröffentlichen Sie eine Nachricht in Pub/Sub. Verwenden Sie dazu das folgende Objekt als Inhalt der Nachricht:

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

Sie können auch Nachrichtenattribute wie die billing-konto-ID hinzufügen. Weitere Informationen finden Sie unter Benachrichtigungsformat.

Nächste Schritte

Weitere Informationen zur Verwendung programmatischer Benachrichtigungen finden Sie in den folgenden Beispielen für programmatische Kostenkontrollantworten: