SolarWinds Orion Integrationshandbuch

SolarWinds Orion-Plattformprodukte wie Network Performance Monitor (NPM) und Server & Application Monitor (SAM) bieten Netzwerk-, Leistungs-, Verfügbarkeits- und Serverüberwachung für Netzwerke mehrerer Anbieter, Linux- und Windows Server-Systeme sowie detaillierte Anwendungsleistungsüberwachungsmetriken für über 200 Anwendungen wie Apache HTTP Server, Microsoft Exchange und Oracle Database. Sowohl NPM als auch SAM ermöglichen das Auslösen und Zurücksetzen von Warnungen basierend auf benutzerdefinierten Schwellenwerten, die Vorfälle in PagerDuty auslösen und beheben können.

Wenn SolarWinds Orion eine Warnmeldung für einen Knoten, eine Komponente oder eine Anwendung erstellt, sendet es ein Ereignis an einen entsprechenden Service in PagerDuty. Dieses Ereignis löst einen neuen Vorfall im zugehörigen PagerDuty Dienst aus, oder Gruppe als Warnungen in einen bestehenden Vorfall. Diese Integration funktioniert durch das Senden von SolarWinds Orion-Warnmeldungen im JSON-Format unter Verwendung unserer Ereignisse-API .

Wenn der Knoten, die Komponente oder die Anwendung in SolarWinds einen wiederhergestellten Zustand erreicht, wird ein Lösungsereignis an den PagerDuty Dienst gesendet, um den Alarm und den damit verbundenen Vorfall bei diesem Dienst zu beheben.

Kompatibilität

PagerDuty Integrationen erfordern eine Manager-Basisrolle oder höher für die Kontoautorisierung. Wenn Sie diese Rolle nicht haben, wenden Sie sich bitte an einen Administrator oder Kontoinhaber in Ihrer Organisation, um die Integration zu konfigurieren.

Dieser Leitfaden und der HTTP-Anforderungstext wurden auf Windows Server 2012 R2 mit SolarWinds Orion-Plattform 2015.1, 2016.1, 2018.4 und 2019.2 geschrieben und getestet. Bitte beachten Sie unsere Legacy-Integrationshandbuch für SolarWinds NPM wenn Sie eine ältere Version von NPM haben. Frühere Versionen von SAM/APM und SolarWinds-Produkten, die nicht die Orion-Plattform verwenden, können so konfiguriert werden, dass sie Warnmeldungen an PagerDuty senden, indem sie E-Mail-Integration stattdessen.

In PagerDuty

Es gibt zwei Möglichkeiten, SolarWinds Orion in PagerDuty zu integrieren: über Global Event Routing oder direkt über eine Integration in einen PagerDuty Dienst.

Wenn Sie SolarWinds Orion in einen vorhandenen PagerDuty Dienst integrieren, fahren Sie mit dem Abschnitt „Integrieren in einen PagerDuty Dienst“ dieses Handbuchs fort.

Integration mit globalem Event Routing

Durch die Integration mit Global Event Routing können Sie Ereignisse basierend auf der Nutzlast des Ereignisses von SolarWinds Orion an bestimmte Dienste weiterleiten. Wenn Sie mehr erfahren möchten, lesen Sie bitte unseren Artikel über Globales Ereignisrouting .

1. Von dem Automatisierung wählen Sie Veranstaltungsregeln und klicken Sie auf Standardmäßiger globaler Regelsatz .
2. Klicken Sie im Bildschirm „Ereignisregeln“ auf den Pfeil neben Eingehende Ereignisquelle , um die Informationen zum Integrationsschlüssel anzuzeigen. Kopieren Sie Integrationsschlüssel und bewahren Sie es zur späteren Verwendung an einem sicheren Ort auf. Wenn Sie die Einrichtung der Integration in SolarWinds Orion abgeschlossen haben, kehren Sie zu dieser Schnittstelle zurück, um anzugeben, wie Ereignisse von SolarWinds Orion an Dienste in PagerDuty weitergeleitet werden sollen.

Notiz : Wenn Ihr Team bereits integriert hat mit Globales Ereignisrouting , können Sie dies überprüfen, indem Sie in einer vorhandenen Konfigurationsdatei nach dem PagerDuty Event Rules Integration Key (zu finden in den Schritten 1 und 2 oben) suchen. Sie können dann die vorhandene Integration verwenden und SolarWinds Orion-Ereignisse in Ihren Dienst leiten, indem Sie neue globale Ereignisregeln für Ihren Dienst schreiben.

Sie können jetzt mit dem Abschnitt „In SolarWinds Orion“ dieses Handbuchs fortfahren.

 

Integration mit einem PagerDuty Dienst

Die direkte Integration mit einem PagerDuty Dienst kann von Vorteil sein, wenn Sie keine Warnmeldungen von SolarWinds Orion basierend auf der Ereignisnutzlast an verschiedene Responder weiterleiten müssen. Sie können weiterhin Service-Level-Ereignisregeln um Aktionen wie das Unterdrücken nicht umsetzbarer Warnungen und das Anpassen des Schweregrads durchzuführen.

