Grafana Entegrasyonu - Altyapı Uyarıları

Grafana; binlerce kuruluşun metrikleri, günlükleri ve izleri görselleştirmek için kullandığı popüler bir açık kaynaklı analiz ve izleme çözümüdür. Grafana'yı Echobell ile entegre ederek metrikleriniz bir uyarı tetiklediğinde anında bildirim alabilirsiniz — ister yüksek CPU kullanımı, ister bellek baskısı, ister başarısız servisler ya da izlediğiniz başka bir koşul olsun.

Bu kapsamlı kılavuz, temel yapılandırmadan gelişmiş uyarı yönetimi stratejilerine kadar Grafana uyarılarını Echobell ile kurmanızda size adım adım yol gösterecek.

Ön Koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

• En az bir kanal oluşturulmuş bir Echobell hesabı (Buradan başlayın)
• Bir Grafana örneğine erişim (8.0 veya üzeri sürüm önerilir; en iyi uyumluluk için 9.0+)
• Grafana'da uyarı bildirimlerini yapılandırmak için yönetici erişimi (genellikle Admin veya Editor rolü gerekir)
• Grafana panoları ve metrikleri hakkında temel bilgi
• İzleme altyapınıza ve uyarı gereksinimlerinize aşinalık

Kurulum Özeti

Entegrasyon süreci, tamamlanması genellikle 10-15 dakika süren beş ana adımdan oluşur:

1. Bir Echobell Kanalı Oluşturun - Grafana uyarıları için özel bir kanal kurun
2. Bildirim Şablonlarını Yapılandırın - Uyarıların cihazınızda nasıl görüneceğini tasarlayın
3. Webhook URL'sini Alın - Kanalınıza ait benzersiz webhook uç noktasını edinin
4. Grafana İletişim Noktasını Kurun - Grafana'yı uyarıları Echobell'e gönderecek şekilde yapılandırın
5. Grafana'da Uyarı Kuralları Oluşturun - Hangi koşulların bildirim tetikleyeceğini tanımlayın

Yapılandırma tamamlandığında uyarılar Grafana'dan cihazınıza otomatik ve gerçek zamanlı olarak akar.

Adım Adım Kılavuz

{{alertName}} - {{status}}

🔔 Alert: {{alertName}}
📊 Metric: {{metric}}
📈 Value: {{value}}
⏰ Time: {{time}}
ℹ️ Message: {{message}}

{
  "alertName": "{{ .alertName }}",
  "status": "{{ .status }}",
  "metric": "{{ .metric }}",
  "value": "{{ .value }}",
  "time": "{{ .time }}",
  "message": "{{ .message }}",
  "externalLink": "{{ .dashboardURL }}"
}

Entegrasyonu Test Etme

Kurulumunuzu doğrulamak için:

1. Hızlıca tetiklenecek bir koşula sahip test uyarı kuralı oluşturun
2. Koşulun sağlanmasını bekleyin
3. Uyarı bildirimi için Echobell uygulamanızı kontrol edin
4. Tüm uyarı değişkenlerinin düzgün göründüğünü doğrulayın
5. Bağlantılı Grafana panosuna erişmek için bildirime tıklayın

Uyarı Bildirim Türleri

Grafana uyarıları kanalına abone olurken şu kritik bildirim türlerini yapılandırın:

• Acil ve kritik sistem uyarıları ile acil durum bildirimleri için Zaman Duyarlı'yı kullanın
• Ciddi kesintiler, kritik eşik aşımları veya acil durum uyarıları için Arama'yı kullanın
• Standart bilgilendirici uyarılar ve rutin bildirimler için Normal'i kullanın

Uyarı Yönetimi için En İyi Uygulamalar

Uyarı Şablonu Düzeni

Uyarı şablonlarını kanallar arasında net ve tutarlı tutun:

Title: {{alertName}} - {{status}}
Body: 
Server: {{instance}}
Metric: {{metric}}  
Current: {{value}}
Threshold: {{threshold}}

