İstemci Trafiği & Zaman Metrikleri

bilgi

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.

uyarı

Elasticsearch entegrasyonu yapılandırılmamış ortamlar için metrik verileri görüntülenemez. Bu durumda ekranda uyarı mesajı gösterilir.

not

Kimlik doğrulama sırasında çözülebilen bir kullanıcı adı/anahtar olmadan gönderilen istekler anonymous olarak loglanır ve raporda tek bir anonymous satırında toplanır. (Bir politika -- örneğin rate limiting -- isteği kullanıcı kimliği henüz çözülmeden durdurursa istemci, o politikanın çözebildiği başka bir kimlik bilgisiyle gösterilir; anonymous yalnızca hiçbir kimlik çözülemediğinde kullanılır.) Kullanıcı adının yanında, ilgili istemcinin credential kaydında tanımlı bir organizasyon bilgisi varsa bu bilgi parantez içinde gösterilir (örn. kullanici1 (ACME A.Ş.)).

Metrikler Sayfası

Bu rapor Metrikler sayfasının Clients sekmesinde Client Traffic Metrics alt-raporu olarak yer alır (dokümantasyonda İstemci Trafiği & Zaman Metrikleri). Ekrana Administration > Reports > Metrics veya proje menüsünden Analytic > Reports > Metrics ile ulaşabilirsiniz; Clients sekmesinde Client Traffic Metrics düğmesini seçin.

Clients sekmesindeki diğer alt-raporlar: IP Traffic Metrics, Clients with No Requests.

Tablo üç seviyeli bir ağaç yapısındadır; istemci satırları genişletilerek API Proxy ve metot/endpoint kırılımına inilebilir.

Filtreleme

Metrikler sayfasının üst filtre satırı tüm sekmeler ve alt-raporlar için ortaktır:

Seçenek	Açıklama
Ortam	Metrikleri görmek istediğiniz ortamı (environment) seçebilirsiniz
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 anında yeniden sorgular
Excel Export	Paylaşılan filtre satırındaki dışa aktarma; o an açık alt-raporun listesini indirir

Alt-rapor satırında Choose Your Refresh Time (varsayılan: Manual) ve yenileme düğmesi bulunur.

Tablo Sütun Açıklamaları

Tablo, istemci bazında satırlardan oluşan üç seviyeli bir ağaç (tree table) yapısındadır; sütunlar altı grup altında toplanır.

Bilgi

Sütun	Açıklama
Client (Organization) (İstemci / Kurum)	Ağaç yapısındaki satırın adı; değeri satırın seviyesine göre değişir (aşağıdaki "Satırları Genişletme" bölümüne bakınız)
Proje	(Sadece Admin menüsünde) Satırın ait olduğu proje adı -- yalnızca API Proxy seviyesindeki satırlarda dolu gelir, istemci ve metot/endpoint satırlarında boş görünür

Trafik Metrikleri (adet)

Seçilen ortam ve tarih aralığında, ilgili satıra ait isteklerin sonuç durumuna göre sayısı:

Sütun	Açıklama
Başarılı	Başarılı sonuçlanan istek sayısı
Bloklanmış	Politikalar tarafından (ör. güvenlik, rate limiting) bloklanan istek sayısı
Hatalı	Hata ile sonuçlanan istek sayısı
Toplam	Başarılı + Bloklanmış + Hatalı istek sayısı

Request Pipeline Time (ms)

İsteğin gateway'e ulaştıktan sonra backend'e yönlendirilmeden önce geçtiği istek (request) politikalarının işlenme süresi:

Sütun	Açıklama
Min.	Bu bölgede ölçülen en kısa süre (ms)
Max.	Bu bölgede ölçülen en uzun süre (ms)
Ort.	Bu bölgede ölçülen ortalama süre (ms)

Routing Time (ms)

İsteğin backend'e gönderilip yanıtın geri alınmasına kadar geçen süre (backend gidiş-dönüş):

Sütun	Açıklama
Min.	Bu bölgede ölçülen en kısa süre (ms)
Max.	Bu bölgede ölçülen en uzun süre (ms)
Ort.	Bu bölgede ölçülen ortalama süre (ms)

Response Pipeline Time (ms)

Backend'den dönen yanıtın istemciye iletilmeden önce geçtiği yanıt (response) politikalarının işlenme süresi:

Sütun	Açıklama
Min.	Bu bölgede ölçülen en kısa süre (ms)
Max.	Bu bölgede ölçülen en uzun süre (ms)
Ort.	Bu bölgede ölçülen ortalama süre (ms)

Total Time (ms)

Request Pipeline + Routing + Response Pipeline toplamı; uçtan uca toplam süre:

Sütun	Açıklama
Min.	Bu satır için ölçülen en kısa toplam süre (ms)
Max.	Bu satır için ölçülen en uzun toplam süre (ms)
Ort.	Bu satır için ölçülen ortalama toplam süre (ms)

Satırları Genişletme: İstemci → API Proxy → Metot/Endpoint

Her satırın solundaki ok simgesine tıklanarak bir alt seviyeye inilebilir. Tablo üç seviyeden oluşur:

1. İstemci satırı (1. seviye): En üst seviyedeki satırlar, seçilen ortamda ve tarih aralığında istek gönderen her bir istemciyi (kullanıcı adı/kimlik, gerekirse organizasyon bilgisiyle) temsil eder. Sütun değerleri, o istemcinin tüm API Proxy'leri ve metotları için toplanmış metriklerdir.
2. API Proxy satırı (2. seviye): Bir istemci satırı genişletildiğinde, o istemcinin çağırdığı her API Proxy ayrı bir alt satır olarak listelenir. Sütun değerleri, o istemcinin yalnızca o API Proxy'ye özel metrikleridir. Proje sütunu yalnızca bu seviyede dolu gelir.
3. Metot/Endpoint satırı (3. seviye): Bir API Proxy satırı genişletildiğinde, o API Proxy altında istemci tarafından çağrılan her metot/endpoint ayrı bir alt satır olarak listelenir. Sütun değerleri, o istemcinin yalnızca o metot/endpoint'e özel metrikleridir.