Alerte Sentry ca notificări pe iPhone

Conectezi Sentry la Honk și o eroare nouă din aplicația ta ajunge pe iPhone ca notificare, la nivelul dat de Sentry: un issue fatal e un Claxon continuu, o eroare un Claxon lung. Când rezolvi issue-ul în Sentry, Honk îl închide cu o revenire. Și regulile tale de alertă, inclusiv alertele pe metrici, pot trimite către Honk.

Totul merge printr-o integrare internă Sentry, care își semnează fiecare livrare cu propriul secret. Nu schimbi niciun SDK și nu faci niciun deploy, iar erorile din Sentry stau în același inbox cu serverele, plățile și joburile cron.

Înainte să începi

• Un cont Honk. Deocamdată, Honk e disponibil doar pe bază de invitație: cere acces.
• Un proiect pentru aplicație, într-un spațiu de lucru în care ești proprietar sau administrator.
• Dreptul de a crea integrări în organizația ta din Sentry.

1. Creează conexiunea în Honk

În aplicația web Honk, deschide proiectul, mergi la Conexiuni și apasă Conectează un serviciu. Alege Sentry, păstrează numele sau schimbă-l și apasă Conectează.

Honk îți arată URL-ul conexiunii, la URL de webhook. Începe cu https://honk-honk.app/v1/hooks/sentry/. Copiază-l și lasă pagina deschisă pentru pasul 3.

2. Creează o integrare internă în Sentry

În Sentry, deschide Settings ▸ Developer Settings ▸ Custom Integrations, apasă Create New Integration și alege Internal Integration. Dă-i un nume, de exemplu „Honk”, apoi:

• lipește URL-ul de la Honk la Webhook URL;
• la Permissions, setează Issue & Event la Read;
• la Webhooks, bifează issue;
• ca să folosești Honk în regulile de alertă, activează Alert Rule Action.

Lasă error nebifat: trimite fiecare eveniment în parte, iar Honk îl ignoră. Salvează integrarea.

3. Lipește secretul de client în Honk

După ce salvezi integrarea, Sentry afișează secțiunea ei Credentials. Copiază Client Secret, lipește-l la Secret de semnare în Honk și apasă Salvează secretul.

Până salvezi secretul, Honk refuză livrările de la Sentry. După aceea, verifică semnătura fiecărei livrări și le respinge pe cele care nu se potrivesc. Conexiunea arată ora ultimei livrări sau ultima eroare.

4. Adaugă Honk în regulile de alertă

Webhookul pentru issue-uri acoperă deja issue-urile noi, cele care revin și cele rezolvate, așa că acest pas e opțional. Ca să trimiți o regulă de alertă către Honk, deschide regula în Sentry și adaugă acțiunea care trimite o notificare prin integrarea ta. Merge atât pentru alertele pe issue-uri, cât și pentru alertele pe metrici, de exemplu o rată de erori peste un prag.

Le poți păstra pe amândouă. O alertă despre un issue ajunge în grupul acelui issue, lângă mesajele de la webhook: se adaugă la aceeași problemă în loc să deschidă una nouă, iar când rezolvi issue-ul în Sentry, problema se închide.

Ce devine fiecare eveniment

Issue-uri. Un issue nou sau unul care redevine nerezolvat (așa raportează Sentry o regresie) deschide o problemă la nivelul issue-ului:

• fatal: Claxon continuu;
• error: Claxon lung;
• warning: Claxon puternic;
• info și debug: Claxon ușor.

Mesajul are titlul issue-ului, locul în care a apărut, ID-ul scurt și proiectul din Sentry, plus un link către issue. Când rezolvi issue-ul în Sentry, primești o revenire cu titlul „Resolved: …”, care închide problema. Dacă atribui sau arhivezi un issue, în Honk nu se schimbă nimic. Fiecare issue are grupul lui, iar Sentry raportează un issue o singură dată, nu la fiecare eveniment, așa că o eroare care apare de 500 de ori înseamnă tot o singură notificare.

Alerte pe issue-uri. O alertă declanșată deschide o problemă la nivelul evenimentului care a declanșat-o. Intră în grupul issue-ului la care se referă, așa că, atunci când rezolvi issue-ul în Sentry, se închide și ea.

Alerte pe metrici. Critical e un Claxon continuu, warning un Claxon puternic, iar resolved trimite o revenire. O alertă rămâne un singur grup din momentul în care se declanșează până se rezolvă, iar un warning care devine critical te anunță din nou imediat.

Dacă ai activat activitățile live în Honk pentru iPhone, un Claxon lung sau un Claxon continuu poate rămâne pe ecranul de blocare până la revenire sau până îl marchezi ca gestionat.

Planuri și limite

Fiecare conexiune intră în limita planului spațiului tău de lucru: Free include 2, Pro 20 și Team 100. Mesajele de la Sentry intră în limitele zilnice de mesaje și notificări ale planului, ca oricare altele; le găsești la prețuri.

Pentru alertele de uptime și de infrastructură în același inbox, vezi ghidul pentru Grafana și Alertmanager și ghidul pentru Uptime Kuma. Dacă aplicația ta rulează pe Laravel, ghidul pentru excepțiile din Laravel raportează erorile fără Sentry, iar Scapă de oboseala alertelor explică cum ține Honk o problemă la o singură notificare.