DocumentațieMonitorizare
Monitoare
Toate tipurile de monitoare — HTTP(S), cuvânt cheie, ping, port, heartbeat, certificat SSL, expirarea domeniului, DNS și UDP — cu setările lor, intervalele, regiunile și modul în care se confirmă căderile.
Pe această pagină
Un monitor este un lucru pe care îl verificăm după un program. Creezi monitoare din Monitoare → Adaugă monitor sau prin API.
Tipuri de monitoare#
| Tip | Valoare în API | Ce verifică | Țintă |
|---|---|---|---|
| HTTP(S) | Http |
Un URL răspunde cu un cod de stare acceptat, în limita timeout-ului | https://example.com/health |
| Cuvânt cheie | Keyword |
Ca HTTP(S), plus faptul că răspunsul conține (sau nu conține) un text | https://example.com/ |
| Ping | Ping |
Hostul răspunde la cereri ICMP echo | server.example.com sau o adresă IP |
| Port | Port |
Se poate deschide o conexiune TCP pe port | db.example.com + port |
| Heartbeat | Heartbeat |
Jobul tău a apelat la timp URL-ul lui unic | generat pentru tine |
| Certificat SSL | Ssl |
Certificatul TLS este valid și când expiră | example.com, example.com:8443 sau https://… |
| Expirarea domeniului | Domain |
Când expiră înregistrarea domeniului (RDAP) | example.com |
| DNS | Dns |
Un host se rezolvă (A / AAAA), opțional la adresele așteptate | www.example.com |
| UDP | Udp |
Un serviciu UDP acceptă o datagramă și, opțional, răspunde | ntp.example.com + port |
Monitoarele de tip cuvânt cheie, certificat SSL și expirarea domeniului, intervalele mai scurte și mai multe regiuni depind de plan — vezi Prețuri. Când o funcționalitate nu este inclusă, API-ul răspunde cu 402 și code: "plan_limit".
Setări comune tuturor tipurilor#
| Setare | Câmp în API | Reguli |
|---|---|---|
| Nume | name |
Obligatoriu, cel mult 200 de caractere. Apare în alerte, deci alege unul ușor de recunoscut. |
| Interval de verificare | intervalSeconds |
Între 15 secunde și 24 de ore. Planul stabilește intervalul minim pe care îl poți folosi. |
| Timeout | timeoutMs |
1.000–30.000 ms și mai scurt decât intervalul. Implicit: jumătate din interval, cel mult 10 secunde. |
| Regiuni | regions |
Locurile din care rulează verificarea. Regiunile disponibile apar în formular; planul limitează câte poate folosi un monitor. |
| Etichete | tags |
Cel mult 20 de etichete de 1–50 de caractere, pentru filtrarea listei de monitoare. |
Cum se confirmă o cădere#
Nu trimitem niciodată alerte pentru o singură verificare eșuată:
- Monitoarele verificate din mai multe regiuni sunt Căzute doar când cel puțin două regiuni raportează în acel moment o eroare. O singură regiune cu probleme de rețea nu te poate trezi.
- Monitoarele verificate dintr-o singură regiune sunt Căzute după două verificări eșuate consecutive.
- Un monitor redevine Funcțional imediat ce aceste condiții nu mai sunt îndeplinite. Rezultatele unei regiuni care a încetat să mai raporteze sunt ignorate.
Când căderea unui monitor este confirmată, deschidem un incident și alertăm contactele din regulile de alertă ale monitorului.
Stări#
| Stare | Ce înseamnă |
|---|---|
| Funcțional | Ultimele verificări au reușit. |
| Căzut | O cădere a fost confirmată; există un incident deschis. |
| În pauză | Ai pus monitorul pe pauză. Fără verificări, fără alerte. |
| Necunoscut | Încă neverificat (sau un tip de înregistrare DNS care nu este verificat încă). |
| Mentenanță | Apare cât timp monitorul se află într-o fereastră de mentenanță activă. |
Pauza și reluarea sunt gratuite, dar un monitor reluat se socotește din nou în limita de monitoare a planului.
HTTP(S)#
Trimitem o cerere către URL din fiecare regiune selectată și verificăm răspunsul. Ținta trebuie să fie un URL absolut http:// sau https:// (cel mult 2.048 de caractere).
| Setare | Câmp în API (config) |
Implicit | Detalii |
|---|---|---|---|
| Metodă | method |
GET |
GET, HEAD, POST, PUT, PATCH, DELETE sau OPTIONS. |
| Headere | headers |
niciunul | Cel mult 20 de headere personalizate, de exemplu Authorization. |
| Corpul cererii | body |
gol | Cel mult 10.000 de caractere (pentru POST, PUT, PATCH). |
| Coduri de stare acceptate | expectedStatusCodes |
200-399 |
Coduri și intervale separate prin virgulă, de exemplu 200-299,301. Orice alt cod este o eroare. |
| Urmează redirecționările | followRedirects |
activat | Cel mult 10 redirecționări. Dezactivează-l ca să verifici chiar redirecționarea. |
| Alertă de răspuns lent | slowThresholdMs |
dezactivat | 100–60.000 ms. După două răspunsuri consecutive mai lente, contactele primesc o alertă „lent” (monitorul rămâne Funcțional). |
| Autentificare Basic | basicAuthUser, basicAuthPassword |
— | Parola este criptată în baza de date și nu mai este afișată niciodată. |
O verificare eșuează la timeout, la o eroare de DNS sau de conexiune, la o eroare TLS (certificat invalid sau expirat) sau la un cod de stare neacceptat. Cererile au user agent-ul IsItUpRightNow/1.0 (+https://isituprightnow.com), pe care îl poți permite în firewall sau în protecția anti-bot.
Cuvânt cheie#
Un monitor de tip cuvânt cheie este un monitor HTTP(S) care caută în plus un text în primul megaoctet al răspunsului:
| Setare | Câmp în API (config) |
Detalii |
|---|---|---|
| Cuvânt cheie | keyword |
Obligatoriu, cel mult 500 de caractere. |
| Alertă când | keywordMode |
contains — căzut când cuvântul lipsește; notContains — căzut când cuvântul apare (util pentru texte precum „Eroare” sau „Mentenanță”). |
| Sensibil la majuscule | caseSensitive |
Dezactivat implicit. |
Ping#
Trimite o cerere ICMP echo către host și măsoară timpul dus-întors. Ținta este un nume de host sau o adresă IP. Unele rețele și unii furnizori cloud blochează ICMP; pentru acele hosturi folosește un monitor de port sau HTTP(S).
Port#
Deschide o conexiune TCP către host și port (config.port, 1–65535). Monitorul este funcțional dacă se poate stabili conexiunea — ideal pentru baze de date, servere de e-mail (25, 465, 587), SSH (22) sau servere de jocuri. Nu trimitem date.
Heartbeat (cron)#
Invers: jobul tău apelează un URL unic la fiecare rulare, iar noi te alertăm când un apel întârzie. Configurarea și exemplele sunt în Monitoare heartbeat.
Certificat SSL#
Se conectează prin TLS (portul 443, dacă nu specifici altul, de exemplu example.com:8443) și citește certificatul serverului.
- Monitorul este căzut când certificatul a expirat, nu este încă valid, este emis pentru alt nume sau nu este de încredere.
- Ești alertat înainte de expirare:
config.notifyDaysBeforeconține zilele (implicit[30, 14, 7], cel mult 10 valori între 1 și 365). Fiecare prag este anunțat o singură dată pentru fiecare certificat.
Expirarea domeniului#
Verifică înregistrarea domeniului prin RDAP o dată pe zi, indiferent de intervalul ales, și te alertează la pragurile din notifyDaysBefore (implicit cu 30, 14 și 7 zile înainte de expirare). Introdu domeniul înregistrabil (example.com); www. și URL-urile sunt eliminate automat. O interogare eșuată este reîncercată după șase ore și nu marchează niciodată monitorul drept căzut.
DNS#
Rezolvă hostul din regiunea care face verificarea.
| Setare | Câmp în API (config) |
Detalii |
|---|---|---|
| Tip de înregistrare | recordType |
A și AAAA sunt verificate în prezent. CNAME, MX, TXT și NS pot fi deja salvate, dar nu sunt încă verificate (în curând) — astfel de monitoare rămân Necunoscute. |
| Valori așteptate | expectedValues |
Listă opțională de adrese. Dacă o completezi, fiecare adresă așteptată trebuie să se afle printre răspunsuri, altfel verificarea eșuează. |
UDP#
Trimite către host și port (config.port) o datagramă cu conținutul din config.payload.
- Dacă setezi
expectedResponse, verificarea așteaptă un răspuns care conține acest text și eșuează la timeout sau la un răspuns diferit. - Fără el, putem verifica doar că trimiterea a reușit (UDP nu are conexiune), așa că îți recomandăm să setezi un răspuns așteptat.
Lista de monitoare#
Fiecare monitor are un rând:
- Starea și de cât timp: Funcțional de 4z 8h, Căzut de 12 min (cu codul erorii, de exemplu
503sauT/O, și un link către incidentul deschis), În pauză de 3z. - Ultimele 24 de ore: o bară pe oră. Verde înseamnă că toate verificările au trecut, portocaliu că unele au eșuat, roșu că majoritatea au eșuat; o linie scurtă înseamnă că în acea oră nu au existat verificări (de exemplu înainte de crearea monitorului). Treceți cu mouse-ul peste o bară, atingeți-o sau folosiți săgețile ca să vedeți ora, disponibilitatea și câte verificări au eșuat. Sub bare apare uptime-ul ultimelor 24 de ore.
- Meniul rândului (…): pauză sau reluare, editare, notificare de test, ștergere.
Deasupra listei puteți selecta monitoare pentru acțiuni în masă, căuta după nume sau URL, filtra după stare, tip și etichetă și sorta: Ordine personalizată, Căzute primele, Nume, Uptime (24 h) (cel mai mic primul) sau Timp de răspuns (cel mai lent primul). Mutarea prin tragere cu mânerul ⋮⋮ (sau cu Spațiu și săgețile) funcționează în Ordine personalizată, fără filtre, iar ordinea se salvează pentru toată echipa.
Panoul Starea curentă numără monitoarele după stare și arată câte dintre monitoarele planului folosiți. Ultimele 24 de ore arată disponibilitatea totală (media monitoarelor), incidentele începute, timpul total de cădere, MTBF și de cât timp nu ați avut incidente.
Pagina unui monitor#
- Starea curentă, Ultima verificare, Ultimele 24 de ore: starea și durata ei, când a rulat ultima verificare și barele pe ore.
- Uptime pentru ultimele 7, 30 și 365 de zile și pentru orice interval ales, fiecare cu incidentele și timpul de cădere. Verificările din ferestrele de mentenanță nu se iau în calcul. O perioadă care începe înainte de crearea monitorului se calculează de la creare (marcat din … (creat)). Istoricul mai vechi decât păstrează planul nu este disponibil, iar pagina spune asta.
- MTBF (timpul mediu dintre căderi) pe 7, 30 sau 90 de zile = timpul total în care monitorul a fost funcțional în acea perioadă (cât a existat, minus mentenanța și căderile) împărțit la numărul de incidente începute în ea. Fără niciun incident nu există ce măsura, așa că apare Niciun incident.
- Timp de răspuns pentru ultima oră, 24 de ore, 7 zile sau 30 de zile, cu media, cea mai rapidă și cea mai lentă verificare reușită. Intervalele lungi sunt grupate pe intervale de timp; treceți peste grafic pentru detaliile fiecărui punct.
- Domeniu și SSL (monitoare HTTP(S) și cuvânt cheie): expirarea și emitentul certificatului TLS, citite în timpul verificării HTTPS obișnuite, și expirarea înregistrării domeniului, verificată o dată pe zi prin RDAP. Până la prima verificare cardul afișează Neverificat încă; unele registre (de exemplu mai multe domenii de țară) nu publică data expirării.
- Următoarea mentenanță: fereastra de mentenanță activă sau următoarea pentru monitor, ori un buton pentru a crea una.
- Regiuni: de unde este verificat monitorul, pe o hartă.
- Ultimele incidente cu cauza: un cod scurt (
503,T/Opentru expirarea timpului,DNS,SSL,KWpentru cuvânt cheie, …) și ce înseamnă. Exportă CSV descarcă incidentele și toate verificările din ultimele 7, 30 sau 90 de zile (în limita istoricului planului). - Notificare de test trimite o alertă de test, marcată clar, contactelor de alertă ale monitorului. Nu deschide niciun incident și nu schimbă nimic; puteți trimite 3 la fiecare 10 minute. Testele prin SMS și apel vocal consumă credite.
Bine de știut#
- Rețelele private nu sunt accesibile. Verificările se conectează doar la adrese publice de internet; hosturile care se rezolvă la adrese private, de loopback sau link-local eșuează cu eroarea „țintă invalidă”. Asta îi protejează pe toți (protecție SSRF).
- Permiterea verificărilor noastre. Pentru verificările HTTP folosește user agent-ul de mai sus; adresele IP ale verificatoarelor se pot schimba, așa că nu îți recomandăm liste de IP-uri permise.
- Timpii de răspuns sunt măsurați din regiunile selectate și includ timpul pentru DNS, conexiune și TLS.
- Istoricul este păstrat pe durata inclusă în planul tău; vezi Prețuri.
Nu ai găsit ce căutai? Scrie-ne.