Abfragebasierte Benachrichtigung mithilfe von MQL einrichten

Abfragebasierte Benachrichtigung mithilfe von MQL einrichten

In diesem Dokument erfahren Sie, wie Sie Messwerte, Diagramme erstellen und eine abfragebasierte Benachrichtigung in der Google Cloud Console einrichten. Wenn Sie die Cloud Monitoring API bevorzugen, finden Sie unter 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. Abfragebasierte Benachrichtigung einrichten

Hinweis

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

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

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

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

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

   Weitere Informationen zu Cloud Monitoring-Rollen Siehe Zugriff mit Identity and Access Management steuern.

2. Machen Sie sich mit den allgemeinen Konzepten von Benachrichtigungsrichtlinien, MQL und im Code-Editor. Weitere Informationen finden Sie unter folgenden Links:

   • Benachrichtigungen
   • 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 den Schnellstart mit einer Linux-VM.

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 Zeitreihe mit der maximalen und minimalen CPU aus für die Diagrammerstellung. 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. 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. Gehen Sie auf der Seite Benachrichtigungskanäle zu E-Mail und Klicken Sie auf 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. Diese Aktion öffnet den formularbasierten Bedingungseditor.

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

   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 zu überwachenden Daten ausgewählt werden. Code-Editor verwenden. Die folgende Abfrage löst eine Benachrichtigung aus, wenn die Die CPU-Nutzungszeit bleibt länger als 20 Sekunden:

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

      Mit dem Vorgang condition wird der gewünschte Leistungsschwellenwert festgelegt. für die Benachrichtigungen aktiviert werden soll. Weitere Informationen zu condition und andere Benachrichtigungsvorgänge finden Sie unter Benachrichtigungen in der MQL-Referenz.

      Wenn Automatisch ausführen aktiviert ist, zeigt das MQL-Diagramm zeigt die ausgewählten Daten und eine Grenzwertlinie an:

      

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

      1. Wählen Sie im Menü Auslöser für Benachrichtigungen die Anzahl der Zeitreihen aus. die den Benachrichtigungsvorgang erfüllen muss, bevor Richtlinie 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 wählen Sie im Menü Auslösen, wenn die Bedingung für diesen Zeitraum erfüllt ist einen Wert eingeben oder auswählen.

         In diesem Feld wird definiert, wie lang die Bedingung sein muss bevor die Benachrichtigungsrichtlinie ausgelöst wird. Die Das Fenster für den erneuten Test ist nicht dasselbe. als 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. „Grundlegende MQL-Bedingung“.

5. So richten Sie Benachrichtigungen, die Dokumentation und die Benachrichtigungsrichtlinie ein auf Weiter.

   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. Bei dieser Übung 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 in dieser Anleitung 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 Codeeditors
• 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.