Kota Kullanımı & Uyarılar

bilgi

Kota Kullanımı & Uyarılar ekranına Kimlik Yönetimi menüsünden ulaşılır; Limit Planları gibi bu ekran da, lisansında ilgili modül bulunan kurulumlarda ayrıca AI Gateway menü grubunda listelenir — iki giriş de aynı ekranı açar. Ekran hem proje menüsünden (yalnızca ilgili projenin tüketicileri) hem de Yönetici menüsünden (tüm projeler) açılabilir; her iki menü de aynı ekranı farklı kapsamla gösterir.

Her iki sekme de Kimlik yetki grubuyla yönetilir: raporu ve uyarı kurallarını görüntülemek için Görüntüleme, uyarı kuralı oluşturmak/düzenlemek/silmek için Yönetme yetkisi gerekir. Kimlik yerine AI Bütçeleri yetki grubu da kabul edilir; böylece yalnızca AI Bütçeleri → Görüntüleme yetkisi olan bir rol ekrana ve her iki sekmesine erişebilir — Limit Planları ekranlarındaki ile aynı kural. Yönetici menüsündeki projeler-arası kapsam, rol hangi yetki grubunu taşırsa taşısın her zaman sistem yöneticisi gerektirir. Uyarılar sekmesindeki iki liste başka yetki gruplarına aittir: LLM sağlayıcı kataloğu (AI Geliştirme → Görüntüleme) ve e-posta bağlantısı listesi (Bağlantılar → Görüntüleme). Bu yetkileri taşımayan bir rol ekranı yine sorunsuz açar; hata gösterilmez, yalnızca bu iki liste boş kalır: sağlayıcı kapsamlı bir kuralda sağlayıcının adı yerine ham sağlayıcı referansı görünür ve kural detayındaki e-posta bağlantısı alanı boş kalır. Role ilgili Görüntüleme yetkisi eklendiğinde adlar çözümlenir.

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	Tüketicinin bağlı olduğu ürün/portal aboneliği kotası; bir Consumer'a — ya da o Consumer'dan taşınmış bir API istemcisine — ait typed İstek Hızı ataması da bu Consumer'ın mevcut sayaçlarına katılır ve kendi tipi yerine burada Plan olarak görünür
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; typed bir AI Token Bütçesi ataması da bu kapsamda gösterilir — limit ve tüketim token adedi olarak listelenir. Sayaç, atamanın kendi öznesine göre raporlanır: bir Consumer ya da ondan taşınmış bir API istemcisi öncekiyle aynı şekilde görünür, hiç Consumer olmamış bağımsız bir API istemcisi ve bir portal uygulaması ise artık kendi satırlarıyla ayrıca görünür
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, Consumer, Hesap: Belirli kurum(lar), tüketici 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 — buna bir Consumer'dan ya da taşınmış bir API istemcisinden farklı bir özneye (proje, kuruluş, API proxy, platform ya da bir kural ataması) ait typed İstek Hızı ya da AI Token Bütçesi ataması da dahildir; 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)
Consumer	Sayacın öznesi. Sayaç bir tüketiciyle net eşleştiyse (plan sayaçları ve kullanıcı adı eşleşen politika/RLCL sayaçları) tüketici adı gösterilir. Eşleşmiyorsa sayacın anahtarlandığı değer (IP, header, JWT alanı vb.) maskelenerek gösterilir. Bir AI Token sayacının öznesi hiç tüketici kaydı olmamış bir API istemcisi ya da bir portal uygulaması olabilir; bu durumda ilgili istemci/uygulama kimliği gösterilir
Kurum	Tüketicinin bağlı olduğu kurum; politika/bilinmeyen tipli sayaçlarda boş kalır
Hesap / Uygulama	Tüketicinin 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: tüketici 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 Gateway Trafiği & Zaman Metrikleri raporuna bakın.

Bu Sayaçları Management API Üzerinden Okumak

Bu ekranın gösterdiği her şey, Kullanım Raporları API'sinin beş salt-okunur ucu üzerinden kapsam kapsam programatik olarak da okunabilir: kurum, tüketici, uygulama, API istemcisi ve API proxy için birer uç. Her biri dönemin token ve maliyet tüketimini, arkasındaki ağ geçidi trafiğini, canlı kota pencerelerini (limit, tüketilen, kalan, yüzde, sıfırlanma zamanı) ve kurum ile uygulama kapsamında bir alt seviyenin kırılımını döner.

Ekrandan iki farkı planlamaya değer:

• Bütçe satırları buradaki gibi canlıdır: o an açık olan pencereleri anlatır ve istenen dönemi dikkate almaz. Yanıt ne kadar taze olduğunu da söyler — sayaçlar yaklaşık dakikada bir eşitlenir.
• Politika ve RLCL sayaçları kimlik başına değil, pencere başına tek bir özet satır olarak, gözlenen en yüksek yüzdeyle döner. Bu sayaçların anahtarı bir istek kimliğidir (IP adresi, başlık değeri) ve platform bu değeri şifreli saklar; bu nedenle otomasyon yüzeyinde hiçbir zaman yayımlanmaz.

Okunamayan bir kaynak, ulaşılamayan ortamların adı yazılarak kısmi sonuç olarak bildirilir; asla sıfır tüketim olarak yanıtlanmaz.

İ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ı.