Riemann-Integrationsleitfaden

Riemann aggregiert Ereignisse Ihrer Server und Anwendungen mithilfe einer leistungsstarken Stream-Processing-Sprache. Riemann kann Sie über Ausnahmen in Ihrem Code benachrichtigen, die Latenzverteilung Ihrer Webanwendung verfolgen, die Top-Prozesse auf jedem Host nach Speicher- und CPU-Auslastung anzeigen, Warnungen senden, wenn ein wichtiger Prozess sich nicht meldet, die Anzahl der Benutzer ermitteln, die sich in diesem Moment angemeldet haben, und vieles mehr.

In PagerDuty

1. Gehe zu Konfiguration Menü und auswählen Dienstleistungen Die

2. Auf der Seite „Dienste“:

   • Wenn Sie einen neuen Dienst für Ihre Integration erstellen, klicken Sie hier. Neuen Dienst hinzufügen Die

   • Wenn Sie Ihre Integration zu einem bestehenden Dienst hinzufügen, klicken Sie auf den Namen des Dienstes, dem Sie die Integration hinzufügen möchten. Klicken Sie anschließend auf die Schaltfläche Integrationen Tabulatortaste und klicken Sie auf Neue Integration Taste.

3. Wählen Sie Ihre App aus der Integrationstyp Speisekarte

4. Geben Sie eine Integrationsname Wenn Sie einen neuen Dienst für Ihre Integration erstellen, geben Sie in den allgemeinen Einstellungen einen Namen ein. Name für Ihren neuen Service. Geben Sie dann in den Vorfalleinstellungen Folgendes an: Eskalationsrichtlinie , Dringlichkeit der Benachrichtigung , Und Vorfallverhalten für Ihren neuen Service.

5. Klicken Sie auf Dienst hinzufügen oder Integration hinzufügen Klicken Sie auf diese Schaltfläche, um Ihre neue Integration zu speichern. Sie werden anschließend zur Integrationsseite Ihres Dienstes weitergeleitet.

6. Kopiere die Integrationsschlüssel für Ihre neue Integration.

Auf Ihrem Riemann-Server

Notiz: Diese Anleitung behandelt ausschließlich die Einrichtung des eigentlichen Riemann-Überwachungstools mit PagerDuty zur Auslösung von Vorfällen; sie beschreibt nicht die Einrichtung von Riemann-Strich Es bietet eine webbasierte Benutzeroberfläche mit Visualisierungen der Aktivitäten von Riemann. Diese Integration erfordert ein Linux-basiertes System mit aktuellen Versionen von Java und Ruby, die zur Installation von Riemann benötigt werden.

1. Bearbeiten Sie die Riemann-Konfigurationsdatei ( etc/riemann.config im Hauptverzeichnis von Riemann) um den korrekten Hostnamen für den Host festzulegen, über den Sie in PagerDuty benachrichtigt werden möchten. In diesem Beispiel verwenden wir localhost (d. h. 127.0.0.1 ):

2. Sie müssen nun die Riemann-Konfigurationsdatei bearbeiten, um Benachrichtigungen an PagerDuty zu senden. Sie können den Standardcode hinzufügen, der dort angezeigt wird. Hier Dies führt dazu, dass alle Benachrichtigungen, die sich nicht im Status „OK“ befinden, PagerDuty Vorfälle auslösen. Dies kann eine Flut von Benachrichtigungen verursachen, was wiederum zu einer Ratenbegrenzung durch die PagerDuty-Ereignis-API führt. Wir empfehlen Ihnen, eine angepasste Version am Ende Ihrer Datei hinzuzufügen. etc/riemann.config Datei, die nur unter Bedingungen ausgelöst wird, die Sie explizit festlegen:

3. Um zu testen, ob alles funktioniert, sollten Sie in Riemann manuell eine Warnung auslösen. Dies kann manuell über den Ruby-Client im interaktiven Ruby-Interpreter erfolgen. irb wie folgt:

4. Lösen Sie einen Vorfall im folgenden Format aus: Notiz: Der Ruby-Client geht zwar davon aus, dass Ihre Ereignisse vom lokalen Hostnamen stammen, es sei denn, Sie übergeben Host: nil Möglicherweise möchten Sie den Hostnamen explizit angeben, nur zu Testzwecken.

5. Das Ereignis sollte in Ihren Riemann-Streaming-Protokollen angezeigt werden. Außerdem sollte in PagerDuty ein Vorfall ausgelöst werden. Sobald der Status wieder auf „OK“ wechselt, sollte der Vorfall auch in PagerDuty behoben sein.