Grafana-Events integrieren

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

    • Integrieren Sie Grafana mit Ereignismanagement, indem Sie der Grafana-Konsole einen Standard-Webhook hinzufügen.

    Vorbereitungen

    • Stellen Sie sicher, dass das Plugin Ereignismanagement „ Connectors (sn_em_connector)“ in der Instanz Now Platform installiert ist.
    • Das Plugin „Ereignismanagement“ muss in der Now Platform-Instanz installiert sein.
    • Die CI-Bindung erfolgt über die IP, Instanzen müssen als Server erkannt werden, um die Bindung zu initiieren. Über die Cloud erkannte CIs oder CIs in „cmdb_ci_vm_object“ werden nicht gebunden, da Grafana keine Informationen für Objekt-IDs bereitstellt.
    • Erforderliche Rolle: evt_mgmt_integration

    Warum und wann dieser Vorgang ausgeführt wird

    Konfigurieren Sie die Ereignismanagement-Umgebung für die Erfassung von Events aus Grafana. Legen Sie in Ihrer Grafana-Konsole die Now Platform-Instanz mithilfe eines Standard-Webhook als REST-Endpunkt fest.

    Hinweis:
    Führen Sie die Schritte 1 und 2 für Grafana v7.4.3 aus. Für Grafana v9.3.2. fahren Sie mit Schritt 3 fort.

    Prozedur

    Grafana v7.4.3
    1. Erstellen Sie in Ihrer Grafana-Konsole einen Benachrichtigungskanal.
      1. Navigieren zu Warnung > Benachrichtigungskanäle.
      2. Klicken Sie auf Neuer Kanal, und wählen Sie als Typ Webhook aus.
      3. Geben Sie eine URL ein.
        Verwenden Sie beispielsweise https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=grafana.
      4. Wählen Sie unter Optionale WebHook- Einstellungen die HTTP-Methode POSTaus, und geben Sie Anwendername und Passwort des entsprechenden -Benutzers ServiceNow ein.
        Hinweis:
        Stellen Sie sicher, dass dem ausgewählten Benutzer die Rolle „evt_mgmt_integration“ zugewiesen ist. Um eine ordnungsgemäße Authentifizierung sicherzustellen, verwenden Sie den Benutzer mit den geringsten Berechtigungen mit der Rolle evt_mgmt_integration anstelle eines Benutzers mit hohen Berechtigungen.
      5. Klicken Sie auf Test, um die Verbindung zu testen.
    2. Erstellen Sie in der Grafana-Konsole Warnungsregeln.
      1. Klicken Sie im erforderlichen Bereich auf Bearbeiten und dann auf Warnung erstellen.
      2. Fügen Sie auf der Registerkarte Warnung die folgenden Tags hinzu:
        Tags Beschreibung
        Schweregrad (Dieses Tag ist optional und muss in Kleinbuchstaben angegeben werden.) Schweregrad, mit dem die Warnung erstellt werden muss.
        Anzahl (Dieses Tag ist erforderlich, andernfalls werden die Warnungen in ServiceNownicht automatisch geschlossen.) Anzahl der Geräte, Hosts oder Server, die von dieser Warnungsregel überwacht werden.
      3. Fügen Sie den Benachrichtigungskanal unter Benachrichtigungen in der Warnungsregel hinzu.
      4. Klicken Sie auf Speichern.
      5. Navigieren zu Warnung > Warnungsregeln um auf die erstellte Regel zuzugreifen.
    Grafana v9.3.2.
    1. Erstellen Sie in der Grafana-Konsole einen Kontaktpunkt.
      1. Navigieren zu Warnung > Kontaktpunkte.
      2. Klicken Sie auf Neuer Kontaktpunkt, geben Sie einen Namen ein, und wählen Sie Webhookals Typ aus.
      3. Geben Sie eine URL ein.
        Verwenden Sie beispielsweise https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=grafana.
      4. Wählen Sie unter Optionale WebHook- Einstellungen die HTTP-Methode POSTaus, und geben Sie Anwendername und Passwort des entsprechenden -Benutzers ServiceNow ein.
        Hinweis:
        Stellen Sie sicher, dass dem ausgewählten Benutzer die Rolle „evt_mgmt_integration“ zugewiesen ist. Um eine ordnungsgemäße Authentifizierung sicherzustellen, verwenden Sie den Benutzer mit den geringsten Berechtigungen mit der Rolle evt_mgmt_integration anstelle eines Benutzers mit hohen Berechtigungen.
      5. Klicken Sie auf Speichern und testen, um die Verbindung zu überprüfen.
    2. Erstellen Sie in der Grafana-Konsole eine Benachrichtigungsrichtlinie.
      1. Navigieren zu Warnung > Benachrichtigungsrichtlinien.
      2. Wählen Sie Neue Richtlinieaus, und fügen Sie Matcher hinzu.
        Matcher sind Bezeichnungen, die Warnungsregeln an den Kontaktpunkt weiterleiten.
      3. Wählen Sie Ihren Kontaktpunkt aus.
      4. Wählen Sie Richtlinie speichernaus.
    3. Erstellen Sie in der Grafana-Konsole Warnungsregeln.
      1. Navigieren zu Warnung > Warnungsregel.
      2. Wählen Sie Neue Regelaus.
      3. Legen Sie die Abfrage- und Warnungsbedingung fest.
      4. Legen Sie die Datenquelle, Metriken und die erforderlichen Filter fest.
      5. Legen Sie das Verhalten der Warnungsauswertung fest.
      6. Geben Sie den Regelnamen ein.
      7. Fügen Sie im Abschnitt „Zusammenfassung und Anmerkungen“ eine Zusammenfassung oder eine Beschreibung hinzu.
      8. Wählen Sie im Bildlauf nach unten +Neu hinzufügen aus.
      9. Geben Sie die Knoten-, Ressourcen- und Metrikinformationen ein.
        Diese Informationen sind für die Felder „node“, „resource“ und „metric_name“ für das Ereignis erforderlich.
        Hinweis:
        Verwenden Sie die Wertzeichenfolge, um diese Werte zu übergeben. Ein Knoten kann beispielsweise {{$values.C0.Labels.instance }} sein.
      10. Geben Sie unter anwenderdefinierte Bezeichnungen die erforderlichen Bezeichnungen an, um Ihre Benachrichtigungen an den entsprechenden Kontaktpunkt zu leiten.
        Hinweis:
        Sie können den Schweregrad auch unter anwenderdefinierten Bezeichnungen übergeben. Dasselbe wird für Ereignisse verwendet. Die verfügbaren Schweregradoptionen sind: kritisch, schwerwiegend, geringfügig, Warnung.
      11. Klicken Sie auf Speichern.

    Ergebnisse

    Die Übertragung von Warnungen von Grafana in das Plugin Event Management beginnt. Das Plugin extrahiert Informationen aus der ursprünglichen Grafana-Warnmeldung, um die erforderlichen Event-Felder zu füllen, und fügt das Event in die Datenbank ein. Navigieren Sie in Ihrer Now Platform-Instanz zu Alle Ereignisse, um die Events anzuzeigen.

    Hinweis:
    • Für Grafana v7.4.3 sehen Sie möglicherweise zusätzliche Löschereignisse in ServiceNow, die nicht an eine Warnung gebunden sind. Ignorieren Sie sie, da sie erstellt wurden, um das Problem zu beheben, dass Grafana keine Informationen in der eindeutigen Benachrichtigung sendet.
    • Ein Schweregradparameter wird hinzugefügt, der nur für Grafana 8 und höher verwendet wird. Der angegebene Wert wird als Schweregrad für ein Ereignis verwendet, wenn der Schweregrad nicht in anwenderdefinierten Bezeichnungen übergeben wird.