1. Von dem Dienstleistungen wählen Sie Serviceverzeichnis .
2. Wenn Sie Ihre Integration zu einem bestehenden Dienst hinzufügen , klicken Sie auf den Namen des Dienstes, zu dem Sie die Integration hinzufügen möchten. Wählen Sie dann die Registerkarte „Integrationen“ und klicken Sie auf das Eine neue Integration hinzufügen Wenn Sie einen neuen Dienst für Ihre Integration erstellen, lesen Sie bitte unsere Dokumentation im Abschnitt Konfigurieren von Diensten und Integrationen und befolgen Sie die Schritte im Neuen Dienst erstellen Abschnitt.
3. Wählen Sie SolarWinds Orion aus dem Integrationstyp Speisekarte.
4. Klicken Integration hinzufügen Schaltfläche, um Ihre neue Integration zu speichern. Sie werden zur Registerkarte „Integrationen“ für Ihren Dienst weitergeleitet.
5. Suchen Sie Ihre Integration in der Liste und klicken Sie rechts auf ∨. Integrationsschlüssel wird auf diesem Bildschirm generiert. Bewahren Sie diesen Schlüssel an einem sicheren Ort auf, da er verwendet wird, wenn Sie im nächsten Abschnitt die Integration mit SolarWinds Orion konfigurieren.

Auf Ihrem SolarWinds-Server

1. Melden Sie sich als Administrator bei SolarWinds an und gehen Sie dann zu Einstellungen und wählen Sie Alle Einstellungen (oder klicken Sie auf Einstellungen in der oberen rechten Ecke der Seite, wenn Sie eine ältere Version von SolarWinds haben). Klicken Sie auf Verwalten benutzerdefinierter Eigenschaften unter dem Abschnitt „Knoten- und Gruppenverwaltung“.
   
   
   
2. Klicken Benutzerdefinierte Eigenschaft hinzufügen .  
3. Wählen Knoten und klicken Sie auf Nächste .  
4. Legen Sie die Name des Anwesens zu „PDIntegrationKey“ und legen Sie optional eine Beschreibung , z. B. „PagerDuty Integration“, und klicken Sie dann auf Nächste .  
5. Klicken Knoten auswählen und markieren Sie alle Knoten in der Spalte Verfügbare Knoten, für die Sie in PagerDuty Benachrichtigungen erhalten möchten. Klicken Sie auf Hinzufügen , um die Knoten in die Spalte Ausgewählte Knoten zu verschieben, und klicken Sie dann auf Knoten auswählen .  
6. Fügen Sie den zuvor kopierten PagerDuty Integrationsschlüssel in das Feld unter Den ausgewählten Knoten einen Wert für „PDIntegrationKey“ zuweisen , dann klick Einreichen .  
7. Laden Sie die Beispielwarnungen herunter und speichern Sie sie an einem beliebigen Ort auf Ihrer Workstation oder Ihrem SolarWinds-Server.
   • Beispielwarnungen
8. Extrakt Beispiel Alerts.zip auf Ihrer Workstation oder Ihrem SolarWinds-Server (also auf Ihrem Desktop, Downloads Ordner oder C:\ PagerDuty\Beispielwarnungen ).
9. Navigieren Sie zurück zur Seite „Haupteinstellungen und Verwaltung“ in SolarWinds Orion, indem Sie auf Einstellungen Menü und Auswahl Alle Einstellungen (oder klicken Sie auf Einstellungen in der oberen rechten Ecke der Seite, wenn Sie eine ältere Version von SolarWinds haben). Klicken Sie auf Warnungen verwalten im Abschnitt „Warnungen und Berichte“.
   
   
   
10. Klicken Sie anschließend auf Export Import um einige der beliebtesten Alarme zu importieren, für die wir Vorlagen erstellt haben. Klicken Sie auf Importwarnung und wählen Sie die Alarmdefinitionen aus, die Sie in SolarWinds importieren möchten, aus dem extrahierten Beispielwarnungen Standort. Herzlichen Glückwunsch! SolarWinds kann jetzt Vorfälle in PagerDuty auslösen und lösen.

Testen einer Warnung

Öffnen Sie eine Warnung im SolarWinds-Panel und navigieren Sie zum Trigger-Aktion Registerkarte. Simulieren Sie die Aktion, um eine Warnung per POST zu senden. Bei Erfolg wird ein PagerDuty Vorfall ausgelöst. Wenn dies fehlschlägt, überprüfen Sie das JSON-Format und die SolarWinds-Variablen, die im HTTP-Anforderungstext verwendet werden.

Erstellen Sie Ihre eigenen Warnmeldungen

