Integracja z PagerDuty
Połącz PagerDuty, aby otrzymywać alerty VDP, synchronizować harmonogramy dyżurów i śledzić status incydentów w Kit.
To tłumaczenie może być nieaktualne. Wersja angielska została zaktualizowana od czasu ostatniego tłumaczenia tej strony. Zobacz po angielsku →
Co daje połączenie z PagerDuty
Jeśli twój zespół używa PagerDuty do obsługi incydentów i dyżurów, połącz go z Kit. Wybrane zdarzenia VDP będą wtedy uruchamiać alerty PagerDuty, także poza godzinami pracy.
Wymagania
- Aktywna subskrypcja Kit
- Konto PagerDuty z uprawnieniami do tworzenia kluczy API
- Dedykowany serwis PagerDuty dla alertów VDP (zalecane)
Konfiguracja
1. Utwórz klucz API w PagerDuty
- Przejdź do PagerDuty > Integrations > API Access Keys
- Kliknij Create New API Key
- Nazwij go „Kit VDP” i skopiuj klucz
2. Pobierz klucz integracji
- Przejdź do PagerDuty > Services > Your VDP Service > Integrations
- Dodaj integrację Events API v2 (lub użyj istniejącej)
- Skopiuj Integration Key (nazywany również kluczem routingu)
3. Połącz w Kit
- Przejdź do VDP > Settings > PagerDuty
- Wklej oba klucze i kliknij Connect to PagerDuty
- Kit zweryfikuje połączenie i wyświetli zielony znacznik statusu
Zdarzenia uruchamiające alerty
Skonfiguruj, które zdarzenia tworzą incydenty w PagerDuty. Dla każdego zdarzenia możesz wybrać poziom ważności.
| Zdarzenie | Kiedy występuje | Domyślna ważność |
|---|---|---|
| Nowe zgłoszenie | Badacz przesyła zgłoszenie podatności | Info |
| Zagrożenie SLA | Zgłoszenie zbliża się do terminu SLA (sprawdzane co 15 min) | Warning |
| Naruszenie SLA | Zgłoszenie przekroczyło termin SLA | Warning |
| Ocena krytycznej ważności | Zgłoszenie zostało ocenione jako krytyczne lub superkrytyczne | Critical |
| Aktywacja war room | 2+ zgłoszenia jednocześnie zagrożone lub z naruszonym SLA | Error |
Deduplikacja: Kit używa identyfikatora zgłoszenia jako klucza deduplikacji. Jeśli to samo zgłoszenie wyzwoli wiele kontroli SLA, PagerDuty połączy je w jeden incydent zamiast tworzyć duplikaty.
Powtarzające się alerty o zdarzeniu Naruszenie SLA są dodatkowo ograniczane, zanim w ogóle dotrą do PagerDuty. Decyduje o tym pula alertów o przekroczeniu SLA w twoim programie, domyślnie trzy powtórzenia co sześć godzin.
Synchronizacja harmonogramu dyżurów
Po włączeniu Kit odpytuje harmonogram PagerDuty co 5 minut i automatycznie aktualizuje osobę dyżurną w Kit.
- Na stronie ustawień PagerDuty wybierz harmonogram z listy rozwijanej
- Kit dopasowuje użytkowników PagerDuty do użytkowników Kit na podstawie adresu e-mail
- Na stronie On-Call wybierz tryb PagerDuty
Jeśli użytkownik PagerDuty nie zostanie znaleziony w Kit: poprzednia zmiana pozostaje aktywna, a na stronie ustawień pojawia się ostrzeżenie.
W trybie PagerDuty możesz też ręcznie zmienić dyżurnego. Przy następnej synchronizacji znów obowiązuje harmonogram PagerDuty.
Aktualizacje incydentów (dwukierunkowe)
Gdy ktoś potwierdzi lub rozwiąże incydent w PagerDuty, Kit otrzymuje aktualizację przez webhook i odzwierciedla ją na osi czasu zgłoszenia.
| Akcja w PagerDuty | Efekt w Kit |
|---|---|
| Potwierdzenie incydentu | Zgłoszenie pokazuje status „Acknowledged via PagerDuty” |
| Rozwiązanie incydentu | Zgłoszenie pokazuje status „Resolved via PagerDuty” |
Zmiana statusu incydentu w PagerDuty nie zmienia automatycznie statusu zgłoszenia w Kit. Walidację, odrzucenie lub rozwiązanie zgłoszenia zleca się osobno w Kit.
Konfiguracja webhooka
- Skopiuj Webhook URL widoczny na stronie ustawień PagerDuty
- W PagerDuty przejdź do Integrations > Generic Webhooks (v3)
- Utwórz nową subskrypcję webhooka z adresem URL Kit
- Wybierz zdarzenia:
incident.acknowledgediincident.resolved
Rozwiązywanie problemów
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
| „Connection failed” przy zapisie | Nieprawidłowy token API | Wygeneruj nowy token w PagerDuty i wklej ponownie |
| Alerty nie tworzą incydentów | Zdarzenie nie jest włączone w regułach alertów | Sprawdź przełącznik dla każdego typu zdarzenia na stronie ustawień |
| Dyżury się nie synchronizują | E-mail użytkownika PD nie pasuje do użytkownika Kit | Upewnij się, że adres e-mail użytkownika PagerDuty jest taki sam jak na koncie Kit |
| Czerwony znacznik błędu połączenia | Token API został unieważniony lub wygasł | Połącz ponownie z nowym tokenem; Kit wstrzymuje wszystkie alerty przy błędzie autoryzacji |
Lista kontrolna
- Utwórz klucz API PagerDuty z zakresem dla serwisu VDP
- Wklej klucz API i klucz integracji w VDP > Settings > PagerDuty
- Włącz co najmniej jedną regułę alertów (zalecane: naruszenie SLA + ocena krytyczna)
- (Opcjonalnie) Wybierz harmonogram PagerDuty do synchronizacji dyżurów
- (Opcjonalnie) Skonfiguruj webhook w PagerDuty dla dwukierunkowych aktualizacji
- Sprawdź połączenie przyciskiem Test na stronie ustawień