Abfragebasierte Benachrichtigung mithilfe von MQL einrichten

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 verwenden möchten, 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. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

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

4. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

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 dem Codeeditor vertraut. Weitere Informationen finden Sie unter folgenden Links:

   • Benachrichtigungen – Übersicht
   • Benachrichtigungsrichtlinien mit MQL
   • Codeeditor für MQL verwenden

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.

   

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

Hinweis: Wenn Sie Probleme beim Erstellen einer Instanz haben, lesen Sie die Kurzanleitung zur Verwendung einer Linux-VM.

Code-Editor aufrufen

So beginnen Sie mit der Verwendung von MQL:

1. Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend  Metrics Explorer aus:

   Zum Metrics Explorer

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 Codeeditor MQL-Abfragen erstellen, testen und ausführen

Abfrage ausführen und Diagramm erstellen

Erstellen Sie eine Abfrage, die die CPU-Auslastung Ihrer Instanz darstellt:

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:

   

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. Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend  Benachrichtigungen aus:

   Zu Benachrichtigungen

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. Klicken Sie auf der Seite Benachrichtigungskanäle auf E-Mail und dann 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. Klicken Sie auf Neue Bedingung, um zu beschreiben, worüber Sie eine Benachrichtigung erhalten möchten. 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 die Abfrage ein, mit der die Daten ausgewählt werden, die Sie im Codeeditor überwachen möchten. Die folgende Abfrage löst eine Benachrichtigung aus, wenn die CPU-Nutzungszeit Ihrer Instanz über 20 Sekunden liegt:

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

      Der Vorgang condition legt den Leistungsschwellenwert fest, für den Sie Benachrichtigungen senden möchten. Weitere Informationen zu condition und anderen Benachrichtigungsvorgängen finden Sie unter Benachrichtigungen in der MQL-Referenz.

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

      

   4. Klicken Sie auf Weiter, um den Trigger für Benachrichtigungen zu konfigurieren:

      1. Wählen Sie im Menü Benachrichtigungsauslöser die Anzahl der Zeitreihen aus, die dem Benachrichtigungsvorgang entsprechen müssen, bevor die Benachrichtigungsrichtlinie ausgelöst werden kann. Sie können aus den folgenden Kriterien auswählen:

         • 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 Auslösen, wenn die Bedingung für diese Zeitspanne erfüllt ist einen Wert ein oder wählen Sie einen Wert aus.

         In diesem Feld wird definiert, wie lange die Bedingung erfüllt sein muss, bevor die Benachrichtigungsrichtlinie ausgelöst wird. Das Testfenster 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 over 20 seconds“ (Ihre CPU-Auslastung 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

• Weitere Informationen zur Verwendung des Code-Editors
• Sehen Sie sich eine Reihe von MQL-Beispielen an.
• Weitere Informationen zu MQL-basierten Benachrichtigungsrichtlinien
• MQL-Abfragen über die Cloud Monitoring API aufrufen
• Lesen Sie die Details zu MQL in der MQL-Referenz.
• Lesen Sie unsere Ressourcen zu DevOps und informieren Sie sich über das DORA-Forschungsprogramm.