İçindekiler
API'nizin gecenin üçünde çökmesi sorun değil. Sorun, bunu kullanıcılarınız destek kutunuzu doldurduktan sonra, sabah dokuzda öğrenmenizdir.
Çoğu izleme aracı arızaları tespit etmekte harikadır. Uyarıyı doğru zamanda birinin gerçekten görmesini sağlamakta ise berbattır. Standart bir push bildirimi, biri telefonunu eline alana kadar kilit ekranında öylece bekler. Bir Slack mesajı, gece kimsenin bakmadığı bir kanalda kaybolur. Bir e-posta pazartesi sabahına kadar okunmadan kalır.
Telefon aramalı uyarılar bu denklemi değiştirir. API sağlık denetiminiz başarısız olduğunda telefonunuz gerçekten çalar — tıpkı başka herhangi bir acil konuda gelen bir telefon araması gibi. Açarsınız, sorunun ne olduğunu duyarsınız ve saatler sonra değil, hemen düzeltmeye başlayabilirsiniz.
Push bildirimleri kritik servislerde neden yetersiz kalır?
Ortalama bir akıllı telefon günde 50 ila 100 push bildirimi alır. API arıza uyarınız; uygulama güncellemeleri, sosyal medya bildirimleri, haber uyarıları ve cihazdaki diğer tüm uygulamalarla yarışır. Her şey acil olduğunda hiçbir şey acil hissettirmez.
Bu, tehlikeli bir örüntü yaratır:
- İzleme aracınız API'nin 500 hatası döndürdüğünü tespit eder
- Telefonunuza bir push bildirimi gönderir
- Telefonunuz masanın üstünde, yüzü aşağı bakıyor ve Odak Modu açık
- Uyarı, biri fark edene kadar sessizce orada bekler — saatler sonra
Kritik olmayan bir mikroservis için bu gecikme sinir bozucudur. Bir ödeme API'si, bir kimlik doğrulama servisi ya da ana ürününüzün arka ucu için bu gecikme gerçek para ve güven kaybettirir.
Telefon aramalı uyarılar Echobell ile nasıl çalışır?
Echobell bildirimleri üç aciliyet seviyesinde iletir:
- Normal (Etkin): Standart push bildirimi
- Zaman duyarlı: iOS Odak Modu'nu aşar ama çalmaz
- Arama: Telefonunuzu normal bir telefon araması gibi çaldırır
Kullanıcıları etkileyen API arızaları için arama seviyesi uygundur. Bu, başka herhangi bir acil telefon aramasını nasıl ele alacağınızı yansıtır — telefon çaldığı için açarsınız.
Kurulum basittir:
- Echobell'de bir kanal oluşturun
- Bildirim türünü Arama olarak ayarlayın
- İzleme aracınızı webhook ile bağlayın
- Sağlık denetimi başarısız olduğunda Echobell telefonunuzu arar
İzleme aracınızdan arama uyarıları kurma
Çoğu izleme platformu, bir denetim başarısız olduğunda webhook gönderebilir. Bağlantıyı şöyle kurarsınız.
Mevcut sağlık denetiminizi kullanma
Zaten bir sağlık uç noktanız varsa (/health veya /status gibi), izleyicinizi bunu düzenli aralıklarla denetleyecek biçimde yapılandırın. Yanıt 200 değilse webhook'u tetikleyin.
Echobell, başlık ve gövde içeren webhook yüklerini kabul eder:
curl -X POST https://hook.echobell.one/t/<channel-token> \
-H "Content-Type: application/json" \
-d '{
"title": "API DOWN: payment-service",
"body": "Health check failed - 500 error at 03:42 UTC",
"notificationType": "calling",
"externalLink": "https://your-dashboard.example.com/incidents/123"
}'Telefonun çalmasını sağlayan şey notificationType: calling alanıdır.
Uyarıya neler eklemeli?
Uyarı içeriğini hızlıca okunabilir tutun. Gecenin üçünde bir aramayı açtığınızda sorunu anında anlamanız gerekir:
- Servis adı — hangi API veya mikroservis arızalandı
- Hata türü — zaman aşımı, 5xx, bağlantı reddedildi
- Zaman damgası — arıza ne zaman başladı
- Bağlantı — hemen nereye bakacaksınız
Burası uzun mesajların yeri değil. Amaç, tamamen uyanmanız mı yoksa uyarıyı onaylayıp uykuya dönmeniz mi gerektiğine karar verebilmeniz için anlık bağlam sağlamaktır.
Doğru aciliyet seviyesini seçmek
Her API arızası telefon araması gerektirmez. Arama uyarılarını şunlar için kullanın:
- Ödeme ve faturalama servisleri
- Kimlik doğrulama ve oturum açma uç noktaları
- Kullanıcıların doğrudan etkileşime girdiği birincil ürün API'leri
- Diğer kritik sistemlerin bağımlı olduğu servisler
Zaman duyarlı bildirimleri şunlar için kullanın:
- Önemli ama gelir açısından kritik olmayan ikincil servisler
- Geliştirme veya staging ortamları
- Uyarı işaretleri (henüz tam arıza olmayan yüksek hata oranları)
Normal bildirimleri şunlar için kullanın:
- Kritik olmayan arka plan işleri
- Eylem gerektirmeyen bilgilendirici metrikler
Bu kademeli yaklaşım, uyarı yorgunluğu yaratmadan haberdar kalmanızı sağlar.
Birden fazla servise ölçeklemek
Birden fazla API çalıştırıyorsanız her servis ya da servis grubu için ayrı kanallar oluşturun:
production-payment-api— arama seviyesiproduction-user-api— arama seviyesiproduction-analytics-api— zaman duyarlıstaging-all— zaman duyarlı
Böylece aciliyeti servis bazında ayarlayabilirsiniz. Ödeme API'niz bir telefon aramasını hak eder; analitik hattınız muhtemelen etmez.
Asıl fayda
Telefon aramalı uyarıların değeri çalmanın kendisinde değildir. Değer, yarattığı davranış değişikliğindedir:
- Sorunları daha hızlı çözersiniz, çünkü onlardan anında haberdar olursunuz
- Bir şey bozulursa gerçekten uyandırılacağınızı bildiğiniz için daha rahat uyursunuz
- Saatler yerine dakikalar içinde yanıt verdiğiniz için kullanıcılarınız daha kısa kesintiler yaşar
Kritik servisler için mesele tam olarak bu farktır.