Pano
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.
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. Yönetim > Analitik > Pano yolunda ek Proje filtresi ile tüm projeler veya seçili projeler kapsanır; proje menüsündeki pano yalnızca aktif projeyi kapsar.
API ve AI Görünümleri
Lisansınız hem API Gateway hem AI Gateway'i kapsıyorsa, üst satırın başındaki API | AI anahtarı görünümü seçer. API görünümü bu sayfada anlatılan panodur. AI görünümü, AI, MCP ve A2A trafiği için AI Gateway genel bakışını gösterir; diğer AI analitik sekmeleri Rapor > Metrikler ve Analitik > Trafik sayfalarındadır. Yalnızca bir görünüm lisanslıysa anahtar gizlenir ve o görünüm açılır. Yalnızca seçili görünüm yüklenir.
Özellikler
API Proxy'lerin genel durumunu, toplam istek sayısını, başarı/hata oranlarını görüntüleyebilirsiniz
Ortalama toplam süreyi, ortalama backend süresini ve yönlendirme fazlarının gecikmelerini analiz edebilirsiniz
API trafiğini zaman içinde izleyebilir, yoğunluk dönemlerini tespit edebilirsiniz
Hatalı ve bloklanmış istek sayılarını, endpoint ve istemci bazındaki dağılımlarını ve yönlendirme hata nedenlerini izleyebilirsiniz
Sayfanın otomatik yenileme özelliğini aktifleştirerek metrikleri canlı olarak takip edebilirsiniz
Farklı ortamlar için ayrı ayrı metrikler görüntüleyebilirsiniz
Sayfanın üst kısmındaki Yenileme Zamanı Seçiniz listesinden bir aralık seçerek ekrandaki metriklerin otomatik olarak yenilenmesini sağlayabilirsiniz.
Pano Metrikleri
Sayfadaki filtrelerle (ortam, zaman aralığı, Tüm Proxy'ler seçicisiyle isteğe bağlı olarak tek bir API Proxy ve yönetim panosunda proje) seçilen veriler için pano aşağıdaki bölümleri gösterir. Bir API Proxy seçildiğinde kutular, grafikler ve Yönlendirme Teşhisi paneli o proxy'ye göre daraltılır.
Özet Kutular
| Kutu | Açıklama |
|---|---|
| Toplam İstek | Seçilen aralıktaki toplam istek sayısı |
| Başarılı İstek Sayısı | Başarıyla sonuçlanan istek sayısı |
| Bloklanmış İstek Sayısı | Gateway tarafından reddedilen istek sayısı (politika ihlalleri, bulunamayan API Proxy veya endpoint, erişim kısıtlamaları vb.) |
| Hatalı İstek Sayısı | Hatayla sonuçlanan istek sayısı |
| Başarı Oranı | Başarılı isteklerin toplam isteklere oranı |
Grafikler
Zaman içinde başarılı, bloklanmış ve hatalı istek sayılarını gösteren çizgi grafik
Zaman içinde Ortalama Toplam Süresi (ms) ile Ortalama Backend API Süresi (ms) değerlerini karşılaştıran çizgi grafik
En çok istek alan 10 endpoint için başarılı, bloklanmış ve hatalı istek sayıları
En çok istek gönderen 10 istemci için başarılı, bloklanmış ve hatalı istek sayıları
Yönlendirme Teşhisi
Sayfanın alt bölümünde Yönlendirme Teşhisi paneli yer alır. Panel, seçili ortam ve tarih aralığındaki başarısız ve yavaş yönlendirme denemelerini özetler: hangi hataların baskın olduğunu, sürenin nerede harcandığını, hangi proxy ve upstream adreslerinin etkilendiğini gösterir. Her kartın başlığındaki bilgi simgesinin üzerine gelindiğinde o kartın nasıl okunacağı görüntülenir.
- Hata Nedeni Dağılımı — yönlendirme hata nedenlerinin dağılımı; grafiğin dikey ekseni istek sayısını gösterir
- Faz Gecikmesi (p50/p95/p99, ms) — yönlendirme fazlarının gecikmeleri; grafiğin dikey ekseni milisaniye (ms) gösterir
- En Çok Hata Üreten Proxy'ler — seçilen aralıkta en çok yönlendirme hatası veren API Proxy'ler
Ayrıca yavaş istemci ile yavaş backend karşılaştırması (ortalama süreler) ve en sık kullanılan upstream adresleri birimleriyle (ms, istek) birlikte gösterilir.
Tekil istek düzeyinde aynı sinyaller için Trafik detay penceresindeki Yönlendirme Teşhisi bölümüne bakabilirsiniz.
Otomatik Yenileme
Pano, otomatik yenileme özelliği ile metriklerin canlı olarak takip edilmesini sağlar.
Sayfanın üst kısmındaki Yenileme Zamanı Seçiniz listesinden yenileme aralığını seçin (varsayılan: Manuel)
- Manuel
- 1 dakika
- 3 dakika
- 5 dakika
Seçilen aralıkta özet kutular ve grafikler otomatik olarak yenilenir. Yönlendirme Teşhisi paneli otomatik yenilemede güncellenmez; sayfa ilk açıldığında, elle yenilendiğinde veya filtre değiştiğinde yeniden yüklenir.
Otomatik yenileme aktif olduğunda, sayfa değiştirilene kadar metrikler belirli aralıklarla güncellenmeye devam eder.
Otomatik yenileme her aralıkta Elasticsearch'e yeniden sorgu gönderir; kısa yenileme aralıkları Elasticsearch üzerindeki yükü artırır.
Ortam Bazlı Sorgulama
Pano metrikleri ortam bazlı sorgulanır. Her ortam için ayrı metrikler görüntülenir.
Ortam Seçimi
Sayfanın üst kısmında yer alan ortam seçici dropdown'ı açın
Metrikleri görmek istediğiniz ortamı seçin (Development, Test, Production, vb.)
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
Zaman aralığı seçicisinde iki sekme bulunur:
- Hızlı Seçim: "Son" ifadesiyle birlikte bir sayı ve birim seçerek göreli aralık tanımlayabilirsiniz. En Sık Kullanılanlar altında hazır seçenekler bulunur: Bugün, Son 15 dakika, Son 30 dakika, Son 1 saat, Son 24 saat, Bu hafta, Son 7 gün, Son 30 gün, Son 90 gün, Son 1 yıl.
- Tarih Aralığı: Başlangıç ve bitiş tarihi seçerek mutlak aralık tanımlayabilirsiniz.
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 İyi | Normal izleme devam etsin |
| 95-99% | İyi | Hataları izleyin, küçük iyileştirmeler yapın |
| 90-95% | Dikkat | Hata nedenlerini analiz edin, düzeltmeler planlayın |
| < 90% | Kritik | Acil müdahale gerekli, detaylı analiz yapın |
Yanıt Süresi Yorumlama
| Ortalama Toplam Süre | Durum | Önerilen Aksiyonlar |
|---|---|---|
| < 100ms | Mükemmel | Mevcut performansı koruyun |
| 100-500ms | İyi | Optimizasyon fırsatlarını değerlendirin |
| 500ms-2s | Yavaş | Performans optimizasyonu yapın |
| > 2s | Kritik | Acil 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:
- Başarı Oranı düştü
- Hatalı İstek Sayısı kutusunda artış
- Belirli endpoint'lerde yoğunlaşmış hatalar
Analiz Adımları:
- En Aktif 10 Endpoint grafiğinde hatalı istek sayısı yüksek endpoint'lere, yönlendirme hataları için Yönlendirme Teşhisi panelindeki En Çok Hata Üreten Proxy'ler listesine bakın
- Trafik sayfasından hatalı istekleri filtreleyin
- Tracing ile detaylı hata analizi yapın
Olası Çözümler:
- Backend API sorunları → Backend ekibini bilgilendirin
- Authentication hataları → Kimlik bilgilerini kontrol edin
- Validation hataları → İstek formatını düzeltin
Yavaş Performans
Sorun Tespiti:
- Tepki Süresi grafiğinde ortalama toplam süre arttı
- Ortalama backend süresi yükseldi
Analiz Adımları:
- Tepki Süresi grafiğinde ortalama toplam süre ile ortalama backend süresi arasındaki farka bakın; yönlendirme kaynaklı gecikmeler için Yönlendirme Teşhisi panelindeki Faz Gecikmesi grafiğini inceleyin
- Tracing ile politika performansını analiz edin
- 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ı:
- Trafik grafiğinde ani artışları tespit edin
- En Aktif 10 İstemci grafiğini kontrol edin
- Trafik 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.
- Genel metrikler: Başarı oranı, toplam istek sayısı
- Gece boyunca herhangi bir sorun var mı?
- Hatalı istek sayısı normal seviyelerde mi?
- Yönlendirme Teşhisi panelinde yeni hata nedenleri var mı?
- Yanıt süreleri normal mi?
- Yavaşlamalar var mı?
- 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ı.
- Trafik arttı mı / azaldı mı?
- Hangi günler daha yoğun?
- Yanıt süreleri değişti mi?
- Backend performansı nasıl?
- Hangi API'ler en çok kullanılıyor?
- Optimizasyon ihtiyacı var mı?
- Mevcut kapasite yeterli mi?
- Scaling gerekli mi?
Önerilen Ayarlar:
- Zaman Aralığı: Son 7 gün
Senaryo 3: İnsident Sonrası Analiz
Amaç: Bir problem yaşandıktan sonra kök neden analizi.
- Tarih Aralığı sekmesinden incident zamanını seçin
- Spike veya anomali görülebiliyor mu?
- Hangi API'ler etkilendi?
- Hata tipi neydi?
- Backend problemi mi?
- Politika hatası mı?
- Trafik artışı mı?
- Problematik istekleri Tracing ile inceleyin
- Hangi adımda hata oluştu?
Önerilen Ayarlar:
- Zaman Aralığı: Tarih Aralığı sekmesinden incident zamanı ±1 saat
- Fokus: Hatalı istek sayıları, Yönlendirme Teşhisi ve etkilenen endpoint'ler
En İyi Uygulamalar
- Günlük operasyonel kontroller
- Haftalık trend analizleri
- Aylık kapasite planlaması değerlendirmesi
- Normal performans metriklerini kaydedin
- Baseline'dan sapmaları izleyin
- Alarm threshold'ları belirleyin
- 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
- Her ortam için ayrı ayrı izleme
- Production'ı öncelikli takip edin
- Ortamlar arası karşılaştırma yapın
- Başarı oranı threshold'larını bilin
- Yanıt süresi beklentilerini belirleyin
- Anormal durumları hızla tespit edin
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