Uruchomienie i konfiguracja - Discord

Co wysyła ta integracja

Integracja z Discordem to funkcja panelu DockRay - kanał powiadomień wysyła wiadomość na wybrany kanał Discord, 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ł tego samego serwera Discord.

Przygotowanie w Discordzie

1. Załóż aplikację w Discord Developer Portal i dodaj jej bota.
2. Skopiuj token bota z zakładki Bot.
3. Zaproś bota na swój serwer linkiem OAuth2 z zaznaczonym zakresem bot.
4. Nadaj mu uprawnienia View Channel, Send Messages i Embed Links na kanałach, gdzie mają się pojawiać alerty.
5. Skopiuj identyfikator każdego kanału docelowego (tryb dewelopera Discorda → prawy klik na kanale → Kopiuj ID kanału).

DockRay identyfikuje kanał wyłącznie po numerycznym identyfikatorze, nie po nazwie - Discord dopuszcza dwa kanały o tej samej nazwie na jednym serwerze, więc nazwa nie byłaby jednoznaczna.

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ę Discord i wklej token bota.
2. Dla każdego rodzaju zdarzenia wpisz identyfikator kanału - ciąg 17-20 cyfr; inny format panel odrzuci od razu.
3. Zapisz. Puste pole tokenu przy zapisie znaczy „zostaw zapisany''.

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

Wiadomość testowa

Przy każdym rodzaju zdarzenia jest przycisk Wyślij test. Działa dopiero, gdy token jest zapisany albo właśnie wpisany, a pole kanału zawiera poprawny identyfikator. Udany test potwierdza też, że bot rzeczywiście ma uprawnienia do pisania na wskazanym kanale, a nie tylko że token jest ważny.