Integracja z PagerDuty
Połącz PagerDuty, aby otrzymywać alerty VDP, synchronizować harmonogramy dyżurów i śledzić status incydentów w Kit.
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)
Żeby alerty każdego komponentu trafiały do zespołu, który za niego odpowiada, użyj zamiast tego klucza integracji z Event Orchestration. Zobacz Kierowanie alertów do właściwego zespołu.
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 wywołują alert w PagerDuty. Każde zdarzenie ma własną ważność incydentu. Dopóki jej nie zmienisz, jest to Warning.
| Zdarzenie | Kiedy występuje |
|---|---|
| Nowe zgłoszenie | Badacz przesyła zgłoszenie podatności |
| SLA zagrożone | Zgłoszenie zbliża się do terminu SLA (sprawdzane co 15 min) |
| Naruszenie SLA | Zgłoszenie przekroczyło termin SLA |
| Oceniono krytyczną ważność | Walidujesz zgłoszenie, którego poziom ważności wywołuje eskalację (domyślnie Critical i Super Critical) |
| Zgłoszenie zweryfikowane | Walidujesz dowolne zgłoszenie |
| Utknięte zgłoszenie eskalowane | Zgłoszenie bez postępu zostaje eskalowane do administratorów programu |
Treść alertu: zdarzenie, oceniona ważność, komponent zgłoszenia i jego ID, na przykład SLA breached · Critical · Payments API — rpt_8Kd2. Jako źródło incydentu widnieje nazwa twojego programu. Kit nigdy nie kopiuje do PagerDuty tekstu napisanego przez badacza (tytułu, typu podatności, opisu), więc na telefon twojej osoby dyżurującej nie trafią słowa z treści zgłoszenia. Zgłoszenie z ograniczonym dostępem wywołuje alert Restricted report needs attention — rpt_8Kd2, bez zdarzenia, poziomu ważności i komponentu. Alert zachowuje ważność incydentu ustawioną w regule, więc osoba dyżurująca nadal dostaje go z właściwą pilnością.
Jeden incydent na zgłoszenie
Kit wiąże każdy alert ze zgłoszeniem, więc jedno zgłoszenie ma w PagerDuty najwyżej jeden otwarty incydent. Otwiera go pierwsze zdarzenie. Dopóki incydent jest otwarty, kolejne zdarzenia przy tym samym zgłoszeniu nie wywołują nowego alertu: PagerDuty dopisuje każde z nich do dziennika alertów incydentu jako kolejne wywołanie, więc incydent gromadzi historię zgłoszenia. Gdy włączone są obie reguły, Oceniono krytyczną ważność i Zgłoszenie zweryfikowane, walidacja zgłoszenia Critical wywołuje jeden alert, a nie dwa.
Gdy zgłoszenie okazuje się poważniejsze: incydent w PagerDuty przyjmuje najwyższą ważność, jaka do niego dotarła. Jeśli reguła Zgłoszenie zweryfikowane otworzyła incydent z ważnością Warning, a później reguła Oceniono krytyczną ważność wyśle zdarzenie z ważnością Critical, incydent przechodzi na Critical. W serwisie z włączonymi powiadomieniami dynamicznymi podnosi to pilność incydentu z niskiej na wysoką, więc obowiązują go twoje reguły powiadomień dla wysokiej pilności. W serwisie ze stałą pilnością późniejsze zdarzenie trafia tylko do dziennika alertów, a PagerDuty nie powiadamia ponownie o incydencie, który ktoś już potwierdził. Żeby dostać alert, gdy zgłoszenie okaże się krytyczne, włącz powiadomienia dynamiczne i nadaj regule Oceniono krytyczną ważność wyższą ważność niż pozostałym regułom.
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.
Kierowanie alertów do właściwego zespołu
Kit wysyła każdy alert na jeden klucz integracji. Z kluczem usługi każdy alert trafia do tej usługi. Żeby alert dostał zespół odpowiedzialny za komponent zgłoszenia, wklej w Kit klucz integracji z Event Orchestration i pozwól orkiestracji wybrać usługę. Reguły kierowania w orkiestracjach są dostępne w każdym planie PagerDuty.
- W PagerDuty otwórz Event Orchestration (w Configuration > Events & Routing, a na niektórych kontach w AIOps) i utwórz orkiestrację
- Otwórz jej Integrations i skopiuj klucz integracji
- W Kit wklej go jako Klucz integracji w VDP > Settings > PagerDuty
- Dodaj jedną Service Route na komponent, z warunkiem
event.custom_details.component_id matches 'cmp_…'. ID każdego komponentu skopiujesz w VDP > Ustawienia programu > Komponenty. ID nie zmienia się po zmianie nazwy komponentu, więc oparta na nim reguła dalej działa - Zmień regułę catch-all tak, żeby niedopasowane zdarzenia trafiały do usługi, w której zespół robi triaż
Nie pomijaj reguły catch-all: domyślnie PagerDuty wycisza alert, który nie pasuje do żadnej reguły, i nikogo nie powiadamia. Alerty o nowym zgłoszeniu zwykle przychodzą, zanim ktoś przypisze komponent, a zgłoszenia z ograniczonym dostępem nigdy go nie mają. Jedne i drugie trafiają więc tylko do reguły catch-all.
Kierowanie wynika z pierwszego alertu incydentu: incydent zostaje w usłudze, w której go otwarto, i tam trafiają kolejne alerty zgłoszenia. Zmiana komponentu zgłoszenia nikogo nie alarmuje. Następny alert zgłoszenia rozwiązuje otwarty incydent w dotychczasowej usłudze i otwiera nowy dla nowego komponentu, więc zgłoszenie nigdy nie ma dwóch otwartych incydentów. Alert agenta przeglądu trafia do otwartego incydentu i go nie przenosi. O kierowaniu decyduje tylko komponent potwierdzony w zgłoszeniu, nigdy sugerowany.
| Pole | Co wysyła Kit |
|---|---|
component |
Nazwa komponentu zgłoszenia; pomijana, gdy zgłoszenie nie ma komponentu albo ma ograniczony dostęp |
group |
Nazwa twojego programu |
class |
Zdarzenie: new_report, sla_at_risk, sla_breach, critical_assessment, report_validated, escalation albo agent_escalation, gdy agent przeglądu oznaczy zgłoszenie jako potencjalnie krytyczne. Dla zgłoszenia z ograniczonym dostępem zawsze restricted_report
|
custom_details.component_id |
ID komponentu, cmp_…
|
custom_details.component |
Nazwa komponentu |
custom_details.program_id |
ID twojego programu |
custom_details.report_id |
ID zgłoszenia, rpt_…
|
custom_details.severity |
Oceniony poziom ważności; pomijany w zgłoszeniach z ograniczonym dostępem |
Alert zgłoszenia z ograniczonym dostępem nie zawiera komponentu, ocenionego poziomu ważności ani zdarzenia: tylko ID zgłoszenia, twój program i restricted_report jako zdarzenie.
Dynamic Routing w PagerDuty też potrafi wybrać usługę na podstawie pola zdarzenia, ale tylko w orkiestracjach z dodatkiem AIOps, a zdarzenie z nieczytelnym polem kierowania po prostu odrzuca. Jedna reguła na komponent to bezpieczniejsza konfiguracja.
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.
Zamknięcie zgłoszenia rozwiązuje jego incydent
Gdy zgłoszenie przestaje być otwarte (rozwiązujesz je, zamykasz jako informacyjne albo odrzucasz, również jako duplikat), Kit rozwiązuje powiązany z nim incydent w PagerDuty. Przejścia między statusami zamkniętymi, na przykład ze statusu „Rozwiązane” na „Poprawka zweryfikowana”, niczego nie wysyłają. Po rozwiązaniu incydentu, w Kit albo w PagerDuty, następne zdarzenie przy tym zgłoszeniu otwiera nowy incydent. Tak będzie na przykład wtedy, gdy zamknięte zgłoszenie zostanie ponownie otwarte i znów wywoła alert.
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ń |
| Późniejsze zdarzenie nie wywołało alertu | Zgłoszenie ma już otwarty incydent | Znajdź to zdarzenie w dzienniku alertów tego incydentu w PagerDuty |
| Alerty do nikogo nie docierają | Nie pasują do żadnej reguły, a reguła catch-all je wycisza | Skieruj regułę catch-all orkiestracji do usługi, w której zespół robi triaż |
| Alert trafił jeszcze do poprzedniego zespołu | Incydent otwarto przed zmianą komponentu | Następny alert zgłoszenia otworzy incydent w usłudze nowego komponentu |
| 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ń