Sentry entegrasyonu

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

Sentry uyarı bildirimlerini Oncallz'a gönderin; yeni veya geri dönen hatalar o an nöbetçi olan kişiyi çağırsın. Oncallz, Sentry'nin eski (legacy) webhook payload'unu doğrudan okur; Sentry'nin yeni internal integration'larından gelen payload'lar ise genel bir başlıkla ulaşır ve biraz ek özen ister.

Ücretsiz başla Tüm entegrasyonlar

Sentry → Oncallz kurulumu birkaç dakikada

1 Oncallz'da Entegrasyonlar sayfasını açın, takımı seçin, entegrasyona "Sentry" adını verin ve Oluştur'a tıklayın. Legacy webhook için "Kimliğe göre grupla", internal integration için "Her zaman yeni oluştur" kullanın (aşağıya bakın).
2 Yeni entegrasyonun Gelen URL'sini kopyalayın.
3 Projeniz legacy WebHooks entegrasyonunu hâlâ sunuyorsa (Project Settings → Legacy Integrations → WebHooks) etkinleştirin ve Oncallz URL'sini Callback URLs alanına yapıştırın.
4 Aksi hâlde organizasyon ayarlarınızda bir internal integration oluşturun, Oncallz URL'sini webhook URL'si olarak yapıştırın ve alert rule action olarak etkinleştirin.
5 Çağrı yapması gereken Sentry alert rule'larına webhook veya internal integration üzerinden bildirim gönderen eylemi ekleyin, ardından bir test tetikleyin.

Oncallz'un kullandığı legacy webhook alanları

{
  "id": "4521778301",
  "project": "checkout-api",
  "level": "error",
  "culprit": "app/payments/charge.py in capture",
  "message": "TimeoutError: upstream did not respond",
  "url": "https://sentry.io/organizations/acme/issues/4521778301/",
  "triggering_rules": ["Page on new errors"],
  "event": { ... }
}

id (Sentry issue'su) tekrarları tek olayda toplar, message başlık olur ve level önem derecesini belirler. Sentry, legacy webhook'u kullanımdan kalkmış (deprecated) olarak tanımlar ve yeni kurulumları internal integration'lara yönlendirir (Eylül 2026).

Önem derecesi nasıl belirlenir?

Legacy payload'daki level alanından. error ve warning doğrudan eşleşir, info info kalır, debug info olur, fatal ise error olur.

Internal integration payload'ları level'ı Oncallz'un okumadığı data.event içine yerleştirir; bu yüzden önem derecesini başka bir yolla ayarlamadığınız sürece bu olaylar critical olarak çağrılır.

Yinelenen uyarılar nasıl gruplanır?

Legacy webhook ve "Kimliğe göre grupla" ile Sentry issue id'si dedup anahtarıdır: aynı issue için gelen her uyarı açık tek bir olayın zaman çizelgesine düşer ve tekrar sayısını artırır, yeniden çağrı yapılmaz.

Internal integration payload'larında üst düzey bir id veya başlık yoktur; gruplama her Sentry uyarısını "Incident" başlıklı tek bir olayda birleştirir. Bunlar için "Her zaman yeni oluştur" kullanın.

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

Hayır. Legacy webhook yalnızca bir alert rule tetiklendiğinde gönderilir. Internal integration'lar issue "resolved" webhook'ları gönderebilir, ancak Sentry bunu Oncallz'un yorumlamadığı bir action alanına koyar; bu yüzden bir issue'yu Sentry'de çözmek Oncallz olayını çözmez.

Düzeltme yayına alınınca olayı Oncallz'da çözün.

Internal integration uyarılarını okunur hâle getirmek

Sentry'nin internal integration payload'u başlığı, level'ı ve issue id'sini data.event altında tutar; bu yüzden Oncallz olaya "Incident" başlığını verir ve critical olarak çağırır. Payload'un tamamı yine olay sayfasındadır ve AI incelemesi açıksa onu okur.

Bu olaylara URL'ye ekleyerek sabit bir başlık ve önem derecesi verebilirsiniz; örneğin ?summary=Sentry%20alert&severity=error.

Sentry ayrıca entegrasyon webhook'ları için bir saniyelik yanıt sınırı belgeler; Oncallz olayı açtıktan sonra yanıt verir ve AI incelemesi açıkken bu daha uzun sürebilir, bu yüzden Sentry zaman aşımı bildirebilir.

Sıkça sorulan sorular

Oncallz ile en iyi hangi Sentry webhook'u çalışır?

Projenizde hâlâ varsa legacy WebHooks entegrasyonu. Payload'unda issue id'si, event mesajı ve level üst düzeyde bulunur; böylece Oncallz gerçek bir başlık, doğru önem derecesi ve Sentry issue'su başına tek olay elde eder.

Sentry legacy webhook'u kullanımdan kalkmış sayar; yeni kurulumlar internal integration kullanır ve Oncallz bunları genel bir başlıkla alır.

Sentry'de bir issue'yu çözmek olayı da çözer mi?

Hayır. Sentry issue çözümünü bir action alanında bildirir; Oncallz ise çözmeyi yalnızca status, state, trigger veya event_action alanlarından çıkarır. Olayı Oncallz'da web uygulamasından ya da iOS uygulamasından çözün.

Olay, issue bağlantısı dahil Sentry payload'unu saklar; nöbetçi kapatmadan önce issue'yu kontrol edebilir.

Her Sentry hatası birini çağırmalı mı?

Genellikle hayır. Neyin gönderileceğine Sentry alert rule'ları karar verir; çağrı kurallarını production'daki yeni issue'lar, geri dönen hatalar veya sık tekrarlanan hatalarla sınırlayın.

Oncallz tarafında arama bastırma kuralları bilinen gürültülü başlıklar için telefon aramasını atlayabilir, bakım pencereleri de deploy sırasında çağrıları bekletebilir.

Sentry olayımın başlığı neden "Incident"?

Büyük olasılıkla bir internal integration kullanıyorsunuz. Onun payload'u başlığı, Oncallz'un genel algılamasının bakmadığı data.event içinde tutar. Sabit bir başlık için webhook URL'sine sorgu parametresi olarak summary ve severity ekleyin ya da projeniz sunuyorsa legacy webhook'u kullanın.

Payload'un tamamı her zaman olaydadı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