Graylog entegrasyonu

Graylog uyarılarıyla nöbetçi mühendisinizi çağırın

Bir Graylog HTTP Notification'ı Oncallz'a yönlendirin; her olay, o an nöbetçi olan kişiyi çağıran bir olaya dönüşsün. Oncallz, backlog mesajlarındaki log seviyesi dahil Graylog'un kendi payload yapısını okur; böylece bir hata satırı uyarı seviyesine düşürülmez.

Ücretsiz başla Tüm entegrasyonlar

Graylog → Oncallz kurulumu birkaç dakikada

1 Oncallz'da Entegrasyonlar sayfasını açın, çağrılacak takımı seçin, "Graylog prod" gibi bir ad girin, Yinelenen olaylar ayarını "Başlığa göre grupla" yapın ve Oluştur'a tıklayın.
2 Yeni entegrasyonda görünen Gelen URL'yi kopyalayın. Adres https://oncallz.com/api/ingest/ ve ardından yönlendirme anahtarından oluşur.
3 Graylog'da Alerts → Notifications bölümüne gidin, Create notification'a tıklayın ve HTTP Notification türünü seçin. Oncallz URL'sini yapıştırın. Graylog'unuzda URL allowlist etkinse URL'yi önce oraya ekleyin; aksi hâlde istek engellenir.
4 Çağrı yapmasını istediğiniz event definition'ı açın (Alerts → Event Definitions), yeni bildirimi Notifications adımında ekleyin ve Oncallz'un log seviyelerini okuyabilmesi için mesaj backlog'u dahil edin.
5 Olayı tetikleyin ya da bildirimdeki test düğmesini kullanın ve olayın Oncallz'da beklenen önem derecesiyle göründüğünü kontrol edin.

Oncallz'un kullandığı Graylog alanları

{
  "event_definition_title": "Payments - DB connection lost",
  "event": {
    "id": "01J9Z6Q2XK8M4",
    "message": "Payments - DB connection lost",
    "source": "graylog-node-1",
    "priority": 2,
    "fields": { "details": "MySQL server has gone away (err 2006)" }
  },
  "backlog": [
    { "fields": { "stringLevel": "Error", "level": 3 } }
  ]
}

Başlık: event.message. Açıklama: event.fields.details. Kaynak: event.source. Önem derecesi: event priority yalnızca 2 olsa da backlog'daki en kötü seviye (burada Error).

Graylog olaylarında önem derecesi nasıl belirlenir?

Oncallz, olayın backlog mesajlarında bulunan en yüksek log seviyesini alır. Serbest metni değil, yapılandırılmış stringLevel ve sayısal syslog level alanlarını okur; yani log satırındaki bir kelime önem derecesini değiştiremez. Backlog yoksa sayısal event priority değerine döner.

Backlog seviyeleri: emergency, alert, critical veya fatal (syslog 0–2) critical olur; error (3) error olur; warning (4) warning olur; notice, info ve debug (5+) info olur.
Backlog yoksa: event priority 1 info, 2 warning, 3 ve üzeri critical olur.
Ardından önem derecesine göre kanal ayarlarınız, olayın telefonla mı arayacağına, SMS mi göndereceğine yoksa yalnızca push ve e-posta mı ileteceğine karar verir.

Tekrarlayan Graylog uyarıları nasıl gruplanır?

Graylog her olaya yeni bir event.id verir; bu yüzden kimliğe göre gruplama tekrarları birleştirmez. Bunun yerine "Başlığa göre grupla" kullanın: aynı başlıklı bir olay açıkken gelen yeni olaylar zaman çizelgesine eklenir, tekrar sayısı artar ve kimse yeniden çağrılmaz.

Toplama (aggregation) uyarıları başlıkta çoğu zaman değişen bir sayı taşır; örneğin "Token failures: count()=91.0". Ayarlar'dan "Token failures: count()=*" gibi bir başlık gruplama şablonu ekleyin, bu başlıklar tek bir olayda birleşsin.

