Kota Kullanımı & Uyarılar

bilgi

Kota Kullanımı & Uyarılar ekranına Kimlik Yönetimi menüsünden ulaşılır. Ekran hem proje menüsünden (yalnızca ilgili projenin kimlik bilgileri) hem de Yönetici menüsünden (tüm projeler) açılabilir; her iki menü de aynı ekranı farklı kapsamla gösterir.

Kota Kaynakları

Ekranda listelenen her satır, platformun farklı bir kota mekanizmasından gelen bir sayaçtır. Tip sütunu sayacın hangi kaynaktan geldiğini gösterir:

Tip	Sayacın Kaynağı
Plan	Kimlik bilgisinin bağlı olduğu ürün/portal aboneliği kotası
Politika	API Proxy veya Proxy Grubu üzerine eklenen API Bazlı Kota politikası
RLCL	Rate Limit Kontrol Listesi tanımından gelen sayaç
AI Token	AI Gateway token bütçesi; limit ve tüketim token adedi olarak gösterilir
AI Maliyet	AI Gateway aylık USD bütçesi; limit ve tüketim para birimi (USD) olarak gösterilir

Rapor

Aktif kota pencerelerindeki tüketimi listeler ve filtreler.

Filtreler

Rapor aşağıdaki kriterlere göre filtrelenebilir:

• Kurum, Credential, Hesap: Belirli kurum(lar), kimlik bilgisi veya portal hesabına göre daraltma.
• API Proxy / Proxy Grubu: Sayacın uygulandığı API Proxy veya Proxy Grubuna göre daraltma.
• Tip: Yukarıdaki beş kota kaynağından birine veya birkaçına göre daraltma.
• Kapanmış pencereleri göster: Süresi dolmuş (son 24 saat içinde kapanmış) pencereleri de listeye ekler; varsayılan olarak yalnızca aktif pencereler görünür.
• Diğer sayaçları göster: Biçimi tanınamayan ve bu yüzden Diğer olarak sınıflandırılan sayaçları listeye ekler; varsayılan olarak gizlidir.

Ayrıca hızlı bir gösterim filtresiyle liste Tümü, %70+ (izlemede) veya %90+ (kritik) kullanım seviyesine göre daraltılabilir.

Özet Kartları

Filtre alanlarının hemen altında üç özet kart gösterilir; yalnızca aktif pencereleri sayar (kapanmış pencereler bu sayılara dahil edilmez):

Kart	Anlamı
Aktif Sayaç	Filtreye uyan aktif kota penceresi sayısı
Kritik (%90+)	Kullanımı %90 ve üzerinde olan aktif sayaç sayısı
İzlemede (%70-90)	Kullanımı %70-%90 arasında olan aktif sayaç sayısı

Tablo Kolonları

Kolon	Açıklama
Tip	Sayacın kota kaynağı (Plan / Politika / RLCL / AI Token / AI Maliyet / Diğer)
Credential	Sayacın öznesi. Sayaç bir kimlik bilgisiyle net eşleştiyse (plan sayaçları ve kullanıcı adı eşleşen politika/RLCL sayaçları) kimlik bilgisi adı gösterilir. Eşleşmiyorsa sayacın anahtarlandığı değer (IP, header, JWT alanı vb.) maskelenerek gösterilir
Kurum	Credential'ın bağlı olduğu kurum; politika/bilinmeyen tipli sayaçlarda boş kalır
Hesap / Uygulama	Credential'ın portal aboneliğine bağlı hesap ve uygulama; portala bağlı olmayan sayaçlarda boştur
API Proxy/Grup	Sayacın uygulandığı API Proxy veya Proxy Grubu
Ortam	Sayacın ölçüldüğü ortam (environment)
Aralık	Kota penceresinin süresi: Saatlik, Günlük veya Aylık
Limit	Bu pencere için uygulanan gerçek istek (veya AI Maliyet için USD) limiti; sınırsız sayaçlarda boştur
Tüketim	Bu pencerede o ana kadar tüketilen gerçek miktar (canlı sayaç)
Pencere Sıfırlanma	Mevcut kota penceresinin sıfırlanacağı (yenileneceği) tarih ve saat
Kullanım	Tüketimin limite oranı; %70 altı normal, %70-90 izlemede, %90 ve üzeri kritik renklendirilir
Kapandı	Süresi dolmuş bir pencerenin rozeti; yalnızca "Kapanmış pencereleri göster" açıkken görünür

Veri Tazeleme

Rapor verileri kota sayaçlarından dakikada bir güncellenir; son birkaç dakikanın tüketimi hafif gecikmeli görünebilir. AI Token ve AI Maliyet satırları ise saatlik AI faturalama toplulaştırmasından geldiği için gerçek zamanlı uygulamadan yaklaşık 1 saate kadar geride kalabilir.

