Uyari En Iyi Uygulamalari
Iyi tasarlanmis bir bildirim stratejisi, takiminizi bunaltmadan bilgilendirir. Cok az uyari ve kritik guncellemeler kacirilir. Cok fazla uyari ve insanlar bildirimleri tamamen gormezden gelmeye baslar. Bu rehber, takiminizin guvenecegi ve dayanacagi bir bildirim sistemi olusturmak icin pratik onerileri kapsar.
Tetikleyici stratejinizi tasarlama
Olaylari aciliyetlerine gore siniflandirin
Her olay ayni bildirim islemini hak etmez. Kullanilabilir 16 olay turunu uc katmana ayirarak baslayin:
| Katman | Aciliyet | Onerilen kanallar | Ornek olaylar |
|---|---|---|---|
| Kritik | Aninda eylem gerektirir | Uygulama ici + E-posta + SMS | due_date_passed, priority_changed (Acil'e) |
| Onemli | Saatler icinde gorulmeli | Uygulama ici + E-posta | state_changed, assignee_changed, mentioned, comment_added |
| Bilgilendirici | Bilmesi iyi, aciliyeti yok | Yalnizca uygulama ici | label_changed, property_changed, link_changed, archive_changed |
Bu katmanli yaklasim, en acil olaylarin en fazla dikkat cekmesini saglarken daha dusuk oncelikteki guncellemeler gurultu olusturmadan erisilebilir kalir.
Daha az tetikleyiciyle baslayin
Uyarilari ilk kez kurarken, her olay turu icin tetikleyici olusturma cazibesine karsi koyun. Kucuk bir yuksek degerli tetikleyici setiyle baslayin ve takim geri bildirimlerine gore genisletin.
Onerilen baslangic tetikleyicileri:
due_date_passed--- Atanan kisileri geciken is ogeleri hakkinda bilgilendir.state_changedkosul "Durum Incelemede" --- Is hazir oldugunda incelemecileri bilgilendir.mentioned--- Yorumlarda bahsedilen kullanicilari bilgilendir.assignee_changed--- Yeni atanan kisiyi atamasi hakkinda bilgilendir.
Bu dort tetikleyici en yaygin sorunlu noktalari kapsar: kacirilan son tarihler, inceleme darbogazlari, gormezden gelinen bahsetmeler ve onaylanmamis atamalar. Takim belirli eksiklikleri tanimladiginda daha fazla tetikleyici ekleyin.
Kapsami daraltmak icin kosullari kullanin
Kosulsuz bir tetikleyici, calisma alanindaki eslesen her olayda tetiklenir. Neredeyse hic istenen durum bu degildir. Onemli olan bildirimleri hedeflemek icin kosullari kullanin:
| Bunun yerine... | Bunu kullanin... |
|---|---|
Kosulsuz state_changed (her durum degisikliginde tetiklenir) | Kosullu state_changed "Durum Incelemede" (yalnizca incelemeye girdiginde tetiklenir) |
Kosulsuz priority_changed (her oncelik degisikliginde tetiklenir) | Kosullu priority_changed "Oncelik Acil" (yalnizca kritik eskalasyonlarda tetiklenir) |
Kosulsuz issue_created (her yeni is ogesinde tetiklenir) | Kosullu issue_created "Etiket Hata iceriyor" (yalnizca yeni hatalar icin tetiklenir) |
Genel olaylar yerine spesifik olaylari tercih edin
property_changed olayi, bir is ogesindeki neredeyse her degisiklikte tetiklenir. Genel yakalayici olarak yararlidir ancak hedefli olaylardan onemli olcude daha fazla bildirim uretir. Ilgilendiginiz ozellik icin belirli bir olay turu varsa, onu kullanin:
| Genel yaklasim | Daha iyi yaklasim |
|---|---|
Kosullu property_changed "Oncelik degisti" | priority_changed |
Kosullu property_changed "Atanan degisti" | assignee_changed |
Kosullu property_changed "Durum degisti" | state_changed |
property_changed'i, 15 spesifik olay turu tarafindan karsilanmayan uc durumlar icin saklayin.
Bildirim yorgunlugunu onleme
Bildirim yorgunlugu, herhangi bir uyari sisteminin birincil riskidir. Kullanicilar cok fazla bildirim aldiginda, "bildirim korlugu" gelistirir ve kritik olanlar dahil uyarilara dikkat etmeyi birakirlar.
Bildirim yorgunlugu belirtileri
- Takim uyeleri cogu olay icin e-posta veya SMS'i devre disi birakir.
- Bildirim paneli (zil simgesi) surekli yuksek okunmamis sayilari gosterir.
- Kullanicilar "cok fazla" oldugu icin bildirimleri gormezden geldiklerini bildirir.
- Onemli uyarilar dogru teslim edilmesine ragmen kacirilir.
Onleme stratejileri
1. Daha az tetikleyici, daha fazla tetikleyiciden iyidir. Her ek tetikleyici, calisma alani genelindeki bildirim hacmini arttirir. Her tetikleyicinin net bir gerekcelesi olmalidir.
2. Yayin degil, alici hedefleme kullanin. Tum calisma alani uyelerini bilgilendiren tetikleyicilerden kacinin. Bildirimleri harekete gecmesi gereken kisilere hedefleyin: atananlar, olusturucular veya belirli rol sahipleri.
| Yaklasim | Hacim etkisi |
|---|---|
| Alicilar: Tum calisma alani uyeleri | Yuksek (olay basina N bildirim, N = uye sayisi) |
| Alicilar: Atananlar + Olusturucu | Dusuk (olay basina 1-3 bildirim) |
| Alicilar: Belirli kullanicilar (rol tabanli) | Dusuk (olay basina 1-5 bildirim) |
3. Kullanicilarin tercihlerini kontrol etmesine izin verin. Takim uyelerine, yararli bulmadiklari olaylar icin kanallari devre disi birakabileceklerini hatirlatin. Tercihler sayfasi her kullaniciya bildirim deneyimleri uzerinde tam kontrol saglar.
4. Tetikleyici hacmini periyodik olarak denetleyin.Gecmis sayfasini aylik olarak inceleyin. Tek bir tetikleyici orantisiz bir bildirim payindan sorumluysa, kapsamini daraltmak icin kosullar eklemeyi veya devre disi birakmayi dusunun.
5. Silmek yerine devre disi birakin. Bir tetikleyici cok fazla gurultu uretiyorsa, gecici olarak devre disi birakin ve takimin bildirimleri kaciirip kacirmadigini gozlemleyin. Kimse farketmezse, tetikleyici deger saglamiyordu demektir.
SMS kullanim onerileri
SMS, en kesintiye ugratici bildirim kanalidir. Kisa mesajla titreyen bir telefon, e-posta ve uygulama ici bildirimlerin yapamadigi bir sekilde aninda dikkat talep eder. Dikkatli kullanin.
SMS ne zaman kullanilir
| Senaryo | SMS icin uygun mu |
|---|---|
| Is ogesi gecikti ve size atanmis | Evet |
| Is ogenizdee engelleyici olusturuldu | Evet |
| Kritik yoldaki bir ogede oncelik Acil'e yukseldi | Evet |
| Takip ettiginiz bir is ogesine yorum eklendi | Hayir |
| Bir is ogesinde etiket degistirildi | Hayir |
| Projenizde yeni bir is ogesi olusturuldu | Hayir |
SMS yonergeleri
- Kullanici basina 1-3 olay turuyle sinirli tutun. Bir kullanicinin ucten fazla olay turu icin SMS'i etkinlestirmis olmasi, muhtemelen asiri bildirim aldigini gosterir.
- SMS'i kosullarla birlestirin. Her
priority_changedolayinda SMS gondermeyin --- yalnizca yeni oncelik Acil oldugunda. - Kisisel zamana saygi gosterin. SMS bildirimleri her saatte gelir. Takiminiz birden fazla saat dilimini kapsiyorsa, hangi olaylarin SMS tetikleyecegine dikkat edin.
- SMS maliyetlerini izleyin. Her SMS mesajinin bir maliyeti vardir (Twilio veya webhook saglayiciniz). Yuksek hacimli SMS pahaliya gelebilir. SMS hacmini Gecmis sayfasinda duzenli olarak inceleyin.
Onerilen SMS yapilandirmasi
| Olay turu | SMS onerisi | Kosul |
|---|---|---|
due_date_passed | Evet | Yalnizca atanan |
priority_changed | Evet | Yalnizca oncelik Acil oldugunda |
state_changed | Duruma bagli | Yalnizca engelleyici durumlari icin |
| Diger tum olaylar | Hayir | --- |
Durum esleme kaliplari
Durum eslemeleri, iyi tanimlanmis asamalara sahip is akislari icin gucludur. Pratikte iyi calisan kaliplari asagida bulabilirsiniz.
Dogrusal inceleme hatti
Dogrusal is akisina sahip takimlar icin (Gelistirme - Inceleme - KG - Tamamlandi):
| Kaynak durum | Hedef durum | Alicilar | Amac |
|---|---|---|---|
| Devam Ediyor | Incelemede | Kod incelemecileri | Incelemeci devralma |
| Incelemede | KG Testi | KG takimi | KG devralma |
| KG Testi | Dagitima Hazir | DevOps lideri | Dagitim kuyrugu farkindaliği |
| Herhangi | Tamamlandi | Olusturucu, Aboneler | Tamamlanma bildirimi |
Eskalasyon kalibi
Ogeler engellendiginde eskalasyona ihtiyac duyan takimlar icin:
| Kaynak durum | Hedef durum | Alicilar | Amac |
|---|---|---|---|
| Herhangi | Engellendi | Atanan, Proje yoneticisi | Aninda eskalasyon |
| Engellendi | Devam Ediyor | Atanan | Engelleyici cozumu onayi |
Surum yonetimi
Surum dongularini yoneten takimlar icin:
| Kaynak durum | Hedef durum | Alicilar | Amac |
|---|---|---|---|
| Herhangi | Surum Icin Hazir | Surum yoneticisi | Surum aday kuyrugu |
| Surum Icin Hazir | Suruldu | Olusturucu, Aboneler | Surum onayi |
Eslemeleri odakli tutun
- Eslemeleri yalnizca insan eylemi veya farkindaliği gerektiren gecisler icin olusturun.
- Her durum gecisinin eslemeye ihtiyaci yoktur. Rutin gecisler (ornegin "Bekleme Listesi" iken "Yapilacak") nadiren bildirim gerektirir.
- Mumkun olan her gecis icin esleme olusturdugunuzu farkediyorsaniz, muhtemelen asiri yapilandiriyorsunuz. Bildirimin deger kattigi gecislere odaklanin.
Sablon kullanim ipuclari
SetGet 21 sistem sablonu sunar. Bunlari etkili kullanma ipuclari:
Sablonlari baglamla eslestirin
Her tetikleyici icin her zaman en spesifik sablonu kullanin. Durum Degisikligi sablonu, genel Ozellik Degisikligi sablonunun sahip olmadigi onceki ve yeni durum baglamini icerir. Benzer sekilde, Oncelik Uyarisi sablonu oncelik duzeyi degisikligini belirgin sekilde vurgular.
Etkinlestirmeden once onizleyin
Bir tetikleyiciyi etkinlestirmeden once her zaman sablonlari onizleyin. Konu satiri, govde ve degisken degistirmenin acik ve eyleme donusturulebilir bir bildirim olusturdugunu dogrulayin.
Gercek alicilarla test edin
Canli olmadan once kendinize test bildirimi gonderin. Bu, yalnizca onizlemenin ortaya cikaramayacagi bicimlendirme sorunlarini, bozuk baglantilari ve teslimat problemlerini yakalar.
Eylemi net tutun
En iyi bildirimler tek bir acik eyleme sahiptir: "Bu is ogesini inceleyin," "Bu engelleyiciyi cozun," "Bu surumu dagitin." Bir bildirim acik bir eylem onermiyorsa, muhtemelen bilgilendiricidir ve yalnizca uygulama ici kullanilmalidir.
Teslimat sagligini izleme
Bildirim sistemi yalnizca bildirimler gercekten teslim edilirse yararlidir. Teslimat sagligini proaktif olarak izleyin.
Izlenecek temel metrikler
| Metrik | Saglikli aralik | Uyari isareti |
|---|---|---|
| Basari orani (panodan) | %95+ | %90'in altinda sistemik teslimat sorununu gosterir |
| Gunluk basarisiz gonderim | 0-5 | 10'dan fazla yapilandirma sorununu gosterir |
| 5 dakikadan eski bekleyen gonderimler | 0 | 5 dakikadan eski herhangi bir bekleyen gonderim kuyruk sorununu gosterir |
| SMS basarisizlik orani | %5'in altinda | Daha yuksek oranlar telefon numarasi veya saglayici sorunlarini gosterir |
Haftalik gozden gecirme kontrol listesi
Uyari sistemi sagliginizin kisa bir haftalik gozden gecirmesini yapin:
- [ ] Basari orani egilimleri icin istatistik panosunu kontrol edin.
- [ ] Gecen hafta icin Gecmis'i Durum: Basarisiz ile filtreleyin.
- [ ] Tekrarlayan basarisizlik kaliplarini arastirin (ayni alici, ayni kanal, ayni hata).
- [ ] SMS bakiyesinin (Twilio) gelecek hafta icin yeterli oldugunu dogrulayin.
- [ ] Takim uyelerine bildirimleri bekledikleri gibi alip almadiklarini sorun.
Teslimat sorunlarina yanit verme
Teslimat sorunlari tespit ettiginizde:
- Kanali izole edin. Basarisizliklar e-postada mi, SMS'te mi yoksa her ikisinde mi?
- Kimlik bilgilerini kontrol edin. SMTP ve SMS saglayici kimlik bilgileri suresi dolmus veya degistirilmis olabilir.
- Test gonderin. Kanalin calistigini dogrulamak icin sablon test ozelligini kullanin.
- Saglayiciyi kontrol edin. E-posta icin SMTP sunucu durumunu kontrol edin. SMS icin Twilio panosunu veya webhook uc noktasi sagligini kontrol edin.
- Son degisiklikleri inceleyin. Birisi SMTP ayarlarini, SMS saglayicisini veya ag yapilandirmasini degistirdi mi?
Olcekleme degerlendirmeleri
Calisma alaniniz uye ve is ogesi sayisinda buyudukce, bildirim hacmi orantili olarak olceklenir. Bu buyumeyi planlayin.
Hacim tahmini
| Calisma alani boyutu | Tahmini gunluk olay | Tahmini bildirimler (hedefleme ile) |
|---|---|---|
| 5-10 uye | 50-200 olay | 100-500 bildirim |
| 10-50 uye | 200-1.000 olay | 500-3.000 bildirim |
| 50-200 uye | 1.000-5.000 olay | 3.000-15.000 bildirim |
| 200+ uye | 5.000+ olay | 15.000+ bildirim |
Olcekleme ipuclari
- Takim buyudukce kosullari sikilastirin. 10 kisilik takim icin calisan genis tetikleyiciler, 50 kisi icin dayanilmaz hacim uretebilir.
- Rol tabanli alicilar kullanin. Cok sayida belirli kullanici eklemek yerine, dogru kisileri otomatik olarak hedefleyen alici turlerini (Atananlar, Olusturucu, Aboneler) kullanin.
- Tetikleyici sayisini inceleyin. Bir calisma alani nadiren 20-30'dan fazla aktif tetikleyiciye ihtiyac duyar. Daha fazlaniz varsa, konsolidasyon firsatlari arayin.
- Kuyruk islem suresini izleyin. Gecmis'teki "Beklemede" ve "Gonderildi" zaman damgalari arasindaki fark buyurse, bildirim kuyrugu dikkat gerektirebilir.
Kacinilmasi gereken yaygin hatalar
| Hata | Neden sorun | Bunun yerine ne yapmali |
|---|---|---|
| Her olay turu icin tetikleyici olusturmak | Bildirim seli, kullanicilar her seyi gormezden gelir | 4-5 yuksek degerli tetikleyiciyle baslayin ve ihtiyaca gore genisletin |
| Alici olarak "Tum calisma alani uyeleri" kullanmak | Herkes her sey icin bilgilendirilir | Atananlar, Olusturucu veya belirli rol sahiplerini hedefleyin |
| Bilgilendirici olaylar icin SMS etkinlestirmek | Kullanicilari gereksiz yere rahatsiz eder, maliyet olusturur | SMS'i yalnizca kritik ve acil olaylar icin saklayin |
| Sablonlari etkinlestirmeden once test etmemek | Bozuk bicimlendirme veya teslimat uretimde kesfedilir | Her zaman canli olmadan once onizleyin ve test gonderin |
| Gecmis sayfasini gormezden gelmek | Teslimat basarisizliklari farkedilmez | Basarisiz gonderimler icin Gecmis'i haftalik inceleyin |
| Ayni olay icin yinelenen tetikleyiciler olusturmak | Kullanicilar tek olay icin birden fazla bildirim alir | Birlestirilmis alicilarla tek bir tetikleyiciye konsolide edin |
| Tetikleyici etkinligini hic gozden gecirmemek | Eskimis tetikleyiciler deger olmadan gurultu uretir | Tetikleyicileri ucaylik denetleyin ve kullanilmayanlari devre disi birakin |
Ilgili sayfalar
- Uyarilara genel bakis --- Uyari sistemine giris
- Tetikleyiciler --- Olay tabanli bildirim tetikleyicilerini yapilandirin
- Sablonlar --- E-posta sablon katalogu ve degisken referansi
- Durum eslemeleri --- Durumdan duruma gecis uyarilari
- SMS yapilandirmasi --- SMS teslimat saglayicilari yapilandirin
- Bildirim tercihleri --- Kullanici basina kanal yapilandirmasi
- Uyari gecmisi --- Gonderim gunluklerini ve teslimat durumunu goruntuleyin
- Otomasyonlar --- Otomatik is akislari icin tetikleyici-eylem kurallari