Grafana entegrasyonu

Grafana Alerting ile nöbetçi mühendisinizi çağırın

Oncallz'u Grafana Alerting'de bir webhook contact point'i olarak ekleyin; tetiklenen uyarılar o an nöbetçi olan kişiyi çağırsın. Contact point başlığında yapacağınız küçük bir değişiklikle Grafana'nın resolved bildirimi olayı da çözer.

Ücretsiz başla Tüm entegrasyonlar

Grafana → Oncallz kurulumu birkaç dakikada

1 Oncallz'da Entegrasyonlar sayfasını açın, takımı seçin, entegrasyona "Grafana" adını verin, Yinelenen olaylar ayarını "Başlığa göre grupla" yapın ve Oluştur'a tıklayın.
2 Yeni entegrasyonun Gelen URL'sini kopyalayın.
3 Grafana'da Alerts & IRM → Alerting → Contact points bölümüne gidin, + Add contact point'e tıklayın, Webhook entegrasyonunu seçin ve Oncallz URL'sini yapıştırın.
4 İsteğe bağlı webhook ayarlarında Title alanına tetiklenen uyarı sayısını içermeyen bir şablon yazın; örneğin {{ .CommonLabels.alertname }} {{ .CommonLabels.instance }}. Contact point'i kaydedin.
5 Bir notification policy'yi (veya uyarı kuralının contact point'ini) buna yönlendirin ve olayı Oncallz'da kontrol etmek için contact point'in Test düğmesini kullanın.

Oncallz'un okuduğu Grafana alanları

{
  "status": "firing",
  "state": "alerting",
  "title": "HighMemoryUsage db-1",
  "message": "**Firing** ...",
  "groupKey": "{}:{alertname=\"HighMemoryUsage\"}",
  "alerts": [ ... ]
}

title olay başlığı olur; status veya state tetikleme mi çözme mi olduğuna karar verir. Oncallz'da Grafana'ya özel bir ayrıştırıcı yoktur; tüm etiket ve açıklamalar dahil geri kalan her şey ham payload olarak olayda saklanır.

Contact point başlığını neden değiştirmeli?

Grafana'nın varsayılan başlığı "[FIRING:2] HighMemoryUsage" gibidir ve uyarı düzelince "[RESOLVED] HighMemoryUsage" olur.

Oncallz Grafana uyarılarını başlığa göre grupladığı için duruma veya uyarı sayısına göre değişen bir başlık her seferinde yeni bir olay açar ve resolved bildirimi kapatacağı olayı bulamaz. Yalnızca etiketlerden oluşan bir başlık, firing'den resolved'a kadar aynı kalır.

Kendiliğinden çözülür mü?

Evet, başlık sabitlendiğinde. Grafana, uyarı grubu düzeldiğinde "status": "resolved" (ve "state": "ok") gönderir; Oncallz da aynı başlıklı açık olayı çözer. "Disable resolved message" seçeneğini kapalı bırakın.

Grafana'nın varsayılan başlığını korursanız resolved bildirimleri reddedilir ve olayların elle çözülmesi gerekir.

Önem derecesi nasıl belirlenir?

Varsayılan Grafana payload'unda üst düzey bir severity alanı yoktur; bu yüzden her Grafana olayı critical olarak çağrılır.

Önem derecesini kontrol etmek için farklı önem derecelerini ayrı Oncallz entegrasyonlarına yönlendirin ya da mümkünse webhook contact point'inin Custom Payload seçeneğiyle bir etiketten severity alanı ekleyin.

Grafana belgelerine göre Custom Payload, Grafana Cloud'da henüz genel kullanıma açık değildir (Eylül 2026).

Yinelenen uyarılar nasıl gruplanır?

Başlığa göre. O başlıkla açık bir olay varken tekrar bildirimleri zaman çizelgesine eklenir ve tekrar sayısını artırır, yeniden çağrı yapılmaz.

Uyarıları birbirinden ayıran instance veya cluster gibi etiketleri başlık şablonuna koyun; aksi hâlde iki farklı sunucu tek olayı paylaşır ve ilk düzelen olayı kapatır.

Nöbetçi mühendise ne ulaşır?

critical (veya seçtiğiniz önem derecesi) için ayarlı kanallardan bir çağrı, şablonunuzdan gelen olay başlığı ve etiketler, açıklamalar, değerler ile dashboard ve silence sayfası bağlantılarını içeren Grafana payload'unun tamamı.

Grafana'nın message metni açıklamaya kopyalanmaz; önemli bilgileri başlığa koyun ya da payload'dan okuyun.

Sıkça sorulan sorular

Oncallz'un bir Grafana eklentisi var mı?

Eklenti gerekmez. Grafana Alerting'in yerleşik webhook contact point'i Oncallz gelen URL'sine gönderim yapar; Oncallz da Grafana'nın standart payload'undan title ve status alanlarını okur. Olayların resolved bildirimiyle kapanması için contact point'te sabit bir başlık şablonu ayarlayın.

Oncallz entegrasyonunda "Başlığa göre grupla" kullanın.

Grafana uyarılarım Oncallz'da neden çözülmüyor?

Neredeyse her zaman contact point hâlâ Grafana'nın varsayılan başlığını kullandığı için; bu başlık "[FIRING:1] ..." iken "[RESOLVED] ..." olur. Oncallz Grafana uyarılarını başlığa göre eşlediğinden resolved mesajı açık olayı bulamaz.

Title alanını uyarı adı ve instance gibi yalnızca etiketlerden oluşan bir şablona ayarlayın.

Neden her Grafana olayı critical?

Grafana'nın varsayılan webhook gövdesinde üst düzey bir severity yoktur ve Oncallz, hiçbir şey eksik çağrılmasın diye eksik önem derecesini critical sayar.

Warning'leri, takımı veya nöbet çizelgesi daha yumuşak çağrılan ayrı bir entegrasyona gönderin ya da Grafana sürümünüz sunuyorsa contact point'in Custom Payload seçeneğiyle bir severity alanı ekleyin.

Grafana ve Prometheus Alertmanager'ı birlikte kullanabilir miyim?

Evet. Bunlar ayrı URL'lere sahip ayrı entegrasyonlardır ve her biri aynı takımı ya da farklı takımları çağırabilir. Grafana yalnızca Prometheus verisini görselleştiriyor ve uyarıları zaten Alertmanager gönderiyorsa, aynı sorun iki kez çağrılmasın diye ikisinden yalnızca birini bağlayın.

İlgili sayfalar

Çağrı geldiğinde hazır olun.

Çalışma alanınızı dakikalar içinde oluşturun. Kredi kartı olmadan ücretsiz başlayın — hazır olduğunuzda kullanıcı başına ayda 4 dolar.

Ücretsiz başla