Abfragebasierte Benachrichtigung mithilfe von MQL einrichten

In diesem Dokument erfahren Sie, wie Sie mit Monitoring Query Language (MQL) Messwerte untersuchen, Diagramme erstellen und eine abfragebasierte Benachrichtigung in der Google Cloud Console einrichten. Wenn Sie die Cloud Monitoring API bevorzugen, lesen Sie Bedingungen für Benachrichtigungsrichtlinien erstellen.

In diesem Dokument gehen Sie so vor:

  1. Erstellen Sie eine Compute Engine-Instanz.

  2. Rufen Sie den Code-Editor auf.

  3. Führen Sie eine Abfrage aus und erstellen Sie ein Diagramm.

  4. Richten Sie eine abfragebasierte Benachrichtigung ein.

Hinweise

Zur Verwendung von MQL müssen Sie ein Google Cloud-Projekt erstellen und die Abrechnung aktivieren.

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  5. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

Konfigurieren Sie als Nächstes die Berechtigungen und Benachrichtigungskanäle.

  1. Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Editor (roles/monitoring.editor) für Ihr Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Erstellen von Benachrichtigungsrichtlinien mit einer MQL-basierten Bedingung benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

    Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

    Weitere Informationen zu Cloud Monitoring-Rollen finden Sie unter Zugriff mit Identity and Access Management steuern.

  2. Machen Sie sich mit den allgemeinen Konzepten von Benachrichtigungsrichtlinien, MQL und Codeeditor vertraut. Weitere Informationen finden Sie unter folgenden Links:

Compute Engine-Instanz erstellen

Erstellen Sie eine Compute Engine-Instanz, um eine Google Cloud-Ressource zum Erfassen von Messwerten zu haben:

  1. Wählen Sie im Menü der Google Cloud Console die Option Compute Engine aus.

    Benutzeroberfläche zum Auswählen einer Compute-Instanz.

  2. Wählen Sie Instanz erstellen aus und klicken Sie dann auf Erstellen.

Code-Editor aufrufen

So beginnen Sie mit der Verwendung von MQL:

  1. Rufen Sie in der Google Cloud Console die Seite Metrics Explorer auf.

    Zum Metrics Explorer

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Klicken Sie in der Symbolleiste des Bereichs "Query Builder" auf die Schaltfläche  MQL oder  PromQL.
  3. Prüfen Sie, ob MQL im Schalter Sprache ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.

Mit dem Code-Editor können Sie MQL-Abfragen erstellen, testen und ausführen.

Abfrage ausführen und Diagramm erstellen

Erstellen Sie eine Abfrage, mit der die CPU-Auslastung Ihrer Instanz dargestellt wird:

  1. Fügen Sie die folgende Abfrage in den Code-Editor ein:

    fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
| {
    top 1, max(val())
  ;
    bottom 1, min(val())
  }
| union

    Diese Abfrage wählt die Zeitachse mit der maximalen und minimalen CPU-Auslastung für die Diagrammerstellung aus. Weitere Informationen zu dieser Abfrage finden Sie unter Auswahlen mit union kombinieren.

  2. Klicken Sie auf Abfrage ausführen. Das Diagramm zeigt zwei Zeilen mit der maximalen und minimalen CPU-Auslastung der Instanz an:

    Das Diagramm zeigt die maximale und minimale CPU-Auslastung.

  3. Klicken Sie zum Speichern des Diagramms auf Diagramm speichern. Geben Sie dem Diagramm einen Namen und fügen Sie es entweder einem vorhandenen oder einem neuen Dashboard hinzu. Klicken Sie dann auf Speichern.

Auf das Diagramm kann über die Seite Monitoring-Übersicht zugegriffen werden. Wenn Sie es in einem Dashboard gespeichert haben, rufen Sie die Seite dieses Dashboards auf.

Abfragebasierte Benachrichtigung einrichten

