Beispiele für Benachrichtigungen

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Mit Apigee können Sie komplexe Benachrichtigungen basierend auf mehreren Bedingungen erstellen. In den folgenden Abschnitten werden einige Beispiele für Benachrichtigungen erläutert.

Benachrichtigung bei 200-Antwortcode für 5 Minuten

Im nächsten Beispiel wird eine Benachrichtigung erstellt, wenn 5 Minuten lang kein 200-Antwortcode (erfolgreiche Anfrage) vorhanden ist.

So erstellen Sie die Benachrichtigung:

  1. Öffnen Sie in der Google Cloud Console das Dashboard Benachrichtigungsrichtlinie erstellen.

  2. Klicken Sie auf Messwert auswählen.
  3. Heben Sie die Auswahl der Schaltfläche Aktiv auf.

    Hinweis: Wenn Ihre Organisation keine aktuellen API-Trafficdaten enthält, wird der Messwert im nächsten Schritt nur angezeigt, wenn diese Option deaktiviert ist.

  4. So wählen Sie einen Messwert aus:
    1. Kopieren Sie Folgendes und fügen Sie es in das Feld Messwert auswählen ein: 
      apigee.googleapis.com/proxy/response_count
    2. Wählen Sie Apigee-Proxy aus.
    3. Wählen Sie im sich öffnenden Bereich Proxy aus.
    4. Wählen Sie im nächsten Bereich rechts die kumulative Anzahl der Antworten des Apigee-Proxys aus.
    5. Klicken Sie auf Anwenden.
  5. Fügen Sie einen Filter für den Antwortcode hinzu:
    1. Klicken Sie auf Filter hinzufügen.
    2. Klicken Sie in das Feld Filter und wählen Sie im Drop-down-Menü response_code aus.
    3. Wählen Sie im Comparator die Option = aus.
    4. Geben Sie im Feld Value (Wert) den Wert 200 ein.
    5. Klicken Sie auf Anwenden.

Benachrichtigungstrigger konfigurieren

Klicken Sie zum Konfigurieren des Ereignisses, das die Benachrichtigung auslöst, im linken Bereich auf Trigger konfigurieren. Führen Sie dann folgende Schritte aus:

  1. Wählen Sie unter Bedingungstyp die Option Fehlender Messwert aus.
  2. Wählen Sie im Feld Benachrichtigungstrigger die Option Bei jedem Verstoß aus.
  3. Wählen Sie im Feld Messwertabwesenheitszeit die Option 5 min aus.
  4. Geben Sie optional im Feld Bedingungsname einen Namen für die Bedingung ein.

Mit diesen Einstellungen wird eine Benachrichtigung ausgelöst, wenn der Proxy fünf Minuten lang keinen Antwortcode 200 empfängt.

Klicken Sie auf Weiter, um den Bereich Benachrichtigungen konfigurieren und Benachrichtigung abschließen zu öffnen.

Benachrichtigung für die Warnung einrichten

Im Bereich Benachrichtigungen konfigurieren und Benachrichtigung abschließen können Sie eine Benachrichtigung einrichten, die beim Auslösen einer Benachrichtigung gesendet wird. Anleitung:

  1. Klicken Sie in das Feld Benachrichtigungskanäle. Wenn Sie bereits einen Kanal für die Benachrichtigung erstellt haben, z. B. eine E-Mail-Adresse oder SMS-Nummer, können Sie diese unter Benachrichtigungskanäle auswählen.

    Andernfalls müssen Sie einen Kanal hinzufügen, indem Sie Benachrichtigungskanäle verwalten auswählen. Daraufhin wird der Bereich Benachrichtigungskanäle geöffnet, in dem Sie einen oder mehrere Kanäle hinzufügen können. Weitere Informationen finden Sie unter Benachrichtigungskanäle verwalten. Wenn Sie fertig sind, kehren Sie zum Bereich Benachrichtigungen konfigurieren und Benachrichtigung abschließen zurück.

    Hinweis: Möglicherweise müssen Sie auf die Aktualisierungsschaltfläche neben Benachrichtigungskanäle verwalten klicken, um einen neuen Kanal nach dem Erstellen anzuzeigen.

    Nachdem Sie einen oder mehrere Benachrichtigungskanäle ausgewählt haben, klicken Sie auf OK.

  2. Im Feld Dokumentation können Sie eine Nachricht hinzufügen, die mit der Benachrichtigung gesendet wird. Die Nachricht kann beispielsweise den Grund für die Benachrichtigung beschreiben und Links zur Dokumentation enthalten, die erläutert, wie auf sie reagiert wird.
  3. Klicken Sie auf Weiter, um die Details der Benachrichtigung anzusehen. Wenn Sie mit ihnen zufrieden sind, klicken Sie auf Richtlinie erstellen, um die Benachrichtigungsrichtlinie zu erstellen.

