Grafana-Events integrieren

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

Vorbereitungen

• Stellen Sie sicher, dass Ereignismanagement Plugin „Connectors“ (sn_em_Connector) ist auf installiert ServiceNow AI Platform Instanz.
• Das Plugin „Ereignismanagement“ muss in der ServiceNow AI 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 oder CIs in erkannte CIs 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 die Ereignismanagement-Umgebung für die Erfassung von Events aus Grafana. Legen Sie in Ihrer Grafana-Konsole die ServiceNow AI 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 Warnungen > Benachrichtigungskanälean.
   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. Unter Optionaler Webhook Einstellungen, wählen Sie die HTTP-Methode aus, VERÖFFENTLICHEN , Und geben Sie den Anwendernamen und das Passwort des entsprechenden ein ServiceNow Anwender.
      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 kleinerer Groß-/Kleinschreibung liegen.) 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 Benachrichtigungen in der Warnungsregel hinzu.
   4. Klicken Sie auf Speichern.
   5. Navigieren zu Warnungen > Warnungsregeln Um auf die erstellte Regel zuzugreifen.

Grafana v9.3.2.

3. Erstellen Sie in der Grafana-Konsole einen Kontaktpunkt.
   1. Navigieren zu Warnungen > Kontaktpunktean.
   2. Klicken Sie Auf Neuer Kontaktpunkt Geben Sie einen Namen ein, und wählen Sie den Typ 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 ServiceNow Anwender.
      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 Dient zum Überprüfen der Verbindung.
4. Erstellen Sie in der Grafana-Konsole eine Benachrichtigungsrichtlinie.
   1. Navigieren zu Warnungen > 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 > 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 Scrollen nach unten aus +Neu Hinzufügen .
   9. Geben Sie den Knoten, die Ressource und die Metrikinformationen ein.
      Diese Informationen sind für die Felder „Knoten“, „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, 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 ServiceNow AI Platform-Instanz zu Alle Ereignisse, um die Events anzuzeigen.

Hinweis:

• Für Grafana v7.4.3 werden möglicherweise zusätzliche klare Ereignisse angezeigt, die in eingehen 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.

• 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.