Ana içeriğe atla
Analytics Panosu, proje içerisinde yer alan API Proxy’lerin log verilerinden oluşturulan metrikleri görselleştirir. Pano, API Proxy’lerin genel durumunu izlemeyi ve performans analizini sağlar. Pano Ekranı
Apinizer Yönetim Konsolunda API Trafiğinin sorgulanması ve analitik olarak görselleştirilmesi ancak ilgili ortama Elasticsearch Konnektörü eklenmesi ile mümkün olmaktadır.
Bir API Proxy birden fazla Ortam’a yüklenebildiği için metrikler, ortam bazlı sorgulanmaktadır. Sayfanın üst kısmından ortam seçimi yapılmalıdır.

Özellikler

Genel Durum İzleme

API Proxy’lerin genel durumunu, toplam istek sayısını, başarı/hata oranlarını görüntüleyebilirsiniz

Performans Metrikleri

Yanıt süreleri, işlem süreleri ve backend performans metriklerini analiz edebilirsiniz

Trafik Analizi

API trafiğini zaman içinde izleyebilir, yoğunluk dönemlerini tespit edebilirsiniz

Hata Takibi

Hata oranlarını, hata tiplerini ve hatalı endpoint’leri izleyebilirsiniz

Otomatik Yenileme

Sayfanın otomatik yenileme özelliğini aktifleştirerek metrikleri canlı olarak takip edebilirsiniz

Ortam Bazlı Filtreleme

Farklı ortamlar için ayrı ayrı metrikler görüntüleyebilirsiniz
Sayfanın üst kısmında yer alan Otomatik Yenileme seçeneği ile ekrandaki metrikler otomatik olarak yenilenebilir.

Pano Metrikleri

Pano, aşağıdaki ana metrik kategorilerini içerir:

Genel Metrikler

MetrikAçıklama
Toplam İstek SayısıSeçilen zaman aralığında gelen toplam API isteği sayısı
Başarılı İstek SayısıHTTP 2xx status code ile dönen istekler
Başarısız İstek SayısıHTTP 4xx ve 5xx status code ile dönen istekler
Başarı OranıBaşarılı isteklerin toplam isteklere oranı (%)
Hata OranıBaşarısız isteklerin toplam isteklere oranı (%)
Ortalama Yanıt SüresiTüm isteklerin ortalama yanıt süresi (ms)

Trafik Metrikleri

Zamana Göre İstek Sayısı

  • Zaman içinde istek sayısının değişimi (line chart)
  • Yoğunluk dönemlerinin tespiti
  • Trend analizi

API Proxy Bazında İstek Dağılımı

  • Hangi API Proxy’lerin ne kadar kullanıldığı
  • Kullanım yoğunluğu karşılaştırması
  • En çok kullanılan API’ler

Endpoint Bazında İstek Dağılımı

  • En çok çağrılan endpoint’ler
  • Endpoint kullanım istatistikleri
  • Çağrı sayısı sıralaması

HTTP Metod Dağılımı

  • GET, POST, PUT, DELETE metodlarının kullanım oranları
  • Metod bazında istek sayıları

Performans Metrikleri

Ortalama Yanıt Süresi

  • Tüm isteklerin ortalama yanıt süresi
  • Zaman içinde yanıt süresinin değişimi
  • Performans trend analizi

Yanıt Süresi Dağılımı

  • Farklı zaman aralıklarında yanıt süreleri
  • P50, P95, P99 percentile değerleri
  • Min/Max yanıt süreleri

Backend Performansı

  • Backend API’lerin yanıt süreleri
  • Backend bağlantı süreleri
  • Upstream performans metrikleri

En Yavaş Endpoint'ler

  • En yüksek yanıt süresine sahip endpoint’ler
  • Optimizasyon gerektiren API’ler

Hata Metrikleri

Durum Kodu Dağılımı

  • 2xx, 4xx, 5xx status code oranları
  • Başarı/Hata dağılımı (pie chart)

Hata Tipleri

  • Authentication errors
  • Routing errors
  • Policy errors
  • Backend errors

En Çok Hata Veren API'ler

  • Yüksek hata oranına sahip API Proxy’ler
  • Sorunlu endpoint’ler

Zamana Göre Hata Oranı

  • Hata oranının zaman içindeki değişimi
  • Hata spike’larının tespiti

İstemci Metrikleri

En Aktif İstemciler

  • En çok istek gönderen istemciler
  • İstemci bazında istek sayıları
  • Client IP/Key bazında analiz

İstemci Durum Dağılımı

  • İstemci bazında başarı/hata oranları
  • Blocked/Throttled istemciler

Otomatik Yenileme

Pano, otomatik yenileme özelliği ile metriklerin canlı olarak takip edilmesini sağlar.
1

Otomatik Yenileme Seçeneğini Aktifleştirin

Sayfanın üst kısmında yer alan Otomatik Yenileme dropdown menüsünden yenileme aralığını seçin
2

Yenileme Aralığı Seçin

  • 10 saniye
  • 30 saniye
  • 1 dakika
  • 5 dakika
3

Canlı İzleme