Benachrichtigung bei hohem Traffic

In den folgenden Abschnitten wird beschrieben, wie Sie eine Benachrichtigung erstellen, die ausgelöst wird, wenn die Anzahl der API-Anfragen über einen Zeitraum von 1 Minute über 3.600 liegt.

So erstellen Sie die Benachrichtigung:

  1. Öffnen Sie in der Google Cloud Console das Dashboard Benachrichtigungsrichtlinie erstellen.

  2. Klicken Sie auf Messwert auswählen.
  3. Heben Sie die Auswahl der Schaltfläche Aktiv auf.

    Hinweis: Wenn Ihre Organisation keine aktuellen API-Trafficdaten enthält, wird der Messwert im nächsten Schritt nur angezeigt, wenn diese Option deaktiviert ist.

  4. So wählen Sie einen Messwert aus:
    1. Kopieren Sie Folgendes und fügen Sie es in das Feld Messwert auswählen ein: 
      apigee.googleapis.com/proxy/request_count
    2. Wählen Sie Apigee-Proxy aus.
    3. Wählen Sie im sich öffnenden Bereich Proxy aus.
    4. Wählen Sie im nächsten Bereich rechts die Anzahl der Apigee-Proxy-Anfragen aus.
    5. Klicken Sie auf Anwenden.
  5. Gehen Sie im Bereich Daten transformieren so vor:
    • Unter In jeder Zeitachse:
      • Wählen Sie im Feld Rollierendes Fenster die Option 1 Min. aus.
      • Wählen Sie in der Funktion der rollierenden Fenster die Option Rate aus.
    • Wählen Sie unter Über Zeitachsen unter Zeitachsenaggregation die Option Summe aus.

Benachrichtigungstrigger konfigurieren

Klicken Sie zum Konfigurieren des Ereignisses, das die Benachrichtigung auslöst, im linken Bereich auf Trigger konfigurieren. Führen Sie dann folgende Schritte aus:

  1. Wählen Sie unter Bedingungstyp die Option Schwellenwert aus.
  2. Wählen Sie im Feld Benachrichtigungstrigger die Option Bei jedem Verstoß aus.
  3. Wählen Sie im Feld Grenzwertposition die Option Über Grenzwert aus.
  4. Geben Sie im Feld Schwellenwert den Wert 60 ein.

Sie legen den Schwellenwert auf 60 fest (anstelle von 3.600), da die Einheiten des Schwellenwerts pro Sekunde angegeben werden. Wenn dieser Schwellenwert also 1 Minute lang beibehalten wird, gibt es in diesem Zeitraum mindestens 3.600 Anfragen.

Mit diesen Einstellungen wird eine Benachrichtigung ausgelöst, wenn die Gesamtzahl der Anfragen über einen Zeitraum von einer Minute mehr als 3.600 beträgt.

Klicken Sie auf Weiter, um den Bereich Benachrichtigungen konfigurieren und Benachrichtigung abschließen zu öffnen, und folgen Sie den Schritten unter Benachrichtigung einrichten.

Latenzwarnung

In den folgenden Beispielen wird gezeigt, wie Sie eine Benachrichtigung erstellen, die ausgelöst wird, wenn das 95. Perzentil der durchschnittlichen Latenzen in den Antworten über Intervalle von 10 Minuten über 600 ms liegt.

Benachrichtigung mit Apigee oder Apigee Hybrid v1.12 erstellen

