Integrieren Sie Grafana-Ereignisse

Integrieren Sie Grafana mit EreignismanagementDurch Hinzufügen eines Standard-Webhooks in der Grafana-Konsole.

Vorbereitungen

• Stellen Sie sicher, dass EreignismanagementPlugin „Connectors“ (sn_em_Connector) ist auf installiert Now PlatformInstanz.
• Die EreignismanagementPlugin muss auf installiert sein Now PlatformInstanz.
• Die CI-Bindung erfolgt über die IP. Instanzen sollten als Server erkannt werden, um die Bindung zu initiieren. CIs, die über die Cloud oder CIs in erkannt wurden cmdb_ci_vm_object Nicht begrenzt werden, da Grafana keine Informationen für Objekt-IDs bereitstellt.
• Erforderliche Rolle: evt_mgmt_integration

Warum und wann dieser Vorgang ausgeführt wird

Konfigurieren Sie EreignismanagementUmgebung für die Sammlung von Ereignissen aus Grafana. Legen Sie in Ihrer Grafana-Konsole fest Now PlatformInstanz als Rest-Endpunkt mit einem Standard-Webhook.

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 Warnungen Werden Ausgegeben > Benachrichtigungskanälean.
   2. Klicken Sie Auf Neuer Kanal Und wählen Sie den Typ als aus Webhook .
   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. Unter Optionaler Webhook Einstellungen, wählen Sie die HTTP-Methode aus, VERÖFFENTLICHEN , Und geben Sie den Anwendernamen und das Passwort des entsprechenden ein ServiceNowAnwender.
      Hinweis:

      Stellen Sie sicher, dass dem ausgewählten Anwender die Rolle „evt_mgmt_Integration“ zugewiesen ist. Um eine ordnungsgemäße Authentifizierung sicherzustellen, verwenden Sie den Anwender mit den geringsten Berechtigungen mit der Rolle „evt_mgmt_Integration“ und nicht einen Anwender mit hohen Berechtigungen.
   5. Klicken Sie Auf Testen Zum Überprüfen der Verbindung.
2. Erstellen Sie in der Grafana-Konsole Warnungsregeln.
   1. Klicken Sie Auf Bearbeiten Im erforderlichen Bereich und dann Warnung Erstellen .
   2. In Warnung Fügen Sie die folgenden Tags hinzu:

      Tags	Beschreibung
      Schweregrad	(Dieses Tag ist optional und muss in Kleinbuchstaben platziert werden.) Schweregrad, mit dem die Warnung erstellt werden muss.
      Anzahl	(Dieses Tag ist erforderlich, andernfalls werden die Warnungen in nicht automatisch geschlossen ServiceNow.) Die Anzahl der Geräte, Hosts oder Server, die von dieser Warnungsregel überwacht werden.

   3. Fügen Sie den Benachrichtigungskanal unter hinzu Benachrichtigungen In der Warnungsregel.
   4. Klicken Sie auf Speichern.
   5. Navigieren zu Warnungen Werden Ausgegeben > Warnungsregeln Um auf die erstellte Regel zuzugreifen.

Grafana v9.3.2.

3. Erstellen Sie in der Grafana-Konsole einen Kontaktpunkt.
   1. Navigieren zu Warnungen Werden Ausgegeben > Kontaktpunktean.
   2. Klicken Sie Auf Neuer Kontaktpunkt Geben Sie einen Namen ein, und wählen Sie den Typ als aus Webhook .
   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. Unter Optionaler Webhook Einstellungen, wählen Sie die HTTP-Methode aus, VERÖFFENTLICHEN , Und geben Sie den Anwendernamen und das Passwort des entsprechenden ein ServiceNowAnwender.
      Hinweis:

      Stellen Sie sicher, dass dem ausgewählten Anwender die Rolle „evt_mgmt_Integration“ zugewiesen ist. Um eine ordnungsgemäße Authentifizierung sicherzustellen, verwenden Sie den Anwender mit den geringsten Berechtigungen mit der Rolle „evt_mgmt_Integration“ und nicht einen Anwender mit hohen Berechtigungen.
   5. Klicken Sie Auf Speichern Und Testen Zum Überprüfen der Verbindung.
4. Erstellen Sie in der Grafana-Konsole eine Benachrichtigungsrichtlinie.
   1. Navigieren zu Warnungen Werden Ausgegeben > Benachrichtigungsrichtlinienan.
   2. Wählen Sie Aus Neue Richtlinie , Fügen Sie Matcher hinzu.
      Übereinstimmungen sind Bezeichnungen, die Warnungsregeln an den Kontaktpunkt weiterleiten.
   3. Wählen Sie Ihren Kontaktpunkt aus.
   4. Wählen Sie Aus Richtlinie Speichern .
5. Erstellen Sie in der Grafana-Konsole Warnungsregeln.
   1. Navigieren zu Warnungen Werden Ausgegeben > Warnungsregelan.
   2. Wählen Sie Aus Neue Regel .
   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 Beschreibung hinzu.
   8. Wählen Sie im Bildlauf nach unten die Option aus +Neu Hinzufügen .
   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 anwenderdefinierten 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, gering, Warnung.
   11. Klicken Sie auf Speichern.

Ergebnisse

Warnungen fließen von Grafana in das Ereignismanagement-Plugin. Das Plugin extrahiert Informationen aus der ursprünglichen Grafana-Warnungsnachricht, um die erforderlichen Ereignisfelder auszufüllen, und fügt das Ereignis in die Datenbank ein. In Ihrem Now PlatformInstanz, navigieren Sie zu Alle Ereignisse Um die Ereignisse anzuzeigen.

Hinweis:

• Für Grafana v7.4.3 werden möglicherweise zusätzliche klare Ereignisse angezeigt ServiceNowDie nicht an eine Warnung gebunden sind. Ignorieren Sie sie, da sie erstellt wurden, um das Problem zu beheben, dass Grafana keine Informationen in der Benachrichtigung zum Löschen 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.

• Integrieren Sie Grafana mit REST API-Schlüssel-Token
  Integrieren Sie mithilfe eines API-Schlüssels, um eine sichere Kommunikation herzustellen und den Datenaustausch über die REST-API zu automatisieren. Dies vereinfacht die Integration, ermöglicht einen nahtlosen Zugriff auf Services und verbessert die betriebliche Effizienz.