Seçilen aralıkta ekrandaki metrikler otomatik olarak yenilenir
Otomatik yenileme aktif olduğunda, sayfa değiştirilene kadar metrikler belirli aralıklarla güncellenmeye devam eder.
Çok kısa yenileme aralıkları (10-30 saniye) Elasticsearch üzerinde ek yük oluşturabilir. Üretim ortamlarında 1-5 dakika aralıkları önerilir.

Ortam Bazlı Sorgulama

Pano metrikleri ortam bazlı sorgulanır. Her ortam için ayrı metrikler görüntülenir.

Ortam Seçimi

1

Ortam Dropdown'ını Açın

Sayfanın üst kısmında yer alan ortam seçici dropdown’ı açın
2

İlgili Ortamı Seçin

Metrikleri görmek istediğiniz ortamı seçin (Development, Test, Production, vb.)
3

Metrikler Yüklenir

Seçilen ortam için metrikler otomatik olarak yüklenir ve gösterilir
Farklı ortamlar farklı Elasticsearch konnektörlerine bağlı olabilir. Eğer birden fazla Elasticsearch Konnektörü tanımlanmışsa, Apinizer Yönetim Konsolunda ilk eklenen Elasticsearch Konnektöründeki veriler görüntülenir.

Zaman Aralığı Filtreleme

Metrikler için zaman aralığı seçimi yapabilirsiniz:
Zaman AralığıAçıklama
Son 15 DakikaGerçek zamanlı izleme için ideal
Son 1 SaatKısa vadeli performans analizi
Son 24 SaatGünlük trafik analizi
Son 7 GünHaftalık trend analizi
Son 30 GünAylık kullanım istatistikleri
Özel AralıkBaşlangıç ve bitiş tarihi seçimi
Kısa zaman aralıkları (15 dakika - 1 saat) gerçek zamanlı izleme için, uzun zaman aralıkları (7-30 gün) ise trend analizi ve kapasite planlaması için uygundur.

Metrik Yorumlama ve Kullanım

Pano metriklerini doğru yorumlayarak API’lerinizin sağlığını izleyebilirsiniz.

Başarı Oranı Yorumlama

Başarı OranıDurumÖnerilen Aksiyonlar
> 99%Çok İyiNormal izleme devam etsin
95-99%İyiHataları izleyin, küçük iyileştirmeler yapın
90-95%DikkatHata nedenlerini analiz edin, düzeltmeler planlayın
< 90%KritikAcil müdahale gerekli, detaylı analiz yapın

Yanıt Süresi Yorumlama

Ortalama Yanıt SüresiDurumÖnerilen Aksiyonlar
< 100msMükemmelMevcut performansı koruyun
100-500msİyiOptimizasyon fırsatlarını değerlendirin
500ms-2sYavaşPerformans optimizasyonu yapın
> 2sKritikAcil optimizasyon gerekli, cache kullanımı

Trafik Analizi

Yoğunluk Dönemleri:
  • Hangi saatlerde trafik yoğun?
  • Hangi günler daha fazla istek alınıyor?
  • Kapasite planlaması yapılmalı mı?
Ani Artışlar (Spike):
  • Beklenmeyen trafik artışları var mı?
  • DDoS saldırısı şüphesi var mı?
  • Rate limiting yeterli mi?
Trend Değişiklikleri:
  • Trafik artıyor mu / azalıyor mu?
  • Mevsimsel değişiklikler var mı?
  • Yeni özellik lansmanı etkisi nasıl?

Problemlerin Tespiti ve Çözümü

Pano ile yaygın problemleri tespit edebilir ve çözüm üretebilirsiniz.

Yüksek Hata Oranı

Sorun Tespiti:
  • Hata oranı %5’in üzerinde
  • Durum Kodu Dağılımında yüksek 4xx/5xx oranı
  • Belirli endpoint’lerde yoğunlaşmış hatalar
Analiz Adımları:
  1. En Çok Hata Veren API’ler metriğine bakın
  2. API Trafiği sayfasından hatalı istekleri filtreleyin
  3. Tracing ile detaylı hata analizi yapın
Olası Çözümler:
  • Backend API sorunları → Backend ekibini bilgilendirin
  • Authentication hataları → Credential’ları kontrol edin
  • Validation hataları → İstek formatını düzeltin

Yavaş Performans

Sorun Tespiti:
  • Ortalama yanıt süresi arttı
  • En Yavaş Endpoint’ler listesinde sorunlu API’ler var
  • Backend performansı düşük
Analiz Adımları:
  1. En Yavaş Endpoint’ler metriğini inceleyin
  2. Tracing ile politika performansını analiz edin
  3. Backend yanıt sürelerini kontrol edin
Olası Çözümler:
  • Cache politikası ekleyin
  • Database sorgularını optimize edin
  • Backend timeout değerlerini ayarlayın
  • Yavaş politikaları optimize edin veya kaldırın

Anormal Trafik Artışı

Sorun Tespiti:
  • Ani ve beklenmeyen istek artışı
  • Belirli IP’lerden yoğun istek
  • Rate limit aşımları
