AI Varlık Envanteri
Genel Bakış
AI Gateway → Envanter, kurulumunuzda tanımlı olan AI varlıklarının (LLM sağlayıcı bağlantıları, modeller, MCP ve A2A hedefleri) tam listesini çıkarır ve bunları gerçek trafikle karşılaştırarak onaysız (Shadow) AI kullanımı bulgularını raporlar — sağlayıcısında tanımlı olmayan model kullanımı, kayıtsız MCP/A2A sunucuları ve katalog sapması (drift). Bu, ana Analitik (ai-dashboard) ekranına gömülü bir tab değil, bağımsız bir ekrandır; ayrı bir menü kaydından erişilir ama Analitik ekranıyla aynı görüntüleme yetkisini kullanır.
Bu rapor, ISO/IEC 42001'in öngördüğü AI sistem envanteri kavramına (kurulumdaki tüm AI varlıklarının bilinmesi) ve NIST AI RMF'nin GOVERN (envanter, yönetişim) ve MAP (gerçek kullanımın haritalanması) fonksiyonlarına karşılık gelir. Uyumluluk belgesi olarak sunulmaz; kurulumunuzun bu çerçevelere göre ne durumda olduğunu gözden geçirmeniz için bir başlangıç noktasıdır.
İki Düzlemli Model
Rapor, iki bağımsız veri kaynağının farkını alarak çalışır:
Mevcut konfigürasyonu yansıtır: kayıtlı LLM sağlayıcı bağlantıları, sağlayıcıların modelleri, deploy edilmiş proxy'lerin aiRouting tanımları ve kayıtlı + proxy içine gömülü (inline) MCP/A2A hedefleri. Zaman aralığından bağımsızdır — her zaman "şu an tanımlı olan" durumu gösterir.
Seçtiğiniz zaman aralığında gerçekte kullanılan model/provider adlarını, trafik loglarından tek bir toplulaştırma sorgusuyla çıkarır. Yalnızca "kullanıldı mı / en son ne zaman kullanıldı" bilgisini ekler; envanterin yerini tutmaz.
Onaysız kullanım = bu iki düzlemin farkıdır. Sağlayıcının listelemediği modeller ve kayıtsız inline MCP/A2A hedefleri gibi bazı bulgular yalnızca envanter düzleminden üretilir — Elasticsearch bir isteğin bloklandığını (dolayısıyla hangi modele gitmeye çalıştığını) gözlemleyemez, çünkü istek sağlayıcıya hiç ulaşmadan reddedilmiştir.
Bulgular ve Envanter Tabloları
Ekranda iki ayrı tablo bulunur:
- Onaysız AI Kullanım Bulguları — bulgusu olan her varlık için bir satır; varlıkta tespit edilen her sorun bir chip olarak görünür (bulgu kodu, önem derecesi, ilgili varlık, gözlenen istek sayısı, son görülme zamanı)
- AI Varlık Envanteri — her satır bir varlık (tip, ad, provider, katalogda mı, sağlık durumu, sapma tespit edildi mi, kaç proxy tarafından kullanılıyor). Tabloyu varlık tipi ve sağlık durumuna göre süzebilir ya da varlık veya provider adıyla arayabilirsiniz.
Üstteki KPI kartları (Toplam Varlık, Kritik Bulgular, Uyarı Bulgular ı, Katalog Dışı Model, Kayıtsız MCP/A2A) her zaman filtre-öncesi gerçek değerlerdir — önem derecesi filtresi yalnızca alttaki bulgu listesini daraltır, KPI sayılarını etkilemez. Toplam Varlık dışındaki bir karta tıklarsanız iki tablo da o dilime daralır; Filtrelendi: … etiketi görünür ve karta yeniden ya da etiketin ✕ işaretine tıklamak filtreyi temizler. Nasıl okunur? düğmesi ekranı anlatan kısa bir rehber açar.
Ortam, önem derecesi ve zaman aralığı (Son N gün) filtreleri ekranın üstündeki çubukta yer alır. Zaman aralığı ve ortam yalnızca gözlem düzlemini (Elasticsearch) etkiler; envanter düzlemi bu filtrelerden bağımsız olarak her zaman güncel konfigürasyonu gösterir. Önem derecesi filtresi (Tüm önem dereceleri, Kritik, Uyarı) yalnızca bulgu tablosunu daraltır.
Gözlenen istek sayıları LLM sağlayıcı kaydı başına tutulur. Trafik logunda isteği karşılayan sağlayıcı kaydının kimliği yazılır (aipid alanı); çağrı yedek sağlayıcıya gittiyse etkin failover sağlayıcısının kimliği yazılır. Log satırları bu kimliği taşıdığında, aynı tipte iki sağlayıcı yalnız kendi isteklerini gösterir. İstek hata ile biterse, ağ geçidi önce yedek sağlayıcıyı denemiş olsa bile, hatalı isteğin satırı birincil sağlayıcı kaydına sayılır. Yalnız isteği karşılayan deneme yedek sağlayıcının kimliğini taşır.
Katalogda olmayan model bulgusu her sağlayıcı kaydı için ayrı bir satırdır. Satır sağlayıcı adını gösterir ve yalnız o sağlayıcının o modele yaptığı istekleri sayar. Aynı model iki sağlayıcıda kullanılıyorsa iki satır görürsünüz. Farklı projelerdeki iki sağlayıcı kaydı aynı ada sahip olabilir; ekran bunları sağlayıcı kaydı kimliğiyle ayırır.
Sağlayıcı kaydı kimliği olmayan istekler
Bu sürümden önce loglanan isteklerde sağlayıcı kaydı kimliği yoktur. Bu istekler ayrı olarak +N sağlayıcı kaydı olmadan (atfedilmemiş) şeklinde gösterilir ve sonradan hiçbir sağlayıcı kaydına atanmaz. Atfedilmemiş istekler sağlayıcı tipine göre ayrılır:
- Bir sağlayıcı kaydına yalnız kendi tipindeki atfedilmemiş istekler gösterilir.
- Katalogda olmayan model bulgusunda, tipi olmayan sağlayıcıya (özel sağlayıcı) yalnız tipi de olmayan istekler gösterilir.
- Envanter tablosunda tipi olmayan bir sağlayıcının atfedilmemiş istek sayısı her zaman 0'dır. Bu satırda yalnız kaydın kendi istekleri sayılır.
- Son Görülme, kaydın kendi son isteğidir. Kaydın isteği yoksa kendi tipindeki son atfedilmemiş istektir. Başka bir kaydın tarihi hiçbir zaman gösterilmez.
- Özel sağlayıcıda atfedilmemiş isteklerden Son Görülme tarihi türetilmez. Özel sağlayıcının modeli için bulgu, kaydın kendi isteği yoksa son görülme tarihi göstermez.
Envanter tablosunda Gözlenen · Son Görülme sütunu ve her sağlayıcı satırı için atfedilmemiş istek sayısı bulunur.
Sayımın sağlayıcı tipine döndüğü durumlar
Kayıt bazlı sayım için trafik log indeksinde aipid alanının keyword olarak eşlenmiş olması gerekir. Yükseltme migrasyonu bu eşlemeyi Apinizer'ın yönettiği index template'ine ekler; eşleme yeni indekslerde rollover sonrasında geçerli olur. Kayıt bazlı sayım okunamazsa rapor, önceki sürümlerdeki gibi sağlayıcı tipine göre sayar:
- İndekste
aipidiçin keyword eşlemesi yoktur; örneğin Apinizer'ın yönetmediği bir Elasticsearch connector'ı veya index template'i ya da başarısız olmuş bir template güncellemesi. - Elasticsearch sorguyu reddeder.
- Elasticsearch kısmi shard sonucu döner.
Bu durumda aynı tipteki her sağlayıcı kendi tipinin toplamını gösterir, atfedilmemiş istek sayısı 0 olur ve model bulguları modelin toplam sayısını kullanır. API Manager logunda bir uyarı yazılır (provider record counts not read ... counting by provider type).
Bulgu Kodları
Ekranda bulgu kodu, varlık tipi ve önem derecesi çevrilmiş, okunabilir etiketlerle gösterilir (örn. MODEL_NOT_IN_CATALOG → "Model sağlayıcısının listesinde yok"); aşağıdaki tablodaki ham kod ise etiketin yanında küçük yazıyla veya üzerine gelindiğinde tooltip olarak erişilebilir kalır.
| Kod | Önem | Anlamı |
|---|---|---|
PROVIDER_ENDPOINT_MISMATCH | Uyarı | Bağlantının adresi, sağlayıcı tipinin varsayılan adresinden farklı |
PROVIDER_OBSERVED_NOT_CONFIGURED | Kritik | Elasticsearch'te gözlenen bir provider, hiçbir etkin bağlantıyla eşleşmiyor (bayat deploy veya silinmiş bağlantı) |
MODEL_NOT_IN_CATALOG | Gözlenmişse Kritik, değilse Uyarı | Bir proxy'nin yönlendirmesinde kullanılan model sağlayıcının model listesinde bulunmuyor |
MCP_TARGET_UNREGISTERED / A2A_TARGET_UNREGISTERED | Kritik | Bir proxy'ye gömülü (inline) MCP/A2A hedefi, kayıtlı bağlantı setinde bulunamadı |
MCP_CATALOG_DRIFT / A2A_CATALOG_DRIFT | Uyarı | Onaylı katalog karması ile hedefin canlı araç/yetenek listesi arasında sapma tespit edildi |
Gözlem Düzleminin Sınırları
Bu rapor yalnızca Apinizer AI Gateway üzerinden geçen trafiği görebilir. Bir uygulamanın Apinizer'ı hiç kullanmadan doğrudan bir LLM sağlayıcısına yaptığı çağrılar (gerçek anlamda "gölgede" kalan kullanım) bu raporda görünmez — Apinizer herhangi bir egress/DNS izleme yapmaz. Rapor, kurulumunuzdaki bilinen (Apinizer üzerinden geçen) AI trafiğinin envanterle tutarlılığını denetler; kurumunuzdaki tüm AI kullanımının tam bir dış denetimi değildir.
Gözlem düzlemi ayrıca büyük kurulumlarda kesilebilir: model/provider/kiracı adları belirli bir üst sınırın (terim sayısı) üzerine çıkarsa, ekranda "gözlem düzlemi bazı sonuçları kesti" uyarısı görünür ve rapor o dönem için eksik sayılmalıdır — bu durumda zaman aralığını daraltmanız önerilir.
XLSX Dışa Aktarımı
Rapor, Findings ve Inventory olmak üzere iki sayfalı bir Excel dosyası olarak dışa aktarılabilir; dışa aktarılan veri, ekrandaki önem derecesi filtresinden bağımsız olarak seçili zaman aralığındaki tüm bulguları içerir. Ekrandaki değerlere ek olarak Findings sayfasında Provider Name ve Unattributed Requests sütunları, Inventory sayfasında Unattributed Requests sütunu bulunur.
Alarma Bağlama
Bu rapordaki kritik bulgu sayısı, AI Shadow Asset Count alarm tetikleyicisiyle bir alarma bağlanabilir. Sayaç bir zaman penceresi biriktirmez — her kontrolde o an geçerli kritik bulgu sayısını okur (durum sayacı, olay sayacı değil); eşik değeri 1 olarak ayarlandığında "herhangi bir onaysız/Shadow AI varlığı var" alarmı elde edersiniz.