Kiracı analitiği
Bir hesap için dönem boyunca token, maliyet, oturum, tespit ve mevzuat maruziyeti; dönemler arası karşılaştırma ve PDF dışa aktarımıyla.
- Sürüm: 0.4
- Rol: admin_user, viewer
- Tür: görev
Kiracı Analitiği, tek bir hesap hakkında tek bir soruyu yanıtlar: bu dönemde ne kadar kullandılar, bu ne kadara mal oldu, filtreler ne yakaladı ve bu hangi mevzuatlara dokunuyor. Her rakam, aynı uzunlukta hemen önceki dönemle bir karşılaştırma taşır.
Neye ihtiyacım var?
- Lisans
- Any
- Rol
admin_userviewer
Ön koşullar
- Bakmak istediğiniz hesap var olmalı ve ağ geçidinin sohbet yolunu kullanmış olmalıdır.
- admin_user, superadmin ya da viewer olarak oturum açmış olmalısınız. Bir normal_user reddedilir.
- Hesap kapsamınızın içinde olmalıdır: bir admin_user kendini ve sahibi olduğu grupların üyelerini okur; başkası için yapılan bir istek 403 ile reddedilir.
Bu sayfa sohbet hattının kendi tablolarını okur — oturumlar, içerik tespitleri ve model kataloğu. Yapısı gereği hesap bazlıdır: burada kuruluş geneli bir görünüm yoktur ve siz birini seçene kadar hiçbir şey yüklenmez.
/assets/screenshots/tenant-analytics@0.4.pngBir hesap ve dönem seçin
Sayfayı açın
Yönetim → Kiracı Analitiği öğesini seçin.
Sayfa Select a tenant to view analytics — Use the dropdown above to choose a tenant. ekranıyla açılır. Siz seçene kadar hiçbir istek yapılmaz.
Hesabı seçin
Select a tenant… listesini açıp birini seçin; listeyi daraltmak için Search tenants… kutusuna yazın.
Rakamlar yüklenir ve araç çubuğunun sağındaki not
Showing data for {name} · {start} – {end} biçiminde okunur.
Dönemi belirleyin
7g, 30g, 90g ya da Tüm zamanlar seçin; veya Başlangıç tarihi ve Bitiş tarihi alanlarını kendiniz ayarlayın.
Tarihlerden birini ayarlamak, bölümlü denetimi özel aralığa geçirir. Sonrasında araç çubuğunun yanındaki notu okuyun: rakamların gerçekte kapsadığı pencereyi belirtir.
Güncel yanıta ihtiyacınız olduğunda yenileyin
Yenile öğesini seçin.
Sayfa yoklama yapmaz. Baktığınız şey, son getirme anındaki yanıttır.
Danger
Tüm zamanlar tüm zamanlar demek değildir. Her iki tarihi de temizler ve ağ geçidi bunun üzerine kendi varsayılanı olan son 30 günü uygular — yani Tüm zamanlar ile 30g aynı rakamları döndürür. Daha uzun bir geçmişi kapsamak için Başlangıç tarihi alanını kendiniz ayarlayın. Araç çubuğunun yanındaki not her zaman ağ geçidinin çözümlediği pencereyi belirtir ve güvenilecek rakam odur.
Hesap seçici yalnızca ilk 100 hesabı yükler. Bundan fazlasının bulunduğu bir cihazda, ilk
sayfanın ötesindeki bir hesap bu ekrandan seçilemez; bunun yerine tenant_id değeriyle
/admin/tenant-analytics/stats çağrısını yapın.
Rakamları okuyun
| Kutucuk | Neyi gösterir | Karşılaştırma |
|---|---|---|
| Total tokens | Dönemdeki istem ve tamamlama token'ları; oturum başına ortalamayla | Önceki döneme karşı; artış nötrdür |
| Estimated cost | Model kataloğundan fiyatlandırılır | Önceki döneme karşı |
| Oturumlar | Dönemde etkin oturumlar; altında tüm zamanların toplamı | Önceki döneme karşı |
| Tespitler | Dönemdeki içerik tespitleri; çoğunluk varlık türüyle | Önceki döneme karşı; burada düşüş iyi yöndür |
| Regulations violated | Tespitlerin dokunduğu farklı mevzuatlar; ilk üçü adıyla | Önceki döneme karşı |
Kutucukların altında Model Kullanımı, token'ları model bazında sağlayıcısı, payı ve oturum sayısıyla ayırır; Tespitler bunları eyleme ve varlık türüne göre böler; eğilim grafiği ise gün başına token, maliyet, oturum ve tespiti çizer.
Regulations violated kutucuğunu seçmek mevzuat dökümünü açar: mevzuat başına ihlal sayısı, ardındaki varlık türleri, eşlendiği maddeler ve şiddetleri ve tahmini bir ceza aralığı.
Warning
Ceza rakamları, mevzuat kataloğundan türetilmiş bir tahmindir; hukuki bir değerlendirme değildir ve hiçbir düzenleyicinin kestiği bir rakam değildir. Bunları mevzuatlar arasında maruziyeti sıralamanın bir yolu olarak görün, asla bir öngörü olarak değil.
Note
Ölçüt hareket etmediğinde ya da önceki dönemde karşılaştırılacak veri olmadığında karşılaştırma — no change okunur. Bu bir hata değildir.
Raporu dışa aktarın
PDF'i alın
PDF indir öğesini seçin.
Ağ geçidi aynı veriyi sizin kendi kapsamınız altında yeniden getirir ve rapor oluşturucu üzerinden basar. PDF downloaded bildirimi işlemi doğrular; dosya hesabın adıyla ve bugünün tarihiyle adlandırılır.
Ya da bağımsız HTML'i alın
HTML dışa aktar öğesini seçin.
Bu, ekrandaki verilerden tarayıcıda kendi kendine yeten bir HTML dosyası yazar — özet, model kullanımı, günlük eğilimler ve mevzuat tablosu. İstemci tarafında kurulur, dolayısıyla antet ve kapsam bloğu taşımaz; başkasına verilecek rapor PDF'tir.
Alan başvurusu
Araç çubuğu
| Denetim | Ne yapar |
|---|---|
| Select a tenant… | Hesabı seçer. Zorunludur — o olmadan hiçbir şey yüklenmez. Yalnızca ilk 100 hesap |
| 7g / 30g / 90g / Tüm zamanlar | Dönemi belirler. Tüm zamanlar her iki tarihi de temizler |
| Başlangıç tarihi / Bitiş tarihi | Açık bir aralık; herhangi biri hazır ayarı özele geçirir |
| Yenile | Yeniden getirir. Sayfa yoklama yapmaz |
| HTML dışa aktar | Ekrandakinin istemci tarafında üretilmiş HTML dosyası |
| PDF indir | Sunucuda oluşturulmuş, antetli rapor |
Yanıtın taşıdıkları
| Blok | İçerik |
|---|---|
tenant | Ad, iletişim e-postası, rol, aktiflik bayrağı, oluşturulma tarihi |
period | Çözümlenen başlangıç ve bitiş tarihleri — rakamların gerçekte kapsadığı aralık |
token_usage | Toplam token ve maliyet; her biri karşılaştırmasıyla |
model_breakdown | Model başına: görünen ad, sağlayıcı, token, maliyet, pay, oturum sayısı |
detection_stats | Toplam; eyleme ve varlık türüne göre dağılım ve çoğunluk tür |
session_stats | Dönemdeki oturumlar, tüm zamanların toplamı, oturum başına ortalama token |
daily_trends | Gün başına: token, maliyet, oturum, tespit |
regulation_stats | Mevzuat başına: ihlaller, varlık türleri, şiddetleriyle maddeler, ceza tahmini |
Doğrulama
- Az önce adına sohbet ettiğiniz bir hesabı seçin. Total tokens ve Oturumlar sıfırdan farklıdır ve not, hesabı ve çözümlenen dönemi verir.
- 30g yerine 7g seçin. Rakamlar düşer ya da aynı kalır ve nottaki tarih aralığı değişir.
- Total tokens değerini, aynı pencerede aynı hesabın Token maliyeti ve tasarruf sayfasındaki satırıyla karşılaştırın. İkisi aynı trafiği farklı tablolardan okur; büyük bir uyuşmazlık, birinin diğerinin görmediği oturumları gördüğü anlamına gelir.
- Bu sayfa hiçbir olay kaydı satırı yazmaz. Bir hesabın analitiğini okumak denetlenmez.
Başarısız olursa
- Out of scope for this tenant ile birlikte Failed to load analytics — bir 403. Bir
admin_useryalnızca kendini ve sahibi olduğu grupların üyelerini okuyabilir. Ret, hiçbir veri okunmadan önce gerçekleşir. - Tenant with ID … not found ile birlikte Failed to load analytics — bir 404. Hesap silinmiştir ya da kimlik yanlıştır.
tenant_idadını veren bir 400 — sorgu ağ geçidine geçerli bir hesap kimliği olmadan ulaştı. Panodan bu olamaz; doğrudan bir çağrıdatenant_idzorunludur ve bir UUID olmalıdır.- Select a tenant to view analytics ekranı hiç kaybolmuyorsa hesap listesi yüklenememiştir. Kiracı yönetimi sayfasını açabildiğinizi denetleyin.
- PDF export failed: … — rapor oluşturucu kapalıdır ya da zaman aşımına uğramıştır. HTML dışa aktar çalışmayı sürdürür, çünkü tarayıcıda üretilir.
- Token'lar sayılırken maliyetler sıfır okunuyorsa: kullanılan modellerin katalogda fiyatı yoktur. Bkz. Modeller.
- Tespitleri olan bir hesapta Regulations violated sıfır okunuyorsa: tespit edilen varlık türleri katalogdaki hiçbir mevzuata eşlenmiyordur. Bkz. Uyumluluk.
Sonraki adımlar
- Token maliyeti ve tasarruf — aynı harcama, her hesap için ve optimizasyon kolları ayrıştırılmış hâlde.
- Uyumluluk — ceza tahminlerinin ardındaki mevzuat kataloğu ve onları üreten tespitler.
- Tüm tespitler — sayıların ardındaki tekil tespitler.
Son güncelleme