Sie können zusätzliche Alarme an PagerDuty senden, indem Sie den gewünschten Alarm auswählen und zu Trigger-Aktionen , dann fügen Sie einfach eine Aktion hinzu mit dem Protokollieren Sie den Alarm in einer Datei Option. Die Datei sollte protokolliert werden in C:\ PagerDuty\Warteschlange mit einem .txt Dateierweiterung, und der Inhalt sollte JSON sein, das für unsere formatiert ist Ereignisse-API . Sehen Sie sich die von uns bereitgestellten Alarmdefinitionen an, um Beispiele dafür zu erhalten, wie Sie Ihre eigenen Alarme schreiben, die an PagerDuty gesendet werden sollen.

Spezielle Charaktere: Sie müssen Anführungszeichen in der Alarmvorlage vermeiden. Diese führen zu einer Zeichenfolgenbeendigung in der Ausgabe, was zu einer ungültigen JSON-Syntax führt, was dazu führt, dass die Ereignisse nicht an die Events-API übermittelt werden. Wenn Sie Anführungszeichen in die Vorlage einfügen müssen, wird dringend empfohlen, geschwungene Anführungszeichen zu verwenden, d. h. ” Und „ , statt einfacher Anführungszeichen ( „ ).

FAQ

Kann ich Vorfälle bei mehreren PagerDuty Diensten auslösen?

Ja! Gehen Sie einfach zur Detailseite des Knotens, der Vorfälle auf einem anderen PagerDuty Dienst auslösen soll, scrollen Sie nach unten zum Abschnitt „Benutzerdefinierte Eigenschaften“ und klicken Sie dann auf Benutzerdefinierte Eigenschaftswerte bearbeiten , um einen anderen Wert festzulegen für PDIntegrationKey auf diesem Knoten. Sie müssen Ihre Alarme nicht ändern (es sei denn, Sie haben den Integrationsschlüssel für Ihre benutzerdefinierten Alarme fest codiert), da die von uns bereitgestellten Vorlagen eine SQL-Abfrage verwenden, um den Integrationsschlüssel aus dieser benutzerdefinierten Eigenschaft auf jedem Knoten abzurufen.

 

Warum wird mein Alarm nicht ausgelöst?

Versuchen Sie zunächst, die Warnung zu ändern Auslösebedingungen auf etwas, das gegenwärtig wahr ist, um sicherzugehen, dass das Problem nicht darin besteht, dass die Auslösebedingungen nicht erfüllt werden. Wenn Sie nach dem Versuch sehen, „Dieser Alarm wird sofort bei 0 Objekten im Alarmbereich ausgelöst.“ im Finale Zusammenfassung Schritt über die Einreichen Wenn Sie auf die Schaltfläche klicken, obwohl Sie wissen, dass die Bedingungen, die Sie unter „Auslösebedingungen“ eingegeben haben, derzeit erfüllt sind, ist wahrscheinlich ein bestimmter Fehler der Übeltäter. Manchmal können SolarWinds-Warnungen beschädigt werden und müssen durch eine neue Warnung ersetzt werden. Um das Problem zu beheben, erstellen Sie eine neue Warnung von Grund auf mit allen Auslösebedingungen, Aktionen usw., die mit der ursprünglichen Warnung identisch sind. Am Ende Zusammenfassung Schritt sollten Sie dann eine Meldung sehen, die angibt, dass der neue Alarm für mindestens ein Objekt ausgelöst wird. Nachdem Sie den neuen Alarm gespeichert haben, können Sie den ursprünglichen, beschädigten Alarm entfernen.

 

Warum erhalte ich beim Testen/Simulieren der Aktion immer einen HTTP-Fehler?

Wenn Sie beim Versuch, einen Trigger zu simulieren oder eine Aktion für eine Warnung auszuführen, die Meldung „HTTP-Anforderung konnte nicht ausgeführt werden“ erhalten, liegt dies normalerweise daran, dass weil das JSON ungültig ist oder weil die SolarWinds-Variablen nicht richtig gefüllt werden.

• Versuchen Sie, den gesamten Inhalt der Aktion einzufügen HttpRequestBody Feld in einem JSON-Validierungstool, um Formatierungsfehler zu erkennen.
• Versuchen Sie es mit einem Test, indem Sie alle SolarWinds-Variablen (z. B. ${N=SwisEntity;M=FullName}) durch Dummy-Daten ersetzen und dann erneut mit der Schaltfläche „Simulieren“ testen. Sobald Sie erfolgreich einen Testalarm/-vorfall auf PagerDuty erstellt haben, indem Sie auf simulieren Sie können bei der Aktion Variablen schrittweise wieder hinzufügen. Dies geht am einfachsten, indem Sie auf das Einfügen von Variablen Schaltfläche, während Sie die Aktion bearbeiten. Alle Variablen ohne Vorschauwert werden für den Ressourcentyp, den die betreffende Warnung überwachen soll (z. B. Knoten, Schnittstelle usw.), nicht richtig ausgefüllt.