Dokümantasyon 09 / 10
Ölçüm yöntemi ve uptime hesabı
Bu belge, panelde, API'de ve status sayfalarında gördüğünüz oranların nasıl hesaplandığını anlatır. Amacımız rakamların iyi görünmesi değil, doğru yorumlanabilmesidir. Buradaki değerler teknik ölçümdür; sözleşmesel bir SLA taahhüdü değildir.
Süre bazlı hesap
Oranlar kontrol sayısına göre değil, süreye göre hesaplanır. Her monitörün zaman çizelgesi durum dönemlerine ayrılır ve her dönemin süresi ilgili duruma eklenir:
| Durum | Anlamı |
|---|---|
up |
Kontroller başarılı. |
degraded |
Yanıt var ama bir eşik aşıldı (yavaşlık, yaklaşan sertifika bitişi, kısmi paket kaybı). |
down |
Onaylanmış kesinti. |
maintenance |
Planlı bakım. |
unknown |
Ölçüm yok (sonuç gelmedi, ajan erişilemedi vb.). |
paused |
Monitör duraklatılmış. |
Formüller
erişilebilirlik (bakım hariç) = (up + degraded) / (up + degraded + down)
erişilebilirlik (bakım dahil) = (up + degraded) / (up + degraded + down + maintenance)
veri kapsamı = (up + degraded + down + maintenance) / (izlenen pencere − paused)
- Ölçüm olmayan süre başarı sayılmaz:
unknownsüre ne paya ne paydaya girer. Bu yüzden oranın yanında mutlaka veri kapsamına bakın. - İzleme başlamadan önceki süre pencereye dahil edilmez. Yeni eklenen bir monitör için “son 90 gün” aslında izlemenin başladığı andan itibaren hesaplanır.
- Performans sorunu (
degraded) erişilebilir sayılır; hizmet yanıt veriyordur. - Varsayılan gösterim bakım hariç orandır. API'deki
statsyanıtı her ikisini de (uptime_pct,uptime_incl_maintenance_pct) döndürür. - Hiç ölçülmüş süre yoksa oran
nulldöner; “%100” gösterilmez.
Status sayfalarında veri kapsamı %99'un altındaysa oranın yanında ayrıca gösterilir. Örneğin “%100 erişilebilirlik, veri kapsamı %62” ifadesi, dönemin yalnızca %62'sinde ölçüm yapılabildiğini ve ölçülen sürenin tamamında hizmetin erişilebilir olduğunu anlatır.
Kesinti başlangıcı ve tespit belirsizliği
- Bir kesinti, ilk başarısız ölçümün zamanında başlamış kabul edilir (ardışık hata eşiğine sonradan ulaşılsa bile).
- Gerçek başlangıç, ilk başarısız ölçümden en fazla bir kontrol aralığı önce olabilir. Bu belirsizlik API'de
detection_uncertainty_secondsalanında (monitörün kontrol aralığı) raporlanır. 5 dakikalık aralıkla izlenen bir hizmet için kesinti süresi ±5 dakika belirsizlik taşır. - Kesinti, ilk başarılı ölçümün zamanında biter; düzelme eşiği (ardışık başarı sayısı) sonradan onaylansa bile.
- Ajan tarafındaki hatalar (
error) hedef hakkında bilgi taşımadığı için kesinti sayılmaz.
Günlük özetler
Her monitör için günlük özetler (durum süreleri, kontrol sayıları, yanıt süresi istatistikleri) üretilir ve ham ölçümlerden daha uzun süre saklanır. Günler status sayfasında sayfanın saat dilimine göre bölünür. Günün rengi şu kurallarla belirlenir:
- Ölçülen süre yoksa → veri yok.
- Kesinti varsa: toplam kesinti 1 saat veya daha uzunsa ya da ölçülen sürenin %5'ine ulaştıysa → büyük kesinti; aksi halde → kısmi kesinti.
- Kesinti yoksa ve performans sorunu ölçülen sürenin en az %10'u kadar sürdüyse → performans sorunu.
- Bakım olduysa → bakım; aksi halde → operasyonel.
Yanıt süresi yüzdelikleri
- Ham ölçümler saklama süresi içindeyse p50, p95 ve p99 doğrudan ham değerlerden kesin olarak hesaplanır (
method: "exact"). - Uzun dönemler için yüzdelikler, günlük özetlerdeki yanıt süresi histogramlarının birleştirilmesiyle hesaplanır. Günlük yüzdeliklerin ortalaması alınmaz (bu istatistiksel olarak yanlış olurdu). Histogram kovaları 10, 20, 30, 50, 75, 100, 150, 200, 300, 400, 500, 750 ms, 1, 1,5, 2, 3, 5, 7,5, 10, 15, 20, 30 saniye sınırlarıyla ayrılır; bu yöntemde hata payı en fazla ilgili kovanın genişliği kadardır.
- Yanıt süresi olmayan ölçümler (ör. heartbeat pingleri) yüzdeliklere katılmaz.
Lokasyonlar
Kesinti onayında kaç lokasyonun hatayı görmesi gerektiği ve şu anki lokasyon durumu için bkz. İzleme lokasyonları.
Bu belge ürünün mevcut davranışını anlatır. Bir tutarsızlık görürseniz lütfen bize bildirin.