Wysyłanie alertów z NetCruncha do PagerDuty
W artykule tym opiszemy jak zintegrować NetCruncha z PagerDuty w obie strony - to znaczy, by wymiana informacji przebiegała w obie strony. Dzięki temu wybrane alerty z NetCruncha będą mogły być przesyłane automatycznie do PagerDuty, a za pomocą webhooka komunikaty 'zgłoszenie zamknięte' będą wysyłane z powrotem do NetCruncha, zamykając odpowiedni alert w NetCrunchu po tym, jak został on zamknięty w PagerDuty.
Włącz wysyłanie zgłoszeń z NetCruncha do PagerDuty
Aby umożliwić NetCrunchowi wysyłanie wybranych alertów do PagerDuty, należy najpierw skonfigurować profil integracyjny dla PagerDuty. W tym celu, kliknij Monitorowanie Profile integracji w górnej części okna NetCruncha.
W edytorze zostaniesz poproszony o Service Integration Key oraz o PagerDuty API Key. Informacje o tym, jak skonfigurować PagerDuty API Key znajdują się na stronie: Generowanie API Key.
Aby utworzyć Service Integration Key, musimy najpierw posiadać serwis (service) w PagerDuty który jest konfigurowany w ustawieniach integracji w PagerDuty (Integration Setting: "Use our API directly"). Utwórz zatem i nazwij odpowiednio ten serwis i dokończ jego konfigurację, a następnie dodaj go do twoich już istniejących serwisów w PagerDuty. Pojawi się strona integracji nowego serwisu i tam będzie można znaleźć Service Integration Key dla twojego profilu integracyjnego w NetCrunchu.
Utwórz alert, który będzie wysyłał wiadomości do PagerDuty
Aby NetCrunch mógł korzystać z tej integracji, należy utworzyć nowy skrypt alertowy (lub użyć już istniejący). Poniższe kroki objaśniają, jak utworzyć nowy skrypt alertowy.
- Kliknij Monitorowanie Skrypty eskalacji alertów
- W oknie skryptów alertowych kliknij Dodaj skrypt alertowy.
- Następnie dodaj akcję klikając Dodaj i wybierz Akcję wykonywaną natychmiast
- Kliknij zakładkę Integracje i wybierz zgłoszenie PagerDuty.
Pojawi się nowe okno, ale nie ma w nim wiele do konfigurowania. Upewnij się, że używasz właściwego profilu. Przetestuj wysyłanie wiadomości do PagerDuty klikającTest. Wyświetlone zostanie okienko z procedurą. Jeśli wszystko zostało poprawnie skonfigurowane, test zakończy się wyświetleniem komunikatu "Successfully executed" a w usłudze PagerDuty pojawi się wiadomość testowa.
Pozostało nam teraz skonfigurowanie operacji "Zamknij zgłoszenie". W tym celu należy utworzyć skrypt alertowy z operacją "Utwórz zgłoszenie" będącą akcją wykonywaną natychmiast i operacją "Zamknij zgłoszenie" ustawioną jako Akcja do wykonania przy zamknięciu alertu. Wybierz węzeł i dodaj warunek alertowy (na przykład Monitorowanie węzła jest wyłączone) i dodaj powyższy skrypt alertowy. Poniżej opisuję jak utworzyć alert Monitorowanie węzła jest wyłączone dla pojedyńczego węzła.
- Kliknij prawym klawiszem myszy na węzeł, dla którego chcesz utworzyć alert
- Wybierz ustawienia węzła i kliknij Alertowanie i Raporty w oknie ustawień węzła
- Kliknij Dodaj alert, wybierz zakładkę Podstawowy i w niej wybierz Monitorowanie węzła jest wyłączone
- Kliknij prawym klawiszem na nowym alercie i wybierz Przypisz predefiniowany skrypt alertowania Nazwa twojego skryptu dla PagerDuty
Gdy teraz wyzwolisz alert (Monitorowanie węzła jest wyłączone), utworzone zostanie zgłoszenie w PagerDuty. Gdy alert zostanie zamknięty w netCrunchu (Monitorowanie węzła jest włączone), do zgłoszenia w PagerDuty dodany będzie odpowiedni komentarz i zgłoszenie zostanie zamknięte. Gdy ten skrypt alertowy zostanie dodany do różnych alertów, NetCrunch będzie wysyłał wiadomości do PagerDuty za każdym razem, gdy dany alert zostanie wygenerowany.
Możliwe jest również wysyłanie alertów do różnych serwisów w PagerDuty, należy jednak utworzyć nowy profil integracji dla każdgo nowego serwisu i upewnić się, że mają poprawne ustawienia integracji.
WebHook (integracja w obie strony)
PagerDuty jest jedną z wielu dwustronnych integracji w NetCrunchu. Można łatwo skonfigurować webhooka, który będzie wysyłał informację z powrotem do NetCruncha gdy dane zgloszenie zostanie zamknięte w PagerDuty - w rezultacie odpowiadający mu alert w NetCrunchu również zostanie zamknięty. Nie musi to oznaczać, że problem który wyzwolił alert został rzeczywiście rozwiązany, natomiast dotyczący go alert w NetCrunchu zostanie zamknięty (np. węzeł może dalej nie działać choć alert jest zamknięty).
By otrzymywać w NetCrunchu webhooki z PagerDuty, należy najpierw utworzyć NetCrunch API Key - w tym celu idź do profilu integracji PagerDuty i kliknij "Open API Key Manager". Skopiuj URL WebHooka i zastąp [Web_Access_address] adresem twojego dostępu rzeczywistego NetCruncha w przeglądarce (Web Access) (np. https://123.456.789.0/ncinf/rest...).
Idź do PagerDuty, wybierz zakładkę Integracji i dodaj nowe rozszerzenie, wybierz typ rozszerzenia Standardowy WebHook, nazwij go i dodaj URL z twoim adresem NetCruncha w polu URL.
Teraz gdy NetCrunch utworzy zgłoszenie i zostanie ono zamknięte przez agenta PagerDuty, odpowiadający mu alert w NetCrunchu zostanie również zamknięty.