• Yapılandırılmış biçimlendirme kullanın - Bilgileri net etiketlerle düzenleyin
• Kritik bilgileri ekleyin - Metrik adı, değer, eşik, etkilenen sistem
• Emojileri idareli kullanın - Kritik için 🚨, uyarı için ⚠️, çözüldü için ✅
• Başlıkları kısa tutun - Sorunu hemen anlatan 5-8 kelimeyi hedefleyin
• Şablonları test edin - Yayına almadan önce biçimlendirmeyi doğrulamak için test uyarıları gönderin

Kritik Uyarı Yapılandırması

Bildirim yorgunluğundan kaçınmak için uygun uyarı eşikleri belirleyin:

• Aşırı uyarıdan kaçının - Eşikleri ilgi çekici değil, harekete geçirilebilir düzeylere ayarlayın
• Histerezis kullanın - Uyarı ve kurtarma için farklı eşikler yapılandırın
• İlgili uyarıları gruplayın - İlişkili koşulları tek bir uyarı kuralında birleştirin
• Uygun değerlendirme aralıkları belirleyin - Tepkiselliği gürültü azaltmayla dengeleyin
• Zaman pencerelerini göz önünde bulundurun - Uyarmadan önce birden fazla koşul kontrolü yapın

Örnek eşik stratejisi:

# Kötü: %50 CPU'da uyar (çok hassas)
cpu_usage > 50

# Daha iyi: 5 dakika boyunca %80'de uyar
avg_over_time(cpu_usage[5m]) > 80

# En iyi: Kademeli uyarılar
# %70 sürekli olduğunda Uyarı, %90'da Kritik

Anlamlı Uyarı Adları Kullanın

Uyarılara, şunları hemen anlatan açıklayıcı adlar verin:

• Ne izleniyor (CPU, Bellek, Disk)
• Nerede gerçekleşiyor (üretim, hazırlık, belirli bir örnek)
• Neden önemli (kullanıcıya dönük servis, kritik veritabanı)

İyi örnekler:

• "Üretim Veritabanı - Yüksek Bağlantı Havuzu Kullanımı"
• "API Gateway - Yanıt Süresi Bozulması"
• "Worker Node 3 - Disk Alanı Kritik"

Kaçının:

• "Uyarı 1", "Test Uyarısı", "Yüksek CPU"

Yeterli Bağlam Ekleyin

Uyarı mesajınız şu soruları yanıtlamalıdır:

• Ne oldu? Tetiklenen belirli koşul
• Nerede? Hangi sistem, servis veya örnek
• Ne kadar kötü? Mevcut değer ile eşik karşılaştırması
• Ne zaman? Uyarının zaman damgası
• Sırada ne var? İlgili panoya veya çalıştırma kılavuzuna bağlantı

Öncelik Düzeylerini Yapılandırın

Echobell'in bildirim türlerini stratejik olarak kullanın:

• Normal: Bilgi uyarıları, çözüldü bildirimleri, acil olmayan uyarılar
• Zaman Duyarlı: Saatler içinde ilgilenilmesi gereken önemli uyarılar
• Arama: Anında müdahale gerektiren kritik üretim sorunları

Grafana önem düzeylerini bildirim türleriyle eşleyin:

Critical + Production → Calling
High + Production → Time Sensitive  
Medium → Time Sensitive
Low → Normal
Info/Resolved → Normal

Uyarı Güvenliği

İzleme altyapınızı koruyun:

• Webhook URL'lerini gizli tutun - Bunlar bildirim göndermek için kimlik doğrulamasız erişim sağlar
• Ortam değişkenleri kullanın - URL'leri Grafana provisioning dosyalarına gömmeyin
• Webhook'ları düzenli olarak yenileyin - Özellikle ekip üyeleri ayrıldığında
• Webhook teslimatını izleyin - Başarısız teslimatları takip edin ve anormallikleri inceleyin
• Uyarı yapılandırmalarını denetleyin - Uyarıları değiştirme yetkisi olanları düzenli olarak gözden geçirin
• Uyarı kaynaklarını doğrulayın - İletişim noktaları için Grafana'nın yerleşik kimlik doğrulamasını kullanın

