Cum funcționează Honk
Magazinul, formularele, casa și serverele tale îi spun lui Honk ce s-a întâmplat. Honk păstrează fiecare mesaj, adună repetările, te anunță doar pentru ce nu poate aștepta și lasă restul într-un inbox pe care îl citești mai târziu.
De la cerere la notificare
- Cerere Codul tău trimite un JSON la
/v1/messages, cu cheia API a unui proiect. - Salvat Honk îl scrie pe disc, apoi răspunde cu
202. O reîncercare cu acelașiIdempotency-Keyprimește înapoi același id, nu creează un al doilea mesaj. - Grupat Intră în grupul dat de proiect, mediu, sursă, canal și
group_key. - Direcționat Pentru fiecare persoană, Honk decide: notificare acum, la rezumat sau doar în inbox.
- Trimis Notificările pleacă prin serviciul push al Apple și prin Web Push. Totul rămâne în inbox și poți căuta oricând în el.
202 înseamnă că Honk are mesajul, nu că l-a văzut cineva. De aceea aplicațiile nu spun niciodată „livrat”: Apple și serviciile push ale browserelor confirmă doar că au acceptat o notificare.
Grupuri și episoade
Un grup adună evenimentele despre același lucru. Două evenimente intră în același grup când vin din același proiect, mediu, sursă și canal și au același group_key. Fără group_key, Honk compară titlul și mesajul exact, așa că se adună doar evenimentele identice.
Un episod cuprinde o problemă dintr-un grup, de la primul eveniment până când se rezolvă sau se oprește. Se încheie în unul din două feluri: sursa raportează o revenire pentru același group_key sau nu mai vine nimic o vreme (implicit 24 de ore) și episodul devine inactiv. Inactiv nu înseamnă rezolvat, așa că următorul eveniment deschide un episod nou și te anunță din nou.
Cu Gestionat îți notezi doar că te-ai ocupat de un episod. Nu înseamnă că problema s-a rezolvat, iar un episod nou îți cere din nou atenția.
Cum alegi o cheie de grup
db/backup- un singur job: toate eșecurile backupului de noapte ajung în același grup
requests/4812- câte un grup pentru fiecare cerere de la client, ca doi clienți să nu ajungă niciodată în aceeași notificare
disk/app-01/var- un singur disc, pe un singur server
ci/acme/api/main- un branch dintr-un repository, în CI
Activitate
Evenimente
Când primești o notificare
Decide serverul, pentru fiecare persoană care urmărește proiectul, după aceleași reguli de fiecare dată. AI-ul de pe iPhone poate reformula o notificare, dar nu schimbă niciodată ce primești.
| Primul eveniment dintr-un episod | Pleacă imediat. |
|---|---|
| Un nivel mai puternic decât la ultima notificare | Pleacă imediat, chiar și în pauza dintre actualizări. Ce ai pus pe silențios rămâne pe silențios. |
| O revenire | Pleacă imediat, cu ora raportată de sursă. |
| Mai multe la fel | Cel mult o actualizare la 5 minute (pauza între actualizări, reglabilă între 1 și 120 de minute), cu numărul la zi. |
| Sub pragul tău pentru notificări | Intră în rezumat, care pleacă implicit la 15 minute. Un rezumat gol nu se trimite niciodată. |
| În orele tale de liniște | Sunt reținute și vin într-un singur rezumat la final. Trec doar evenimentele urgente de la o cheie care are voie să le trimită. |
| Pe silențios sau cu o regulă „doar în inbox” | Nicio notificare. Evenimentul ajunge totuși în inbox și rămâne necitit. |
Un Claxon lung sau un Claxon continuu are mereu cel puțin prioritate ridicată. Pentru prioritatea urgentă, cheia API trebuie să aibă activată opțiunea „Permite prioritatea «urgent»”.
O noapte cu ore de liniște
Orele de liniște se setează pe persoană și pe proiect, în fusul tău orar, și țin cont singure de ora de vară. Iată o noapte cu ore de liniște între 22:00 și 07:00:
- Încep orele de liniște.
- Un job de backup trimite de două ori un Claxon ușor. Amândouă intră în rezumat.
- Un Claxon lung de la API-ul de facturare. Așteaptă până dimineață.
- Un Claxon continuu urgent, de la o cheie care are voie să trimită evenimente urgente. Trece, iar pe ecranul de blocare pornește o activitate live.
- Sursa raportează revenirea. Activitatea live arată „Revenit”.
- Se termină orele de liniște. Primești un singur rezumat cu tot ce a fost reținut.
Ca să treacă, un eveniment are nevoie de trei lucruri: e trimis cu prioritatea urgent, cheia API are activată opțiunea „Permite prioritatea «urgent»”, iar în orele tale de liniște e activată opțiunea „Lasă să treacă mesajele urgente”.
Rezumate și rezumatul zilnic
Evenimentele de rutină de sub pragul tău pentru notificări se adună într-un rezumat: implicit o notificare la 15 minute, reglabil între 5 minute și 24 de ore, pe proiect și pe persoană. Un rezumat gol nu se trimite niciodată.
Rezumatul zilnic e o singură notificare discretă pe zi, la ora aleasă de tine (implicit 08:00). De obicei arată așa: „2 incidente deschise · 5 cereri noi de la clienți · 120 de mesaje de ieri”. Nu vine în zilele în care n-a sosit nimic și așteaptă să se termine orele tale de liniște.
marți, 6 octombrie
08:00
Reguli și notificări oprite
Regulile unui proiect se aplică în ordine, la fiecare eveniment. O regulă poate verifica titlul, mesajul, sursa, mediul, canalul, gravitatea, prioritatea, tipul evenimentului, cheia de grup, categoria sau un câmp din metadate. Apoi poate trimite evenimentul în rezumat, îl poate lăsa doar în inbox, îi poate seta categoria sau îi poate ridica prioritatea.
Când pui ceva pe silențios, asta te privește doar pe tine. Poți pune un grup pe silențios pentru o oră chiar din notificarea lui, poți face la fel cu un proiect întreg sau poți folosi Totul pe silențios din centrul de control ca să oprești pentru o oră toate notificările din spațiul de lucru. Evenimentele sosesc în continuare și rămân necitite.
Spații de lucru și proiecte
Spațiul de lucru stabilește cine are acces și cât poate folosi. Proiectul arată de unde vin evenimentele.
Un spațiu de lucru are membri, fiecare cu rolul lui (proprietar, administrator sau membru), și un plan. Limitele planului se aplică pe spațiu de lucru.
Un proiect e o aplicație, un server sau un script. Fiecare proiect are propriile chei API, reguli, perioadă de păstrare (până la limita planului) și setări pentru rezumat și pauza între actualizări.
- Fiecare cont începe cu un spațiu de lucru personal, pe planul Free.
- O echipă își face un spațiu de lucru comun și invită oameni în el.
- Proprietarii și administratorii văd toate proiectele. Membrii văd proiectele la care au acces.
- Orele de liniște, ce pui pe silențios și setările de notificare sunt ale fiecăruia, pe fiecare proiect, deci nu schimbă niciodată ce primește altcineva pe telefon.
Dacă ai folosit Sentry, modelul e același: un spațiu de lucru e o organizație, un proiect e un proiect, iar o cheie API e un DSN.
- API de facturare 2 chei API · 4 reguli · 30 de zile
- Acasă 1 cheie API · ore de liniște de la 22:00 la 07:00
Ce nu este Honk
- Nu e un sistem de monitorizare. Honk primește evenimente, nu îți verifică serviciile. Dacă un server cade fără să mai trimită nimic, nu ajunge nimic, așa că pune și o verificare de uptime care să raporteze la Honk.
- Nu e un sistem de gardă (on-call). Nu are ture sau reguli de escaladare și nu trimite niciodată SMS-uri și nici nu te sună.
- Nu e o arhivă. Mesajele se șterg după 3, 14 sau 30 de zile, în funcție de plan.