Sentry veya GlitchTip'i bağlayın

Sentry ve GlitchTip ikisi de aynı Sentry SDK protokolünü konuşur. Elido tarafı ikisi için de aynı yapılandırmadır — tek fark yapıştırdığınız DSN'dir.

Bu kılavuz iki yönü kapsar: Elido uyarılarını hata izleyicinize aktarmak (böylece kötüye kullanım / TLS / API sorunları triyaj edebileceğiniz issue'lar olarak görünür) ve zaten kendi sunucunuzda GlitchTip barındırıyorsanız Elido'yu mevcut Sentry kurulumunuzla birlikte kullanmak.

Neden bağlamalısınız

Elido, Sentry issue'ları olarak kullanışlı operasyonel olaylar yayınlar:

• abuse.flagged — tarayıcımız bir hedef URL'yi kötü amaçlı yazılım / kimlik avı olarak işaretledi.
• domain.tls_renewed (başarısızlık türevi) — Caddy bir TLS sertifikasını yenileyemedi.
• webhook.delivery_failed — kendi webhook uç noktanız yanıt vermeyi durdurdu.
• link.clicked.aggregated (anomali türevi) — tek bir bağlantıda ani 10 kat trafik artışı.

Muhtemelen bunların hepsini issue olarak istemezsiniz — insan müdahalesi gerektirenleri seçin.

Entegrasyonu ekleyin

1. Panel → Integrations → Sentry / GlitchTip.
2. Sentry DSN'nizi yapıştırın. GlitchTip DSN'leri aynı biçimi kullanır ve aynı alanda çalışır.
3. İletilecek olay türlerini seçin. Varsayılan yalnızca abuse.flagged ve TLS yenileme başarısızlıklarıdır.
4. Send test event'e tıklayın. Sentry projenizde 10 saniye içinde bir "test issue" görmelisiniz.
5. Kaydet.

Entegrasyon sunucu tarafında çalışır. Panelinizde Sentry tarayıcı SDK'sını yüklemiyoruz — DSN'niz ziyaretçinin tarayıcısına asla ulaşmaz.

Issue nasıl görünür

İletilen her olay, şunlara sahip Sentry biçimli bir issue olur:

• event_id = Elido olay ID'si (böylece tekilleştirebilirsiniz).
• level = kötüye kullanım + TLS başarısızlıkları için error, webhook teslimat başarısızlıkları için warning, artış anomalileri için info.
• fingerprint = çalışma alanı ID'si + olay türü + ilgili kaynak ID'si, böylece aynı issue'nun yeniden tetiklenmeleri Sentry'de temiz bir şekilde gruplanır.
• extra = tam Elido olay yükü.
• tags = workspace, event_kind ve kaynağa özgü etiket (link_slug, domain, vb.).

GlitchTip notları

GlitchTip, Sentry olay alım API'sini uygular ama tam Sentry özellik setini uygulamaz. Entegrasyon olayları yalnızca alım uç noktası üzerinden gönderir, bu yüzden o kapsamdaki her özellik (issue gruplama, parmak izi, arama, uyarı) GlitchTip'te de çalışır. Performans izleri, tekrar oynatmalar ve profilleme çalışmaz, ama Elido zaten bunları göndermez.

Devre dışı bırakma

Entegrasyon sayfasında Disconnect'e tıklayın. DSN silinir ve başka olay gönderilmez. Mevcut Sentry issue'larınız silinmez — Sentry projenizde kalır.

Sınırlar

• Çalışma alanı başına 1 Sentry hedefi. Birden fazla Sentry projesine dağıtmanız gerekirse webhooks ve küçük bir proxy kullanın.
• Sentry'nin proje başına varsayılan 50/s hız sınırına saygı gösteriyoruz. Artış anomalileri, sınırın altında kalmak için gönderilmeden önce örneklenir.

Sorun giderme

Test olayı geliyor ama gerçek olaylar gelmiyor. Entegrasyon ayarlarında doğru olay türlerini seçtiğinizi kontrol edin. Varsayılan seçim muhafazakârdır.

Olaylar geliyor ama tags boş. Sentry bazen 200 karakterden uzun etiket değerlerini (slug'lar, alan adları) kırpar — bunlar unknown olarak sona erer. Bu bir Sentry sınırlamasıdır, bizim değil.

GlitchTip alım uç noktası 429 ile reddediyor. GlitchTip örneğiniz hız sınırlaması uyguluyor. GlitchTip'in yönetici panelinde proje başına limiti yükseltin ya da olay türlerini ihtiyacınız olanlarla sınırlayın.

DSN döndürüldü ve şimdi 401 alıyoruz. Entegrasyon sayfasında DSN'yi güncelleyin. DSN döndürme için otomatik algılama yoktur.