Uyarı Yaşam Döngüsü Yönetimi

Sağlıklı bir uyarı düzeni koruyun:

1. Düzenli gözden geçirme - Eskimiş kuralları kaldırmak için uyarıları üç ayda bir denetleyin
2. Uyarıları belgeleyin - Her uyarının neden var olduğunu açıklayan açıklamalar ekleyin
3. Uyarı geçmişini takip edin - Hangi uyarıların en sık tetiklendiğini izleyin
4. Eşikleri ayarlayın - Geçmiş verilere ve yanlış pozitif oranlarına göre düzenleyin
5. Eski uyarıları arşivleyin - Emekliye ayrılan servislerin kurallarını devre dışı bırakın ama saklayın
6. Sürüm kontrolü - Uyarı değişikliklerini izlemek için Grafana provisioning kullanın

Performans Değerlendirmeleri

• Uyarı fırtınalarından kaçının - Uygun gruplama ve zamanlama yapılandırın
• Bildirim politikaları kullanın - Farklı önem düzeylerini uygun kanallara yönlendirin
• Bekleme/tekrar aralıkları belirleyin - Yinelenen bildirimleri önleyin
• Benzer uyarıları gruplayın - Toplama ile bildirim hacmini azaltın
• Günün saatini göz önünde bulundurun - Mesai saati filtresi için koşulları kullanın

Gerçek Hayattan Örnekler

Yüksek CPU Uyarısı

Title: {{instance}} CPU Critical
Body: CPU usage: {{cpu_percent}}%
Duration: {{duration}}
Time: {{time}}
Dashboard: {{dashboard_url}}

Bellek Baskısı

Title: Memory Warning - {{hostname}}
Body: Available: {{available_mb}}MB ({{percent_free}}%)
Threshold: {{threshold_mb}}MB
Action: Check memory-intensive processes

Servis Çalışmıyor

Title: 🚨 {{service_name}} Unreachable
Body: Health check failed
Last success: {{last_successful_check}}
Impact: {{affected_users}} users affected
Runbook: {{runbook_url}}

Yaygın Kullanım Senaryoları

Altyapı İzleme

• CPU, bellek, disk kullanımı eşikleri
• Ağ verimi ve paket kaybı
• Servis erişilebilirliği ve sağlık kontrolleri
• Container ve pod durumu izleme

Uygulama Performansı

• Yanıt süresi bozulması
• Hata oranı artışları
• Veritabanı bağlantı havuzunun tükenmesi
• Kuyruk derinliği ve işleme gecikmesi

İş Metrikleri

• İşlem hacmi anormallikleri
• Dakika başına gelir düşüşleri
• Etkin kullanıcı sayısı değişimleri
• API hız sınırına yaklaşma

Güvenlik İzleme

• Başarısız kimlik doğrulama denemeleri
• Olağan dışı erişim desenleri
• Sertifika süresi dolma uyarıları
• Güvenlik duvarı kuralı ihlalleri

Daha fazla entegrasyon stratejisini Grafana arama bildirimleri hakkındaki blog yazımızda öğrenin.

Sorun Giderme

Uyarı almıyorsanız şu tanılama adımlarını izleyin:

Webhook Bildirimleri Tetiklemiyor

1. Webhook URL'sinin doğru kopyalandığını doğrulayın

   • Echobell kanalınıza gidin → Tetikleyiciler → Webhook
   • https://hook.echobell.one/t/ dahil olmak üzere URL'nin tamamını kopyalayın
   • Grafana'ya yapıştırırken fazladan boşluk veya karakter eklenmediğinden emin olun

2. Kanalın etkin olup olmadığını kontrol edin

   • Echobell uygulamasını açın
   • Grafana uyarıları kanalınıza gidin
   • Yanlışlıkla silinmediğinden veya arşivlenmediğinden emin olun

3. Etkin abone bulunduğundan emin olun

   • Bildirim alınabilmesi için en az bir kişinin abone olması gerekir
   • Kanalın abone listesini kontrol edin
   • Kendi aboneliğinizin etkin olduğunu doğrulayın

