Sentry Entegrasyonu
Sentry entegrasyonu, üretim hata takibini proje yönetimiyle birleştirir. Sentry bir hata tespit ettiğinde bunu mevcut bir SetGet iş öğesine bağlayabilir veya yeni bir tane oluşturabilirsiniz. Herhangi bir tarafta sorunu çözmek diğer tarafta da çözülmesini sağlar; böylece hata takiciniz ve görev panonuz senkronize kalır.
Yetenekler
| Özellik | Açıklama |
|---|---|
| Sentry sorunlarını iş öğelerine bağlama | Üretim hatalarını düzeltmekten sorumlu iş öğeleriyle ilişkilendirin |
| Sentry'den iş öğesi oluşturma | Sentry sorun sayfasından doğrudan yeni bir SetGet iş öğesi oluşturun |
| Çift yönlü durum senkronizasyonu | Sentry'de çözmek iş öğesini Tamamlandı olarak işaretler; iş öğesini tamamlamak Sentry sorununu çözer |
| SetGet'te hata bağlamı | Bağlantılı iş öğesinde Sentry hata ayrıntılarını (başlık, sıklık, son görülme) görüntüleyin |
Önkoşullar
- Organizasyona Yönetici veya Yönetici erişimine sahip bir Sentry hesabı.
- SetGet çalışma alanınızda Yönetici veya Sahip rolü.
- Aktif hata izlemesi olan en az bir Sentry projesi.
Kurulum adımları
Adım 1 -- Sentry'ye bağlanın
- SetGet'te Ayarlar > Entegrasyonlar bölümüne gidin.
- Sentry kartını bulun ve Bağlan'a tıklayın.
- SetGet sizi Sentry'nin yetkilendirme sayfasına yönlendirir.
- Bağlamak istediğiniz Sentry organizasyonunu seçin.
- Kabul Et'e tıklayın.
- SetGet'e geri yönlendirilirsiniz. Sentry kartı, organizasyon adınızla birlikte "Bağlandı" gösterir.
Adım 2 -- Sentry projelerini SetGet projeleriyle eşleyin
Eşleme isteğe bağlıdır ancak iş akışını iyileştirir. Bir Sentry projesi bir SetGet projesiyle eşlendiğinde, Sentry'den oluşturulan yeni iş öğeleri otomatik olarak doğru projeye gider.
- SetGet'te Ayarlar > Entegrasyonlar > Sentry bölümüne gidin.
- Projeleri Eşle'ye tıklayın.
- Her Sentry projesi için açılır listeden karşılık gelen SetGet projesini seçin.
- Kaydet'e tıklayın.
| Sentry projesi | SetGet projesi |
|---|---|
frontend-web | Web |
api-service | API |
mobile-ios | Mobil |
Adım 3 -- Durum senkronizasyonunu yapılandırın
Durum senkronizasyonu, Sentry sorun durumlarını SetGet iş öğesi durumlarıyla eşleştirir.
| Sentry durumu | Varsayılan SetGet durumu | Değiştirilebilir |
|---|---|---|
unresolved | Devam Ediyor | Evet |
resolved | Tamamlandı | Evet |
ignored | İptal Edildi | Evet |
Durum Eşlemesi altındaki entegrasyon ayarlarında özelleştirin.
Entegrasyonu kullanma
Bir Sentry sorununu mevcut bir iş öğesine bağlama
- Sentry'de bağlamak istediğiniz sorunu açın.
- Kenar çubuğunda SetGet bölümünü bulun.
- Mevcut iş öğesine bağla'ya tıklayın.
- İş öğesini başlık veya tanımlayıcıya göre arayın.
- Bağla'ya tıklayın.
Sentry sorun sayfası artık bağlantılı iş öğesini gösterir; SetGet iş öğesi ise Bağlantılar bölümünde bağlantılı Sentry sorununu gösterir.
Sentry'den yeni bir iş öğesi oluşturma
- Sentry'de sorunu açın.
- SetGet bölümünde İş öğesi oluştur'a tıklayın.
- Başlık, Sentry sorun başlığından otomatik olarak doldurulur. Gerekirse değiştirin.
- Hedef projeyi, durumu, önceliği ve atanan kişiyi seçin.
- Oluştur'a tıklayın.
Yeni iş öğesi, Sentry sorununa geri bağlantı ve hata bağlamı (hata türü, sıklık, son gerçekleşme) içerir.
SetGet'te Sentry bağlamını görüntüleme
Bağlantılı bir iş öğesinde Bağlantılar bölümü şunları gösterir:
- Sentry sorun başlığı
- Hata sayısı (toplam gerçekleşme)
- Son görülme zaman damgası
- Sentry sorun sayfasına doğrudan bağlantı
- Mevcut Sentry durumu (çözülmemiş/çözülmüş/yoksayıldı)
Çift yönlü durum senkronizasyonu
Durum senkronizasyonu etkinleştirildiğinde:
- Sentry çözüldü — bağlantılı SetGet iş öğesi eşlenen duruma geçer (varsayılan: Tamamlandı).
- SetGet iş öğesi tamamlandı — bağlantılı Sentry sorunu çözülmüş olarak işaretlenir.
- Sentry gerilemesi — çözülmüş bir Sentry sorunu yeniden oluşursa (regresyon), SetGet iş öğesi eşlenen çözülmemiş duruma geri döner.
UYARI
Regresyon algılama yalnızca Sentry sorunun çözüldükten sonra yeni bir olay tetiklemesi durumunda çalışır. Yeniden oluşan tek seferlik hatalar, bağlantılı iş öğesini yeniden açar.
Kullanım senaryoları
| Senaryo | İş akışı |
|---|---|
| Hata önceliklendirme | Gelen Sentry sorunlarını iş öğelerine bağlayın, mühendislere atayın, çözümü takip edin |
| Sürüm doğrulama | Bir dağıtımdan sonra regresyonlar için bağlantılı Sentry sorunlarını kontrol edin |
| Müşteri desteği | Destek ekibi ilgili Sentry sorunlarını bulur, iş öğelerine bağlar, düzeltme ilerlemeyi izler |
| Sprint planlaması | Yüksek frekanslı Sentry sorunlarını mevcut döngüye iş öğeleri olarak alın |
Entegrasyonu yönetme
Bağlantılı sorunları görüntüleyin
Tüm bağlantılı Sentry sorunlarının ve bunların mevcut senkronizasyon durumunun listesini görmek için Proje Ayarları > Entegrasyonlar > Sentry bölümüne gidin.
Sentry sorununu bağlantısını kaldırın
İş öğesinde, Bağlantılar bölümündeki Sentry bağlantısının yanındaki x simgesine tıklayın. Bu, bağlantıyı kaldırır ancak Sentry sorununu veya iş öğesini silmez.
Sentry bağlantısını kesin
Ayarlar > Entegrasyonlar > Sentry bölümüne gidin ve Bağlantıyı Kes'e tıklayın. Bu işlem OAuth token'ını iptal eder ve tüm proje eşlemelerini kaldırır. Mevcut bağlantılar statik referanslar olarak korunur ancak senkronizasyon durur.
Sorun giderme
| Sorun | Neden | Çözüm |
|---|---|---|
| SetGet, Sentry kenar çubuğunda görünmüyor | Entegrasyon kurulmamış | Ayarlar > Entegrasyonlar'da kurulumu tamamlayın |
| Durum senkronize edilmiyor | Durum eşlemesi yanlış yapılandırılmış | Durum eşlemesini gözden geçirip güncelleyin |
| Yanlış proje seçildi | Proje eşlemesi eksik | Sentry projelerini SetGet projeleriyle eşleyin |
| Regresyon iş öğesini yeniden açmıyor | Durum senkronizasyonu duraklatılmış | Entegrasyon ayarlarını kontrol edin |
Uyarı kuralları
Belirli koşullar karşılandığında otomatik olarak SetGet iş öğeleri oluşturmak için Sentry uyarı kurallarını yapılandırabilirsiniz:
| Uyarı koşulu | Eylem |
|---|---|
| Yeni sorun algılandı | Yüksek öncelikli bir iş öğesi oluştur |
| Sorun sıklığı eşiği aşıyor | Acil öncelikli bir iş öğesi oluştur |
| Sorun regresyon yapıyor | Bağlantılı iş öğesini yeniden aç |
Sentry'de Proje > Uyarılar > SetGet eylemi altında uyarıdan iş öğesine kurallarını yapılandırın.
İPUCU
Gelen hata raporlarını nöbetçi mühendise otomatik atamak için Sentry uyarı kurallarını SetGet otomasyonlarıyla birleştirin.
Birden fazla Sentry projesi
Aynı çalışma alanı içinde birden fazla Sentry projesini farklı SetGet projelerine eşleyebilirsiniz. Bu, ön yüz, arka uç ve mobil için ayrı Sentry projeleri sürdürürken tüm çalışmayı tek bir SetGet çalışma alanında takip eden ekipler için yaygındır.
| Mimari | Sentry kurulumu | SetGet eşlemesi |
|---|---|---|
| Monolit | 1 Sentry projesi | 1 SetGet projesi |
| Mikroservisler | N Sentry projesi | N SetGet projesi (servis başına bir tane) |
| Çok platform | 3 Sentry projesi (web, iOS, Android) | 1-3 SetGet projesi (tercihinize göre) |
Güvenlik
- OAuth token'ları sunucu tarafında şifreli olarak saklanır.
- Sentry webhook yükleri işlenmeden önce doğrulanır.
- Entegrasyon, meta veriler (başlık, sayı, zaman damgaları) dışındaki Sentry olay yüklerine (yığın izleri, kullanıcı verileri) erişmez.
- Gereken minimum Sentry kapsamı
project:readveevent:read'dir. - Ayarlar > Geliştirici Ayarları > Entegrasyonlar bölümünden Sentry'de erişimi iptal edebilirsiniz.
Sık sorulan sorular
Bir Sentry sorununu birden fazla iş öğesine bağlayabilir miyim?
Hayır. Her Sentry sorunu aynı anda yalnızca bir iş öğesine bağlanabilir. Bir Sentry sorununu birden fazla iş öğesinde takip etmek için bir üst iş öğesi oluşturun ve Sentry sorununu ona bağlayın.
Entegrasyon Sentry olay verilerini (yığın izleri) içe aktarıyor mu?
Hayır. Yalnızca meta veriler (başlık, olay sayısı, son görülme zaman damgası, durum) senkronize edilir. Yığın izleri ve kullanıcı verileri Sentry'de kalır.
Aynı sorunu hem Sentry'de hem de SetGet'te eş zamanlı çözersem ne olur?
Her iki eylem de işlenir. Nihai durum, son senkronizasyon olayını yansıtır. Pratikte bu, her ikisinin de çözülmüş olmasıyla sonuçlanır; bu beklenen sonuçtur.