Canary ve Mirror Metrikleri
Bir API Proxy birden fazla ortama yüklenebildiği için metrikleri de yüklendiği ortama göre değerlendirmek gerekir. Bu sebeple tüm analitik ekranlarında öncelikle ortam bilgisi seçilerek metrikler filtrelenir.
Elasticsearch entegrasyonu yapılandırılmamış ortamlar için metrik verileri görüntülenemez. Bu durumda ekranda uyarı mesajı gösterilir.
Metrikler Sayfası
Bu rapor Metrikler sayfasının Canary & Mirror sekmesinde Canary & Mirror Metrics alt-raporu olarak yer alır (dokümantasyonda Canary ve Mirror Metrikleri). Ekrana Administration > Reports > Metrics veya proje menüsünden Analytic > Reports > Metrics ile ulaşabilirsiniz.
Canary ve mirror yapılandırmasının ne işe yaradığı için Canary Release ve Traffic Mirroring sayfasına bakabilirsiniz. Tekil isteklerde canary/mirror filtreleri için Ağ Geçidi Trafiği sayfasındaki gelişmiş filtre bölümünü kullanabilirsiniz.
Her satır, seçilen ortam ve tarih aralığında trafik alan bir endpoint (API Proxy + Endpoint / metot yolu) için toplanır. Sorgu en fazla 500 endpoint döndürür.
Filtreleme
Metrikler sayfasının üst filtre satırı tüm sekmeler için ortaktır:
| Seçenek | Açıklama |
|---|---|
| Ortam | Metriklerin hesaplanacağı ortamı (environment) seçersiniz |
| Proje | (Yalnızca Administration) Birden fazla proje seçerek metrikleri filtreleyebilirsiniz |
| Tarih Aralığı | Metriklerin hesaplanacağı zaman aralığı (varsayılan: son 1 saat) |
| Yenile | O an görüntülenen alt-raporu seçili filtrelerle yeniden sorgular |
| Excel Export | Paylaşılan filtre satırındaki dışa aktarma; ZIP içinde canary-mirror-metrics-report.xlsx indirir |
Alt-rapor satırında Choose Your Refresh Time (varsayılan: Manual) ve yenileme düğmesi bulunur. Otomatik yenileme seçenekleri: 1, 3 ve 5 dakika.
Tablo Sütun Açıklamaları
Tablo dört grup başlığı altında toplanır.
Bilgiler (Information)
| Sütun | Açıklama |
|---|---|
| Project | Endpoint'in ait olduğu proje (yalnızca Administration) |
| API Proxy | API Proxy adı |
| Endpoint | Metot / uç nokta yolu |
Genel Metrikler (General Metrics)
| Sütun | Açıklama |
|---|---|
| Total Requests | Seçilen aralıkta endpoint'e gelen toplam istek sayısı |
| Avg Total Time (ms) | İsteklerin gateway içindeki ortalama toplam süresi (timeApiProxyTotal ortalaması, yuvarlanmış ms) |
Canary Metrikleri (Canary Metrics)
Canary sütunları sarı arka planla vurgulanır. Değer 0 ise ekranda - gösterilir.
| Sütun | Açıklama |
|---|---|
| Canary % | Toplam istekler içinde canary isteği (isCanaryRequest=true) oranı; bir ondalık basamak |
| Canary Requests | Canary olarak işaretlenmiş istek sayısı |
| Canary Success % | Canary istekleri içinde resultType=SUCCESS oranı; yalnızca canary isteği varsa hesaplanır |
| Fallbacks | Canary yedeklemeye düşen istek sayısı — CIRCUIT_OPEN_FALLBACK, COOLDOWN_PERIOD_FALLBACK ve ERROR_THRESHOLD_FAILBACK durumlarının toplamı |
Mirror Metrikleri (Mirror Metrics)
Mirror sütunları mavi arka planla vurgulanır. Değer 0 ise ekranda - gösterilir.
| Sütun | Açıklama |
|---|---|
| Mirror % | Toplam istekler içinde en az bir mirror kopyası olan istek (mirrorCount > 0) oranı; bir ondalık basamak |
| Mirror Requests | Mirror tetiklenmiş istek sayısı (log kaydı sayısı) |
| Mirror Success % | Toplam mirror kopyaları (mirrorCount toplamı) içinde başarılı kopyalar (mirrorSuccessCount toplamı) oranı |
| Avg Mirror Time (ms) | Mirror kopyalarının ortalama toplam süresi (mirrorTotalDuration ortalaması, yuvarlanmış ms) |
Endpoint'te canary veya mirror trafiği yoksa ilgili sütunlarda - görünür; genel metrik sütunları (Total Requests, Avg Total Time) yine doldurulur.