Przejdź do treści
StartupKit
PL

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

  1. Przejdź do PagerDuty > Integrations > API Access Keys
  2. Kliknij Create New API Key
  3. Nazwij go „Kit VDP” i skopiuj klucz

2. Pobierz klucz integracji

  1. Przejdź do PagerDuty > Services > Your VDP Service > Integrations
  2. Dodaj integrację Events API v2 (lub użyj istniejącej)
  3. 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

  1. Przejdź do VDP > Settings > PagerDuty
  2. Wklej oba klucze i kliknij Connect to PagerDuty
  3. 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.

  1. W PagerDuty otwórz Event Orchestration (w Configuration > Events & Routing, a na niektórych kontach w AIOps) i utwórz orkiestrację
  2. Otwórz jej Integrations i skopiuj klucz integracji
  3. W Kit wklej go jako Klucz integracji w VDP > Settings > PagerDuty
  4. 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
  5. 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.

  1. Na stronie ustawień PagerDuty wybierz harmonogram z listy rozwijanej
  2. Kit dopasowuje użytkowników PagerDuty do użytkowników Kit na podstawie adresu e-mail
  3. 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

  1. Skopiuj Webhook URL widoczny na stronie ustawień PagerDuty
  2. W PagerDuty przejdź do Integrations > Generic Webhooks (v3)
  3. Utwórz nową subskrypcję webhooka z adresem URL Kit
  4. Wybierz zdarzenia: incident.acknowledged i incident.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ń

Wpisz, aby wyszukać...