Grafana-Events integrieren

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 den optionalen WebHook- Einstellungen die HTTP-Methode POSTaus, und geben Sie den Benutzernamen und das Passwort des entsprechenden ServiceNow -Benutzers 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.) Die Anzahl der von dieser Warnungsregel überwachten Geräte, Hosts oder Server.

   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.

3. 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 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 den optionalen WebHook- Einstellungen die HTTP-Methode POSTaus, und geben Sie den Benutzernamen und das Passwort des entsprechenden ServiceNow -Benutzers 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.
4. Erstellen Sie in der Grafana-Konsole eine Benachrichtigungsrichtlinie.
   1. Navigieren zu Warnung > Benachrichtigungsrichtlinien.
   2. Wählen Sie Neue Richtlinieaus, und fügen Sie Übereinstimmungen hinzu.
      Übereinstimmungen sind Bezeichnungen, die Warnungsregeln an den Kontaktpunkt weiterleiten.
   3. Wählen Sie Ihren Kontaktpunkt aus.
   4. Wählen Sie Richtlinie speichern aus.
5. Erstellen Sie in der Grafana-Konsole Warnungsregeln.
   1. Navigieren zu Warnung > Warnungsregel.
   2. Wählen Sie Neue Regel aus.
   3. Legen Sie die Abfrage- und Warnungsbedingung fest.
   4. Legen Sie die Datenquelle, die Metriken und die erforderlichen Filter fest.
   5. Legen Sie das Verhalten der Warnungsbewertung 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 die Option +Neu hinzufügenaus.
   9. Geben Sie die Knoten-, Ressourcen- und Metrikinformationen ein.
      Diese Informationen sind für die Felder „node“, „resource“ und „metric_name“ für das Event erforderlich.

      Hinweis:

      Verwenden Sie die Wertzeichenfolge, um diese Werte zu übergeben. Zum Beispiel kann ein Knoten {{ $values.C0.Labels.instance }} sein.
   10. Geben Sie unter benutzerdefinierte Bezeichnungen die erforderlichen Bezeichnungen an, um Ihre Benachrichtigungen an den entsprechenden Kontaktpunkt weiterzuleiten.
       Hinweis:

       Sie können den Schweregrad auch unter benutzerdefinierten Bezeichnungen übergeben. Dasselbe wird für Events verwendet. Verfügbare Schweregradoptionen: „Kritisch“, „Schwerwiegend“, „Gering“, „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 werden in ServiceNow möglicherweise zusätzliche eindeutige Events angezeigt, 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 Event verwendet, wenn der Schweregrad nicht in benutzerdefinierten Bezeichnungen übergeben wird.