[Intum](https://intum.pl/pomoc.md) / [Automatyzacja](https://intum.pl/pomoc/automatyzacja.md)

# [Źródła alertów - awarie z monitoringu jako tickety](https://intum.pl/pomoc/automatyzacja/zrodla-alertow-awarie-z-monitoringu-jako-tickety.md) | [API](#api)

Źródła alertów zamieniają powiadomienia z zewnętrznego monitoringu (UptimeRobot, Grafana, Sentry i inne) w tickety helpdesku, które od razu wchodzą w eskalację. Awaria w nocy nie czeka do rana - system sam powiadamia kolejne osoby, aż ktoś się zajmie.

Źródła znajdziesz w module Automatyzacja: Centrum działań, Ustawienia, sekcja Źródła alertów.

## Jak to działa

Każde źródło ma własny token i adres do wysyłania alertów. Konfigurujesz je raz:

- nazwa, np. "UptimeRobot produkcja",
- desk, na którym mają powstawać tickety,
- polityka eskalacji - według niej system powiadamia po awarii (puste = ticket bez eskalacji).

W systemie monitoringu ustawiasz webhook na adres źródła. Gdy przyjdzie alert, powstaje ticket z tytułem alertu i rusza eskalacja. Krok polityki z czasem 0 wysyła powiadomienia od razu, np. na kanał Google Chat.

## Deduplikacja i odwoływanie

Alert może mieć klucz (alert_key), np. identyfikator monitora. Dopóki ticket z tym kluczem jest otwarty, kolejne alerty z tym samym kluczem nie tworzą duplikatów.

Gdy monitoring zgłosi koniec awarii, wysyła odwołanie z tym samym kluczem - ticket zamyka się sam, a z nim eskalacja.

## Dobre praktyki

- osobne źródło dla każdego systemu monitoringu - łatwiej odciąć jedno, gdy zaleje Was alertami,
- w polityce eskalacji dla awarii ustaw krok 0 min z kanałem konektor (Google Chat) - cały zespół widzi awarię od razu,
- token źródła trzymaj jak hasło; w razie wycieku wyłącz źródło i utwórz nowe.

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**

## Wysyłanie alertu

```
POST /automation/escalation/alerts
Content-Type: application/json

{ "token": "TOKEN_ŹRÓDŁA", "title": "Serwer web-1 nie odpowiada", "alert_key": "web-1", "source": "uptimerobot" }
```

Odpowiedź: `{ "status": "created", "ticket_id": 123 }` albo `{ "status": "duplicate", ... }` przy otwartym tickecie z tym samym `alert_key`.

## Odwołanie alertu

```
POST /automation/escalation/alerts/resolve
{ "token": "TOKEN_ŹRÓDŁA", "alert_key": "web-1" }
```

Zamyka ticket i kończy eskalację. Bez pasującego klucza: `{ "status": "not_found" }`.

## Zarządzanie źródłami

CRUD: `/automation/escalation/alert_sources.json` (pola: `name`, `desk_id`, `escalation_policy_id`, `active`; token generowany automatycznie, widoczny na show). Endpointy alertów nie wymagają logowania - autoryzacją jest token źródła.

---

## Powiązane

- [Eskalacje (SLA) - tickety, zadania, e-maile i formularze](https://intum.pl/pomoc/automatyzacja/eskalacja-ticketow.md)