Graylog olayı kendiliğinden çözülür mü?

Hayır. Graylog HTTP Notification'ları bir olay tetiklendiğinde gönderilir; Graylog düzelme mesajı göndermez. Nöbetçi mühendis olayı Oncallz web uygulamasından veya iOS uygulamasından çözer. Olay çözüldükten sonra gelen ilk eşleşen olay yeni bir olay açar.

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

O önem derecesi için ayarlı kanallardan bir çağrı: push bildirimi, SMS, telefon araması veya e-posta. Olayda başlık, event definition'ınız "details" adlı bir alan tanımlıyorsa event.fields.details içindeki log satırı, kaynak node ve Graylog payload'unun tamamı yer alır.

Kendi AI sağlayıcı anahtarınızı bağladıysanız çağrı gitmeden önce olası nedeni içeren bir AI özeti eklenir.

Gürültülü akışları sakinleştirmek

Bakım pencereleri, planlı çalışmalar sırasında eşleşen olayları düşürebilir, sessize alabilir veya önem derecesini bir kademe indirebilir.

Arama bastırma kuralları başlık veya açıklamaya bir düzenli ifadeyle bakar ve yalnızca telefon aramasını atlar; bilinen gürültülü uyarılar push, SMS ve e-postayla yine ulaşır.

Sıkça sorulan sorular

Oncallz için bir Graylog eklentisine ihtiyacım var mı?

Hayır. Graylog'un yerleşik HTTP Notification özelliği yeterlidir. Alerts → Notifications altında oluşturun, Oncallz gelen URL'nizi yapıştırın ve bir event definition'a bağlayın. Oncallz Graylog payload'unu kendisi tanır; özel bir gövde şablonu yazmanız gerekmez.

Graylog'unuz URL allowlist kullanıyorsa önce Oncallz URL'sini listeye ekleyin.

Event definition önceliğim Normal iken Oncallz neden Error gösteriyor?

Çünkü Oncallz, event definition önceliği yerine backlog mesajlarının gerçek log seviyesini esas alır. Normal öncelikli bir tanım altında loglanan hata yine de bir hatadır ve öyle çağrılır.

Olay backlog taşımıyorsa Oncallz sayısal event priority değerini kullanır: 1 info, 2 warning, 3 ve üzeri critical demektir.

Graylog koşulu ortadan kalkınca Oncallz olayı çözer mi?

Hayır. Graylog bir olay tetiklendiğinde bildirim gönderir, ama koşul eşleşmeyi bıraktığında hiçbir şey göndermez; dolayısıyla üzerine işlem yapılacak bir düzelme sinyali yoktur. Olayı takımdan biri Oncallz'da çözer.

Olay açık kaldığı sürece, entegrasyon başlığa göre grupladığı takdirde aynı başlıklı yeni olaylar yeniden çağrı yapmak yerine ona eklenir.

Gürültülü tek bir uyarının bütün gece telefonları çaldırmasını nasıl önlerim?

Üç seçeneğiniz var. Değişen sayılar için bir başlık şablonuyla birlikte başlığa göre gruplayın; tekrarlar açık olan tek olayda birleşsin. Uyarı metniyle eşleşen bir arama bastırma kuralı ekleyin; yalnızca telefon araması atlanır.

Ya da planlı çalışma sırasında eşleşen olayları düşüren, sessize alan veya önem derecesini indiren bir bakım penceresi planlayın.

Tek bir Graylog bildirimini birden fazla Oncallz takımına gönderebilir miyim?

Her Oncallz entegrasyonu tek bir takıma aittir ve kendi URL'si vardır. Her takım için bir entegrasyon ve Graylog'da her biri için eşleşen bir HTTP Notification oluşturun, ardından doğru bildirimi ilgili event definition'a bağlayın.

Böylece veritabanı uyarıları veritabanı nöbetini, uygulama uyarıları uygulama nöbetini çağırır.

İ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