Uruchomienie i konfiguracja - Slack

Co wysyła ta integracja

Integracja ze Slackiem to funkcja panelu DockRay, nie coś, co instaluje się u klienta. Kanał powiadomień wysyła wiadomości na wybrane kanały Slack, 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 osobny kanał - awarie dostępności na kanał dyżurny, wydajność do osób odpowiedzialnych za utrzymanie.

Przygotowanie w Slacku

1. Załóż aplikację Slack w swoim workspace (api.slack.com/apps).
2. W zakładce OAuth & Permissions dodaj botowi zakres chat:write.
3. Zainstaluj aplikację w workspace i skopiuj Bot User OAuth Token - zaczyna się od xoxb-.
4. Zaproś bota do kanałów, na które mają trafiać alerty: do prywatnych zawsze, do publicznych też, jeśli bot nie może wejść na nie sam.

DockRay odrzuca token bez prefiksu xoxb- już przy zapisie formularza - to najczęstsza pomyłka na tym etapie: wklejenie tokenu użytkownika (xoxp-) albo podpisu (xoxs-) zamiast tokenu bota.

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ń. Uprawnienie wymagane do edycji to zarządzanie projektami, więc mają je role developer i wyższe.

1. Włącz dostawcę Slack i wklej token bota.
2. Dla każdego rodzaju zdarzenia wpisz kanał - nazwę (np. #alerty) albo identyfikator kanału.
3. Zapisz. Puste pole tokenu przy zapisie znaczy „zostaw zapisany'' - poświadczenie nigdy nie wraca do formularza jawnym tekstem.

Projekt domyślnie dziedziczy konfigurację konta. Może ją też nadpisać własnym tokenem i własnymi kanałami albo jawnie wyłączyć wybrany rodzaj powiadomień, niezależnie od tego, co ustawiono na koncie.

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 jest komplet: zapisany albo wpisany token i wskazany kanał. Test potwierdza więc nie tylko, że token jest poprawny, ale że bota faktycznie widać na docelowym kanale.