DocumentațieAlerte și incidente
Alerte
Contacte de alertă pentru e-mail, SMS, apeluri vocale, Slack, Discord, Microsoft Teams, Google Chat, Telegram, Pushover și webhook-uri — verificare, reguli de alertă, întârzieri, remindere și escaladare.
Pe această pagină
- Ce declanșează o alertă
- Contacte de alertă și canale
- Verificare
- Testare
- Canale care necesită configurare din platformă
- Credite SMS și pentru apeluri vocale
- Reguli de alertă
- Modele de escaladare
- Livrare și reîncercări
- Webhook-uri
- Payload implicit
- Șabloane personalizate
- Notificări push pe mobil
- Preferințe de e-mail și notificări în aplicație
- Notificări în aplicație
Alertele au două părți:
- Contactele de alertă — unde ajung alertele (o adresă de e-mail, un număr de telefon, un canal de Slack…). Le gestionezi în Contacte de alertă.
- Regulile de alertă — ce monitoare alertează ce contacte, după cât timp și cât de des. Le setezi în pagina fiecărui monitor, la Reguli de alertă.
Ce declanșează o alertă#
| Eveniment | Când | event în webhook |
|---|---|---|
| Căzut | Căderea unui monitor este confirmată (vezi cum se confirmă o cădere) | monitor.down |
| Funcțional | Monitorul și-a revenit — trimis doar contactelor care au primit alerta de cădere | monitor.up |
| Lent | Două răspunsuri consecutive mai lente decât pragul setat pe monitor (HTTP / cuvânt cheie) | monitor.slow |
| Certificat SSL pe cale să expire | Un certificat atinge unul dintre pragurile „zile înainte de expirare” ale monitorului | ssl.expiring |
| Domeniu pe cale să expire | Înregistrarea unui domeniu atinge unul dintre praguri | domain.expiring |
| Test | Ai apăsat Testează la un contact | test |
Monitoarele aflate într-o fereastră de mentenanță activă nu își schimbă starea și nu trimit alerte.
Contacte de alertă și canale#
| Canal | Ce introduci | Verificare | Detalii |
|---|---|---|---|
| O adresă de e-mail | Cod din 6 cifre prin e-mail | Adresele membrilor confirmați ai echipei sunt verificate automat. | |
| SMS | Un număr de telefon în format internațional (E.164), de exemplu +40712345678 |
Cod din 6 cifre prin SMS | Folosește credite SMS. |
| Apel vocal | Un număr de telefon în format E.164 | Cod din 6 cifre prin apel telefonic | Folosește credite (de două ori costul unui SMS către aceeași destinație). |
| Slack | Un URL de incoming webhook (https://hooks.slack.com/…) |
— | Creează un Incoming Webhook pentru canal în workspace-ul tău de Slack. |
| Discord | URL-ul webhook-ului unui canal | — | Setările canalului → Integrations → Webhooks. |
| Microsoft Teams | URL-ul unui webhook Workflows | — | În Teams, adaugă canalului fluxul Post to a channel when a webhook request is received; mesajele sunt trimise ca Adaptive Cards. |
| Google Chat | URL-ul webhook-ului unui spațiu | — | Spațiu → Apps & integrations → Webhooks. |
| Telegram | ID-ul chatului (un număr; negativ pentru grupuri) | — | Pornește mai întâi o conversație cu botul nostru de Telegram (sau adaugă-l în grup), ca să aibă voie să îți scrie. |
| Pushover | Cheia ta de utilizator sau de grup, plus tokenul aplicației tale Pushover | — | Opțional, numele dispozitivului și prioritatea (implicit: ridicată pentru alertele de cădere, normală în rest). |
| Webhook | Orice URL https:// (sau http://) |
— | Trimite JSON către propriile tale sisteme; vezi mai jos. Disponibil în planurile cu webhook-uri. |
URL-urile pentru Slack, Discord, Teams și Google Chat trebuie să înceapă cu https://. Tratează URL-urile de webhook ca pe niște parole: oricine are unul poate posta în canalul tău.
Verificare#
Contactele de e-mail, SMS și apel vocal trebuie verificate înainte să primească alerte — astfel alertele (și costurile) nu ajung la un număr greșit. După ce salvezi contactul, introdu codul din 6 cifre pe care ți l-am trimis. Dacă nu a ajuns, cere un cod nou din dreptul contactului. Codurile expiră; un cod expirat sau greșit este respins cu un mesaj clar.
Testare#
Apasă Testează în dreptul unui contact ca să trimiți o alertă de test. Rezultatul îți spune dacă acel canal a acceptat mesajul (de exemplu „HTTP 404” când URL-ul unui webhook este greșit).
Canale care necesită configurare din platformă#
SMS-urile, apelurile vocale și Telegram sunt livrate prin furnizori configurați de operatorii isituprightnow. Dacă unul dintre ele nu este încă disponibil, la salvarea sau testarea unui astfel de contact vezi mesajul „nu este disponibil încă”, nu o eroare tăcută.
Credite SMS și pentru apeluri vocale#
Alertele prin SMS și apel vocal folosesc credite preplătite: implicit un credit pentru un SMS, iar un apel vocal costă de două ori cât un SMS către aceeași destinație (unele țări costă mai mult). Unele planuri includ credite lunare, iar pachete de credite poți cumpăra din Facturare — vezi Facturare. Când soldul ajunge la zero, alertele prin SMS și apel vocal sunt omise (celelalte canale funcționează în continuare), iar proprietarii și administratorii contului primesc un e-mail de tip „credite pe terminate”, cel mult o dată pe zi. Același e-mail este trimis și când soldul scade la 5 sau mai puțin.
Reguli de alertă#
Deschide un monitor și adaugă câte o regulă pentru fiecare contact, la Reguli de alertă:
| Câmp | Câmp în API | Valori | Ce înseamnă |
|---|---|---|---|
| Contact | contactId |
unul dintre contactele tale | Cine este alertat. |
| După (min) | thresholdMinutes |
0–1440 | Alertează doar dacă monitorul este încă căzut după atâtea minute. 0 = imediat ce căderea este confirmată. |
| Repetă (min) | repeatEveryMinutes |
0 sau 5–1440 | Reamintește la fiecare N minute cât timp incidentul este deschis și neconfirmat. 0 = o singură alertă. |
Reminderele se opresc când monitorul își revine sau când cineva confirmă incidentul.
Modele de escaladare#
Fiecare regulă are propria întârziere, așa că din câteva reguli construiești o politică de escaladare:
| Contact | După | Repetă | Efect |
|---|---|---|---|
| Canalul de Slack #ops | 0 | 0 | Echipa vede imediat fiecare cădere. |
| Inginerul de gardă (SMS) | 5 | 15 | Este chemat dacă nu e doar o sincopă și i se reamintește până confirmă cineva. |
| Managerul de echipă (apel vocal) | 30 | 0 | Este sunat o dată dacă problema durează o jumătate de oră. |
Livrare și reîncercări#
Dacă un canal nu acceptă o alertă (de exemplu un webhook răspunde cu 500), reîncercăm de cel mult 5 ori, cu pauze din ce în ce mai lungi (1, 2, 4, 8 minute…). Alertele sunt scrise în limba destinatarului: alertele pe e-mail urmează limba membrului echipei căruia îi aparține adresa; mesajele de chat, SMS, apel vocal și webhook urmează limba proprietarului contului.
Webhook-uri#
Un contact de tip webhook trimite o cerere HTTP către URL-ul tău la fiecare alertă. Configurezi:
- Metoda —
POST(implicit),PUT,PATCHsauGET(fără corp). - Headerele — de exemplu
Authorization: Bearer …, ca endpointul tău să ne poată autentifica. - Șablonul corpului — opțional; lasă-l gol pentru payload-ul JSON implicit.
Cererile au un timeout de 10 secunde, nu urmează redirecționările, folosesc user agent-ul IsItUpRightNow-Webhooks/1.0 (+https://isituprightnow.com) și sunt considerate livrate la orice răspuns 2xx. La fel ca verificările, webhook-urile pot ajunge doar la adrese publice de internet.
Payload implicit#
{
"event": "monitor.down",
"monitor": {
"id": "8b0c7d3e-3f5a-4a49-9a51-2f1f0f4c6a10",
"name": "Site — prima pagină",
"target": "https://www.example.com/"
},
"status": "Down",
"title": "Site — prima pagină is DOWN",
"message": "isituprightnow: Site — prima pagină este CĂZUT: HTTP 503 (https://www.example.com/)",
"locale": "ro",
"occurredAt": "2026-10-03T14:05:12.000Z",
"cause": "HTTP 503",
"regions": ["eu-central", "us-east"],
"incidentId": "5e1f2a9b-77c4-4d3e-9a0f-6b2d8c1e4f55",
"downtimeSeconds": null,
"responseMs": null,
"expiresAt": null,
"link": "https://isituprightnow.com/ro/app/incidents/5e1f2a9b-77c4-4d3e-9a0f-6b2d8c1e4f55"
}| Câmp | Descriere |
|---|---|
event |
monitor.down, monitor.up, monitor.slow, ssl.expiring, domain.expiring sau test. |
monitor |
id, name și target ale monitorului. |
status |
Starea monitorului: Up sau Down. |
title |
Un titlu scurt în engleză (stabil, bun pentru filtre). |
message |
Un text de un rând, ușor de citit, în limba proprietarului contului (locale: en sau ro). |
occurredAt |
Momentul evenimentului, ISO 8601 UTC. |
cause |
Ce a eșuat, așa cum a raportat verificatorul, de exemplu Timeout sau HTTP 503 (netradus). |
regions |
Regiunile care au văzut eroarea. |
incidentId |
Incidentul, dacă există. |
downtimeSeconds |
La monitor.up: cât a durat căderea. |
responseMs |
La monitor.slow: timpul de răspuns măsurat. |
expiresAt |
La ssl.expiring / domain.expiring: data expirării. |
link |
Unde vezi detaliile în panou. |
Câmpurile care nu se aplică sunt null. Titlurile și mesajele sunt exemple — nu le interpreta automat; folosește event, status și id-urile.
Șabloane personalizate#
Scrie-ți propriul corp al cererii cu {{placeholdere}}. Dacă șablonul începe cu { sau [, este trimis ca application/json, iar fiecare valoare este escapată pentru JSON; altfel este trimis ca text/plain.
| Placeholder | Valoare |
|---|---|
{{event}} |
monitor.down, monitor.up, … |
{{status}} |
down, up sau tipul evenimentului (slow, …) |
{{monitorId}}, {{monitorName}} |
Monitorul |
{{target}}, {{monitorUrl}} |
Ținta monitorului |
{{title}}, {{message}} |
Texte în limba proprietarului contului |
{{cause}}, {{regions}} |
Cauza erorii; regiunile, separate prin virgulă |
{{occurredAt}} |
Ora ISO 8601 UTC |
{{incidentId}}, {{downtimeSeconds}}, {{responseMs}} |
Goale când nu se aplică |
{{link}}, {{locale}} |
Linkul către panou; en sau ro |
De exemplu, ca să creezi un tichet într-un sistem care își așteaptă propriul format:
{
"summary": "{{title}}",
"description": "{{message}} ({{cause}}, regiuni: {{regions}})",
"severity": "{{status}}",
"external_id": "{{incidentId}}",
"url": "{{link}}"
}Notificări push pe mobil#
Membrii echipei care folosesc aplicația mobilă primesc pe telefon o notificare push pentru fiecare cădere și revenire a monitoarelor contului — fără să fie nevoie de o regulă de alertă. Alertele de cădere pot suna ca o alarmă, chiar și în orele de liniște.
Preferințe de e-mail și notificări în aplicație#
Pe lângă alerte, isituprightnow trimite și alte câteva mesaje. Alegi ce primești în Setări → Notificări:
| Mesaj | Implicit | Cine îl primește |
|---|---|---|
| Rapoarte de uptime — săptămânal, lunar sau oprit | Lunar | Proprietarii și administratorii fiecărui cont cu monitoare |
| Noutăți despre produs și sfaturi | Oprit — doar dacă te abonezi | Utilizatorii care au bifat „Trimite-mi noutăți despre produs și sfaturi” la crearea contului sau le-au activat ulterior |
| Anunțuri despre serviciu (de exemplu mentenanțe planificate sau schimbări importante) | Întotdeauna | Utilizatorii vizați |
Aceste setări nu schimbă niciodată alertele.
- Linkul de dezabonare. Fiecare e-mail cu raportul sau cu noutăți se încheie cu un link Dezabonează-te și un link către preferințele tale. Pagina deschisă îți cere să confirmi cu un buton — doar deschiderea linkului nu schimbă nimic — și îți permite să modifici ambele preferințe fără să intri în cont. Aplicațiile de e-mail care știu dezabonarea cu un clic își afișează și propriul buton.
- Fără urmărire. Aceste e-mailuri nu conțin pixeli de urmărire și nici linkuri urmărite.
Notificări în aplicație#
Anunțurile echipei isituprightnow apar și în panou: clopoțelul din partea de sus a fiecărei pagini arată câte sunt necitite și le deschide pe cele mai recente zece. Vezi toate notificările deschide lista completă, unde poți filtra notificările necitite, poți folosi Marchează ca citită pentru câte una sau Marchează-le pe toate ca citite. Noutățile despre produs apar acolo doar dacă te-ai abonat la ele. Notificările sunt păstrate 180 de zile.
Nu ai găsit ce căutai? Scrie-ne.