So erstellen Sie die Benachrichtigung mit Apigee:

  1. Öffnen Sie in der Google Cloud Console das Dashboard Benachrichtigungsrichtlinie erstellen.

  2. Klicken Sie auf Messwert auswählen.
  3. Entfernen Sie das Häkchen bei Aktiv.

    Hinweis: Wenn Ihre Organisation keine aktuellen API-Trafficdaten enthält, wird der Messwert im nächsten Schritt nur angezeigt, wenn diese Option deaktiviert ist.

  4. So wählen Sie einen Messwert aus:
    1. Kopieren Sie Folgendes und fügen Sie es in das Feld Messwert auswählen ein: 
      apigee.googleapis.com/proxy/latencies
    2. Wählen Sie Apigee-Proxy aus.
    3. Wählen Sie im sich öffnenden Bereich Proxy aus.
    4. Wählen Sie im nächsten Bereich rechts Apigee-Proxy-Latenzen aus.
    5. Klicken Sie auf Anwenden.
  5. Gehen Sie im Bereich Daten transformieren unter In jeder Zeitachse so vor:
    • Wählen Sie im Feld Rollierendes Fenster die Option 10 Min. aus.
    • Geben Sie im Feld Rollierende Fensterfunktion den Wert 95. Perzentil ein.

Informationen zum Konfigurieren des Ereignisses, das die Benachrichtigung auslöst, finden Sie unter Benachrichtigungstrigger erstellen.

Benachrichtigung mit Apigee Hybrid v1.10 oder v1.11 erstellen

So erstellen Sie die Benachrichtigung mit Apigee Hybrid v1.10 oder v1.11:

  1. Öffnen Sie in der Google Cloud Console das Dashboard Benachrichtigungsrichtlinie erstellen.

  2. Klicken Sie auf Messwert auswählen.
  3. Entfernen Sie das Häkchen bei Aktiv.

    Hinweis: Wenn Ihre Organisation keine aktuellen API-Trafficdaten enthält, wird der Messwert im nächsten Schritt nur angezeigt, wenn diese Option deaktiviert ist.

  4. So wählen Sie einen Messwert aus:
    1. Kopieren Sie Folgendes und fügen Sie es in das Feld Messwert auswählen ein: 
      apigee.googleapis.com/proxyv2/latencies_percentile
    2. Wählen Sie Apigee-Proxy (v2) aus.
    3. Wählen Sie im sich öffnenden Bereich Proxyv2 aus.
    4. Wählen Sie im nächsten Bereich rechts die Option Perzentil von Apigee-Proxy-Antwortlatenzen aus.
    5. Klicken Sie auf Anwenden.

  5. So fügen Sie einen Filter hinzu:

    1. Klicken Sie auf Filter hinzufügen.
    2. Klicken Sie in das Feld Filter und wählen Sie im Drop-down-Menü Perzentil aus.
    3. Wählen Sie im Comparator die Option = aus.
    4. Geben Sie im Feld Value (Wert) den Wert 95 ein.
    5. Klicken Sie auf Anwenden.
  6. Gehen Sie im Bereich Daten transformieren unter In jeder Zeitachse so vor:
    • Wählen Sie im Feld Rollierendes Fenster die Option 10 Min. aus.
    • Geben Sie im Feld Rollierende Fensterfunktion den Wert mean ein.

Informationen zum Konfigurieren des Ereignisses, das die Benachrichtigung auslöst, finden Sie unter Benachrichtigungstrigger erstellen.

Benachrichtigungstrigger konfigurieren

Klicken Sie zum Konfigurieren des Ereignisses, das die Benachrichtigung auslöst, im linken Bereich auf Trigger konfigurieren. Führen Sie dann folgende Schritte aus:

  1. Wählen Sie unter Bedingungstyp die Option Schwellenwert aus.
  2. Wählen Sie im Feld Benachrichtigungstrigger die Option Bei jedem Verstoß aus.
  3. Wählen Sie im Feld Grenzwertposition die Option Über Grenzwert aus.
  4. Geben Sie im Feld Schwellenwert den Wert 600 ein.

Mit diesen Einstellungen wird eine Benachrichtigung ausgelöst, wenn das 95. Perzentil der Latenz über dem Schwellenwert von 600 ms liegt.

Klicken Sie auf Weiter, um den Bereich Benachrichtigungen konfigurieren und Benachrichtigung abschließen zu öffnen, und folgen Sie den Schritten unter Benachrichtigung einrichten.

Wenn Sie eine Benachrichtigung erhalten und in der Benachrichtigungs-E-Mail auf die Schaltfläche View In Apigee (In Apigee ansehen) klicken, wird im Investigate-Dashboard ein Latenzdiagramm mit dem folgenden Beispiel angezeigt:Wählen Sie einen Messwert aus.