4. Grafana'nın iletişim noktası yapılandırmasını doğrulayın

   • Grafana'da Alerting → Contact points bölümüne gidin
   • Echobell iletişim noktanızı açın
   • URL'nin kanalınızın webhook'uyla eşleştiğini doğrulayın
   • HTTP Method'un POST olarak ayarlandığını kontrol edin
   • Content-Type'ın application/json olduğunu doğrulayın

5. Grafana'nın uyarı kuralı yapılandırmasını kontrol edin

   • Alerting → Alert rules bölümüne gidin
   • Tetiklenmesi gereken kuralı açın
   • Kuralın Echobell iletişim noktanıza bağlı olduğunu doğrulayın
   • Bildirim politikasının doğru iletişim noktasına yönlendirdiğini kontrol edin

6. Grafana'nın uyarı geçmişini inceleyin

   • Alerting → Alert rules bölümüne gidin
   • Kuralınıza tıklayın → Show history
   • Uyarının gerçekten tetiklendiğini (pending durumunda olmadığını) doğrulayın
   • Değerlendirme hatası olup olmadığına bakın

Uyarılar Tetikleniyor Ama İletilmiyor

1. Webhook'u doğrudan test edin

   curl -X POST https://hook.echobell.one/t/<channel-token> \
     -H "Content-Type: application/json" \
     -d '{"alertName": "Test", "status": "firing"}'

   Bundan bildirim alıyor ancak Grafana'dan almıyorsanız sorun Grafana yapılandırmasındadır.

2. Grafana'nın bildirim politikalarını kontrol edin

   • Alerting → Notification policies bölümüne gidin
   • Kuralınızın etiketlerinin politika yönlendirme kurallarıyla eşleştiğini doğrulayın
   • Zamanlama sorunlarına bakın (gruplama bekleme süresi, tekrar aralıkları)

3. Grafana günlüklerini inceleyin

   • Grafana günlüklerinde webhook teslim hatalarını arayın
   • HTTP durum kodlarını kontrol edin (200 olmalıdır)
   • Zaman aşımı veya bağlantı hatalarını araştırın

Bildirimler Yanlış Görünüyor

1. Şablon değişkenleri Grafana'nın yüküyle eşleşmiyor

   • Grafana .alertName, .status gibi belirli alan adları gönderir
   • Şablon değişkenlerinizin yük yapısıyla eşleştiğinden emin olun
   • Gerçek yükü görmek için Grafana'nın "Test" düğmesiyle deneyin

2. Bildirimlerde eksik bilgi

   • Uyarı yapılandırmasına bağlı olarak bazı Grafana değişkenleri boş olabilir
   • Şablonlara yedek değerler ekleyin: {{alertName || "Unknown Alert"}}
   • Kullanılabilir şablon değişkenleri için Grafana dokümanlarına bakın

3. JSON ayrıştırma hataları

   • Grafana'nın mesaj şablonunun geçerli JSON olduğunu doğrulayın
   • Kaçırılmamış tırnak veya özel karakterlere bakın
   • Yük yapısını doğrulamak için çevrimiçi JSON doğrulayıcıları kullanın

Uyarı Zamanlama Sorunları

1. Uyarıların gecikmeli gelmesi

   • Ağ bağlantınızı kontrol edin
   • Grafana'nın Echobell sunucularına erişebildiğini doğrulayın
   • Grafana'nın değerlendirme aralığını gözden geçirin (gecikmeye yol açabilir)
   • Bildirim politikası zamanlama ayarlarını kontrol edin

2. Yinelenen bildirimler

   • Bildirim politikalarındaki tekrar aralığı ayarlarını gözden geçirin
   • Aynı koşul için birden fazla kuralın tetiklenip tetiklenmediğine bakın
   • Kanal için yalnızca bir iletişim noktası yapılandırıldığını doğrulayın