Analiz Adımları:
  1. Zamana Göre İstek Sayısı grafiğinde spike’ları tespit edin
  2. En Aktif İstemciler metriğini kontrol edin
  3. API Trafiği ile şüpheli istekleri inceleyin
Olası Çözümler:
  • Rate limiting ve throttling politikaları ekleyin
  • IP blacklist/whitelist uygulayın
  • DDoS koruması aktifleştirin

Kullanım Senaryoları

Senaryo 1: Günlük Operasyonel İzleme

Amaç: Günlük olarak API’lerin sağlığını kontrol etmek.
1

Sabah Kontrolü Yapın

  • Genel metrikler: Başarı oranı, toplam istek sayısı
  • Gece boyunca herhangi bir sorun var mı?
2

Hata Oranını Kontrol Edin

  • Hata oranı normal seviyelerde mi?
  • Yeni hata tipleri var mı?
3

Performans Metriklerini İnceleyin

  • Yanıt süreleri normal mi?
  • Yavaşlamalar var mı?
4

Anormal Durumları Tespit Edin

  • Beklenmeyen trafik artışları
  • Yeni hata spike’ları
Önerilen Ayarlar:
  • Zaman Aralığı: Son 24 Saat
  • Otomatik Yenileme: 5 Dakika

Senaryo 2: Haftalık Performans Analizi

Amaç: Haftalık trend analizi ve kapasite planlaması.
1

Trafik Trendlerini İnceleyin

  • Trafik arttı mı / azaldı mı?
  • Hangi günler daha yoğun?
2

Performans Değişikliklerini Analiz Edin

  • Yanıt süreleri değişti mi?
  • Backend performansı nasıl?
3

En Çok Kullanılan API'leri Belirleyin

  • Hangi API’ler en çok kullanılıyor?
  • Optimizasyon ihtiyacı var mı?
4

Kapasite Planlaması Yapın

  • Mevcut kapasite yeterli mi?
  • Scaling gerekli mi?
Önerilen Ayarlar:
  • Zaman Aralığı: Son 7 Gün
  • Karşılaştırma: Önceki hafta ile

Senaryo 3: İnsident Sonrası Analiz

Amaç: Bir problem yaşandıktan sonra kök neden analizi.
1

Problem Zamanını Belirleyin

  • Özel zaman aralığı seçin (incident zamanı)
  • Spike veya anomali görülebiliyor mu?
2

Etkilenen API'leri Tespit Edin

  • Hangi API’ler etkilendi?
  • Hata tipi neydi?
3

Kök Neden Analizi

  • Backend problemi mi?
  • Politika hatası mı?
  • Trafik artışı mı?
4

Tracing ile Detaylı İnceleme

  • Problematik istekleri Tracing ile inceleyin
  • Hangi adımda hata oluştu?
Önerilen Ayarlar:
  • Zaman Aralığı: Özel (incident zamanı ±1 saat)
  • Fokus: Hata metrikleri ve etkilenen endpoint’ler

En İyi Uygulamalar

Düzenli İzleme Yapın

  • Günlük operasyonel kontroller
  • Haftalık trend analizleri
  • Aylık kapasite planlaması değerlendirmesi

Baseline Oluşturun

  • Normal performans metriklerini kaydedin
  • Baseline’dan sapmaları izleyin
  • Alarm threshold’ları belirleyin

Otomatik Yenileme Kullanın

  • Gerçek zamanlı izleme için otomatik yenileme
  • Uygun yenileme aralığı seçimi (1-5 dakika)
  • Elasticsearch yükünü göz önünde bulundurun

Ortam Bazlı İzleme

  • Her ortam için ayrı ayrı izleme
  • Production’ı öncelikli takip edin
  • Ortamlar arası karşılaştırma yapın

Metrik Yorumlamayı Öğrenin

  • Başarı oranı threshold’larını bilin
  • Yanıt süresi beklentilerini belirleyin
  • Anormal durumları hızla tespit edin

Detaylı Analiz Araçlarını Kullanın

  • Pano’dan problem tespit edin
  • API Trafiği ile detaylı inceleyin
  • Tracing ile kök neden bulun

Sınırlamalar ve Dikkat Edilmesi Gerekenler

Elasticsearch Konnektörü Gerekli:
  • Pano metriklerinin görüntülenebilmesi için ortama Elasticsearch Konnektörü eklenmiş olmalıdır
  • Birden fazla Elasticsearch Konnektörü varsa, ilk eklenen konnektörün verileri görüntülenir
Veri Güncellik Süresi:
  • Metrikler Elasticsearch’teki verilerden oluşturulur
  • Log kayıtlarının Elasticsearch’e ulaşması birkaç saniye sürebilir
  • Gerçek zamanlı değil, near real-time (yakın gerçek zamanlı) veri gösterir
Performans İpuçları:
  • Çok uzun zaman aralıkları (>30 gün) sorgu performansını etkileyebilir
  • Gereksiz sık yenileme Elasticsearch yükünü artırır
  • Filtreleme yaparak daha hızlı sonuçlar alabilirsiniz

İlgili Kaynaklar