> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Alerty

> Reguły progowe dotyczące wskaźników połączeń — wysyłane na e-mail, Slack lub do webhooków, gdy tylko coś wymknie się spod kontroli.

Reguły alertów monitorują metryki połączeń w organizacji i powiadamiają, gdy
próg zostanie przekroczony — wskaźnik powodzenia poniżej 80% w ciągu ostatniej doby,
ponad 500 połączeń w ciągu godziny, regresja pakietu testów. Zarządzaj nimi
w **Ustawienia → Organizacja → Alerty**
(`/dashboard/organization?tab=alerts`). Zarządzanie regułami alertów wymaga
roli **admin** lub **owner**.

## Utwórz regułę

Kliknij **Utwórz regułę** i uzupełnij:

| Pole                                       | Opcje                                                                                          |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| **Metryka**                                | Wskaźnik powodzenia · Wskaźnik niepowodzeń · Średni wynik · Liczba połączeń · Regresje pakietu |
| **Warunek**                                | jest mniejszy niż · jest co najwyżej · jest większy niż · jest co najmniej                     |
| **Próg**                                   | Liczba, z którą porównywana jest metryka                                                       |
| **Okno (godziny)**                         | Jak daleko wstecz obliczana jest metryka — od 1 do 720 godzin                                  |
| **Odbiorcy e-mail**                        | Adresy rozdzielone przecinkami, maksymalnie 10                                                 |
| **URL przychodzącego webhooka Slack**      | Opcjonalnie — wysyła komunikat alertu do kanału                                                |
| **Czas odnowienia (minuty)**               | Minimalny czas bez alertów między wyzwoleniami (domyślnie 60)                                  |
| **Dostarczaj do webhooków deweloperskich** | Wysyłaj również zdarzenie `alert.triggered` do punktów końcowych webhooków                     |
| **Włącz regułę alertu**                    | Reguły można zapisać jako wyłączone i włączyć później                                          |

Przykład: *„Wskaźnik powodzenia **jest mniejszy niż** 80 w ciągu ostatnich 24 godzin”*
uruchamia się, gdy połączenia z oceną w kroczącym 24-godzinnym oknie spadną poniżej
wskaźnika powodzenia wynoszącego 80%.

<Note>
  **Wskaźnik niepowodzeń obejmuje więcej niż połączenia „Nieudane”.** Metryka alertu
  traktuje jako niepowodzenie każde połączenie, które nie osiągnęło pomyślnego wyniku — w tym połączenia
  bez żadnej rozmowy (natychmiastowe rozłączenia, nieudane połączenia). Kafelek **Nieudane**
  na pulpicie zawiera tylko połączenia ocenione jako
  `unsuccessful`. Alert dotyczący wskaźnika niepowodzeń może więc zostać uruchomiony, nawet gdy
  kafelek na pulpicie pokazuje niską liczbę; jest to oczekiwane, a nie rozbieżność.
</Note>

## Jak działa wyzwalanie

Reguły są oceniane względem skonfigurowanego kroczącego okna. Gdy
warunek zostanie spełniony, reguła uruchamia się **raz**, a następnie pozostaje nieaktywna przez
okres odnowienia, nawet jeśli metryka nadal przekracza próg — dzięki temu zła
godzina generuje jedno powiadomienie, a nie powiadomienie przy każdej ocenie. Każde uruchomienie zapisuje
wartość metryki, próg i czas.

## Kanały dostarczania

Pojedyncza reguła może jednocześnie powiadamiać przez wszystkie trzy kanały:

* **E-mail** — wiadomość do każdego wskazanego odbiorcy zawierająca nazwę reguły,
  metrykę, wartość, próg i okno.
* **Slack** — ta sama wiadomość opublikowana za pośrednictwem URL przychodzącego webhooka
  Slack.
* **Webhooki deweloperskie** — zdarzenie `alert.triggered` dostarczane do
  [punktów końcowych webhooków](/pl/webhooks/overview) organizacji, aby integrować
  alerty z PagerDuty, narzędziami dyżurowymi lub własnymi systemami.

Niepowodzenie jednego kanału nigdy nie blokuje pozostałych.

## Zarządzaj regułami

Karta Alerty zawiera listę wszystkich reguł wraz z ich stanem włączenia/wyłączenia oraz informacją,
kiedy zostały ostatnio uruchomione. Przełączaj reguły bezpośrednio na liście, wybierz **Edytuj**, aby
zmienić dowolne pole, lub usuń reguły, których już nie potrzebujesz. Obok wyświetlana jest
najnowsza aktywność alertów, dzięki czemu możesz potwierdzić, że reguła faktycznie uruchamia się
zgodnie z oczekiwaniami.

## Kolejne kroki

<CardGroup cols={2}>
  <Card title="Obserwowalność" icon="chart-line" href="/pl/guides/observability">
    Pulpity oparte na tych samych metrykach.
  </Card>

  <Card title="Webhooki" icon="webhook" href="/pl/webhooks/overview">
    Odbieraj alert.triggered (oraz każde inne zdarzenie) we własnych systemach.
  </Card>
</CardGroup>