Sie können eine Benachrichtigungsrichtlinie erstellen, die die Ergebnisse einer Abfrage überwacht. Führen Sie die folgenden Schritte aus, um eine Benachrichtigungsrichtlinie zu erstellen:

  1. Rufen Sie in der Google Cloud Console die Seite  Benachrichtigungen auf:

    Zu Benachrichtigungen

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Klicken Sie auf der Seite Benachrichtigungen auf Benachrichtigungskanäle bearbeiten. In diesem Schritt konfigurieren Sie eine E-Mail-Adresse für den Empfang von Benachrichtigungen.

    1. Wechseln Sie auf der Seite Benachrichtigungskanäle zu E-Mail und klicken Sie auf Neu hinzufügen.

    2. Geben Sie die E-Mail-Adresse, an die Benachrichtigungen gesendet werden sollen, im Feld E-Mail-Adresse ein.

    3. Geben Sie im Feld Anzeigename eine kurze Beschreibung dieses Kanals ein, z. B. "Alert on-call".

    4. Klicken Sie auf Speichern.

    5. Kehren Sie zur Seite Benachrichtigungen zurück, indem Sie im Seitenheader auf Zurück klicken.

  3. Klicken Sie auf der Seite Benachrichtigungen auf Richtlinie erstellen.

    Auf dieser Seite werden Sie durch die Schritte zum Erstellen einer Benachrichtigungsrichtlinie geführt:

    1. Beschreiben, zu was benachrichtigt werden soll.
    2. Informationen zur Behebung dieses Problems bereitstellen.
    3. Benachrichtigungskanal für Benachrichtigung angeben.

  4. Um zu beschreiben, worüber Sie benachrichtigt werden möchten, klicken Sie auf Neue Bedingung. Dadurch wird der formularbasierte Bedingungseditor aufgerufen.

    1. Wählen Sie unter Richtlinienkonfigurationsmodus die Option Codeeditor (MQL oder PromQL) aus.

    2. Prüfen Sie, ob MQL im Schalter Sprache ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.

    3. Geben Sie im Codeeditor die Abfrage ein, mit der die Daten ausgewählt werden, die Sie überwachen möchten. Die folgende Abfrage löst eine Benachrichtigung aus, wenn die CPU-Nutzungszeit Ihrer Instanz länger als 20 Sekunden bleibt:

      fetch gce_instance::compute.googleapis.com/instance/cpu/usage_time
| window 1m
| condition val() > 20 's'

      Mit dem Vorgang condition wird der Leistungsschwellenwert festgelegt, über den Sie Benachrichtigungen senden möchten. Weitere Informationen zu condition und anderen Benachrichtigungsvorgängen finden Sie in der MQL-Referenz unter Benachrichtigungen.

      Wenn Automatisch ausführen aktiviert ist, werden im MQL-Diagramm die ausgewählten Daten und eine Schwellenwertlinie angezeigt:

      Diagramm für eine Abfrage mit Benachrichtigungsbedingungen

    4. Klicken Sie auf Weiter, um den Benachrichtigungstrigger zu konfigurieren:

      1. Wählen Sie im Menü Auslöser für Benachrichtigungen die Anzahl der Zeitachsen aus, die den Benachrichtigungsvorgang erfüllen müssen, bevor die Benachrichtigungsrichtlinie ausgelöst werden kann. Folgende Kriterien stehen zur Auswahl:

        • Eine einzelne Zeitreihe.
        • Eine bestimmte Anzahl von Zeitachsen.
        • Ein Prozentsatz der Zeitachsen.
        • Alle Zeitachsen.

      2. Optional: Maximieren Sie das Menü Erweiterte Optionen und geben Sie im Feld Trigger, wenn die Bedingung für diese Zeitspanne erfüllt ist einen Wert ein oder wählen Sie einen Wert aus.

        Dieses Feld definiert, wie lange die Bedingung erfüllt sein muss, bevor die Benachrichtigungsrichtlinie ausgelöst wird. Das Fenster für erneute Tests ist nicht dasselbe wie das in der MQL-Abfrage verwendete Ausrichtungsfenster. Weitere Informationen zur Beziehung zwischen diesen Werten finden Sie unter Ausrichtungszeitraum und Dauer.

      3. Geben Sie einen Namen für die Bedingung ein, z. B. „Einfache MQL-Bedingung“.

  5. Klicken Sie auf Weiter, um Benachrichtigungen, die Dokumentation und den Namen der Benachrichtigungsrichtlinie einzurichten.

    1. Wählen Sie den zuvor erstellten Benachrichtigungskanal aus.

    2. Wählen Sie einen Schweregrad aus.

    3. Geben Sie im Feld Dokumentation einen Text ein, der mit einer beliebigen Benachrichtigung gesendet werden soll. Dieser Text liefert den Empfängern in der Regel Informationen, die sie bei der Lösung des Problems unterstützen sollen. Geben Sie für diese Übungsaufgabe "Your CPU usage has exceeded 20 seconds" (Ihre CPU-Nutzung hat 20 Sekunden überschritten) ein.

    4. Geben Sie im Feld Name der Benachrichtigungsrichtlinie einen Namen für die Benachrichtigungsrichtlinie ein. Mit diesem Wert können Sie Benachrichtigungen von verschiedenen Benachrichtigungsrichtlinien unterscheiden.

  6. Speichern Sie die Richtlinie, indem Sie auf Richtlinie erstellen klicken.

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden.

  1. Rufen Sie in der Google Cloud Console die Seite „Identity and Access Management“ auf:

    Zu den Projekteinstellungen

  2. Klicken Sie auf Beenden und folgen Sie der Anleitung.

Nächste Schritte