3. Sessiz saatlerdeki bildirimler

   • iOS Odak modları bildirim iletimini etkileyebilir
   • Zaman Duyarlı ve Arama bildirimleri bazı Odak modlarını aşabilir
   • Cihazınızın bildirim ayarlarını gözden geçirin

Sorun Devam Ediyorsa

Yukarıdakilerin tümünü denediğiniz hâlde sorun sürüyorsa:

1. Grafana hata ayıklama günlüğünü etkinleştirin

   • grafana.ini dosyasına level = debug ile bir [log] bölümü ekleyin
   • Günlüklerde webhook teslim denemelerini ve yanıtlarını inceleyin

2. Grafana'nın yerleşik test özelliğini kullanın

   • İletişim noktası ayarlarında örnek bir uyarı göndermek için "Test"i kullanın
   • Bu, sorunun kurallarda mı yoksa teslimatta mı olduğunu ayırt etmeye yardımcı olur

3. Farklı bir uyarı kuralı deneyin

   • Kesinlikle tetiklenecek koşullara sahip basit bir test kuralı oluşturun
   • Test çalışıyor ama üretim kuralları çalışmıyorsa sorun kural yapılandırmasındadır

4. Destekle iletişime geçin

   • Destek Merkezimizi ziyaret edin
   • echobell@weelone.com adresine şunlarla birlikte e-posta gönderin:
     • Grafana sürümü
     • Örnek uyarı yükü (hassas verileri çıkarın)
     • Webhook URL'si (token gizlenmiş olarak)
     • Denediğiniz adımlar
     • Beklenen ve gerçekleşen davranış

İlgili Dokümantasyon ve Kaynaklar

Echobell Dokümantasyonu

• Webhook Entegrasyon Kılavuzu - Webhook işlevselliğine derinlemesine bakış
• Şablon Sistemi - Bildirim şablonu sözdizimini öğrenin
• Koşullar - Uyarıları ölçütlere göre filtreleyin
• Bildirim Türleri - Uyarı önceliklerini anlayın
• Başlarken - Echobell'in temelleri ve kurulumu

Grafana Kaynakları

• Grafana Alerting Dokümantasyonu - Resmi Grafana uyarı kılavuzu
• Contact Points - Grafana iletişim noktası yapılandırması
• Notification Policies - Uyarı yönlendirme ve gruplama
• Alert Rules - Uyarı kuralları oluşturma ve yönetme

İlgili Entegrasyonlar

• Prometheus Entegrasyonu - Doğrudan Prometheus uyarıları
• Uptime Kuma - Web sitesi çalışma süresi izleme
• GitHub Actions - CI/CD hattı uyarıları
• Home Assistant - Akıllı ev bildirimleri

Blog Yazıları

• Grafana Uyarıları için Telefon Aramalı Bildirimleri Etkinleştirin - Gelişmiş Grafana entegrasyon stratejileri
• Hiçbir GitHub Actions Hatasını Kaçırmayın - CI/CD uyarılarında en iyi uygulamalar
• UTC Koşullarıyla Zaman Penceresi Bildirimleri - Mesai saati filtreleme

Sonraki Adımlar

Artık Grafana'yı Echobell ile entegre ettiğinize göre:

1. Uyarılarınızı ince ayarlayın - Eşikleri gerçek kullanım desenlerine göre düzenleyin
2. Ek kanallar kurun - Farklı önem düzeyleri için ayrı kanallar oluşturun
3. Diğer entegrasyonları keşfedin - Echobell'e daha fazla araç bağlayın (tüm entegrasyonları görüntüleyin)
4. Ekibinizle paylaşın - Uyarı kanallarınıza ekip üyelerini ekleyin
5. Kurulumunuzu belgeleyin - Belirli uyarılara yanıt vermek için çalıştırma kılavuzları oluşturun
6. Uyarı etkinliğini izleyin - Yanlış pozitif oranlarını ve yanıt sürelerini takip edin

Daha fazla sistem izlemeye hazır mısınız? Diğer popüler izleme araçları ve platformları için eksiksiz entegrasyon kılavuzumuza göz atın.