Uruchomienie i konfiguracja - Mattermost

Co wysyła ta integracja

Integracja z Mattermost to funkcja panelu DockRay - kanał powiadomień wysyła wiadomość na wybrany kanał Mattermost, gdy scheduler albo ingest wykryje jedno z pięciu zdarzeń monitoringu:

• ping - serwer aplikacji nie odpowiada,
• ssl - certyfikat wygasa,
• google-page-speed - spadek wydajności,
• issue - nowy, wcześniej niewidziany błąd,
• error-spike - nagły wzrost liczby błędów.

Każdy rodzaj zdarzenia ma własny przełącznik i może iść na inny kanał.

Przygotowanie w Mattermost

1. Poproś administratora serwera Mattermost o włączenie Incoming Webhooks (jeśli jeszcze nie są włączone).
2. Utwórz nowy webhook przychodzący dla kanału, na który mają trafiać alerty.
3. Skopiuj wygenerowany adres - ma postać pełnego adresu HTTPS zakończonego losowym identyfikatorem.

Adres webhooka musi być publicznym HTTPS - bez tego DockRay odrzuci go już przy zapisie. To nie jest ograniczenie samego Mattermosta, tylko warunek, który DockRay stawia każdemu adresowi wpisywanemu w panelu: patrz sekcja o walidacji w kolejnym artykule.

Konfiguracja w panelu DockRay

Ekran jest jeden dla konta i dla projektu: Ustawienia → Kanały powiadomień, a dla pojedynczego projektu - Ustawienia projektu → Kanały powiadomień. Edycja wymaga uprawnienia do zarządzania projektami - mają je role developer i wyższe.

1. Włącz dostawcę Mattermost i wklej adres webhooka.
2. Dla każdego rodzaju zdarzenia wpisz nazwę kanału - Mattermost pozwala webhookowi wysłać wiadomość na inny kanał niż ten, dla którego go utworzono, jeśli poda się go jawnie.
3. Zapisz. Puste pole adresu przy zapisie znaczy „zostaw zapisany'' - poświadczenie nigdy nie wraca do formularza jawnym tekstem.

Projekt domyślnie dziedziczy konfigurację konta i może ją nadpisać własnym webhookiem albo wyłączyć wybrany rodzaj powiadomień niezależnie od ustawień konta.

Wiadomość testowa

Przy każdym rodzaju zdarzenia jest przycisk Wyślij test. Wysyła próbną wiadomość dokładnie tą drogą, którą poszedłby prawdziwy alert - działa dopiero, gdy adres webhooka jest zapisany albo właśnie wpisany i wskazano kanał. Udany test potwierdza, że adres wciąż jest aktywny po stronie Mattermosta - webhooki bywa się kasuje razem z porządkowaniem integracji.