Uyarı Tanımları

Kota tüketimi belirlenen koşulları sağladığında otomatik bildirim gönderen kurallar tanımlanır.

Koşul Tipleri

Koşul	Tetiklenme
Kullanım yüzdesi eşiğin üzerinde	Kullanım oranı tanımlanan yüzdeye (örn. %80) ulaştığında
Kalan istek sayısı eşiğin altında	Pencerede kalan istek/token sayısı tanımlanan değerin altına düştüğünde
Kota tükendi	Pencere limitine ulaşıldığında (kullanım %100)
Ardışık pencereler eşiğin üzerinde	Kullanım, art arda gelen belirli sayıda pencerede eşiği aştığında (kalıcı/tekrarlayan aşırı kullanımı yakalamak için)

Bir kural, isteğe bağlı olarak belirli kota aralığı (Saatlik/Günlük/Aylık) ve belirli sayaç tipleri (Plan/Politika/RLCL/AI Token/AI Maliyet) ile sınırlandırılabilir; hiçbiri seçilmezse kural yalnızca gateway istek sayaçlarını (Plan/Politika/RLCL) kapsar — AI Token/AI Maliyet kapsamı her zaman açıkça seçilir. AI sayaç tipi seçildiğinde kural isteğe bağlı olarak belirli bir model veya sağlayıcıya da daraltılabilir.

Kapsam ve Alıcılar

Bir kural varsayılan olarak tüm kurum ve credential'ları kapsar; isteğe bağlı olarak belirli kurumlarla sınırlandırılabilir. Bildirim e-postası üç alıcı tipinden biri veya birkaçıyla gönderilebilir:

Alıcı Tipi	Açıklama
Kurum	Kotayı aşan/yaklaşan credential'ın bağlı olduğu kurumun bildirim e-postaları
Portal Hesabı	Portal hesabının e-postası (portal bağlantılı sayaçlarda)
Sabit Alıcılar	Kural içinde tanımlanan sabit e-posta adresleri

E-posta içeriği yerleşik bir şablonla gönderilir; istenirse özel bir konu/başlık ve içerik şablonu tanımlanabilir. E-postaya ek olarak, ek bildirim kanalları (Slack, webhook vb.) da tanımlanabilir.

Hatırlatmalar ve Bildirim Geçmişi

Koşul aynı kota penceresinde sürdüğü sürece en fazla belirlenen sayıda bildirim gönderilir, ardışık bildirimler arasında en az belirlenen dakika kadar süre bırakılır. Her kural için gönderilen son 100 bildirim, tarih, alıcı ve içerikleriyle birlikte geçmiş olarak görüntülenebilir.

Kota, RLCL ve Hız Sınırlama (Throttle) İlişkisi

Bu ekranda görülen sayaçlar saat/gün/ay pencereli, uzun dönemli kota mekanizmalarına aittir: kimlik bilgisi planı, API Bazlı Kota politikası, Rate Limit Kontrol Listesi'nin saat/gün/ay periyotlu tanımları ve AI Gateway bütçeleri.

API Bazlı Daraltma politikası gibi saniye/dakika bazlı kısa süreli hız sınırlama (throttling) sayaçları ile Rate Limit Kontrol Listesi'nin saniye/dakika periyotlu tanımları bu ekranda yer almaz — bu sayaçlar anlık koruma (burst/DDoS önleme) amaçlıdır ve her istekte hızla sıfırlanıp yenilenir. Bu tür kısa süreli sınırların anlık durumu, ilgili politika response header'larına yansıtılan rate limit bilgilerinden (kalan istek sayısı, limit, yenilenme zamanı) takip edilebilir.

Hangi Ekranı Kullanmalıyım?

• Uzun dönem kota tüketimini (aylık abonelik limiti, RLCL saatlik/günlük/aylık kotası, AI bütçesi) izlemek ve eşik aşımında bildirim almak için bu ekranı kullanın.
• Kısa süreli hız sınırlama durumunu anlık olarak görmek için ilgili API çağrısının response header'larındaki rate limit bilgilerine bakın.
• AI Gateway kullanımının kişi/grup/model/sağlayıcı bazında geçmişe dönük analitiği için AI Raporları sayfasına, genel API trafiği analitiği için API Trafiği & Zaman Metrikleri raporuna bakın.

İlgili Sayfalar

API Bazlı Kota

Uzun dönem (saat/gün/hafta/ay) toplam istek kotası politikasının yapılandırılması.

API Bazlı Daraltma

Kısa süreli (saniye/dakika) hız sınırlama politikasının yapılandırılması.

Rate Limit Kontrol Listesi

Kimlik bazlı hız sınırlama tanımlarının yönetimi.

Token Kotaları ve Hız Sınırlaması

AI Gateway token ve USD bütçelerinin yapılandırılması.