> For the complete documentation index, see [llms.txt](https://docs.kangal.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kangal.dev/tr/metering-ve-billing/billing.md). # Metering ve billing genel bakış Kangal birbiriyle ilişkili ancak ayrı iki ticari kontrol sunar: * **Haklar ve kotalar**, tenant'ın bir özelliği kullanıp kullanamayacağını ve ne kadar kapasiteye sahip olduğunu belirler. * **Ölçüm ve faturalandırma**, ağ geçidi kullanımını ölçer, USD cinsinden fatura önizlemesi hesaplar ve kesin faturalandırma dönemlerini kalıcılaştırabilir. Tenant'a entitlement planı atamak her ağ geçidinin `plan_code` değerini otomatik olarak değiştirmez. Yeni müşteri eklerken veya sözleşme değiştirirken her iki görünümü de doğrulayın. Uygulama ve veri kalitesi ayrıntıları için [Haklar ve ölçüm](/tr/metering-ve-billing/entitlements-metering.md) bölümüne bakın. ## Konsol iş akışları ### Haklar `//dashboard/admin/entitlements` adresini açın. * Tenant yöneticileri etkin planlarını, etkin özellikleri, kullanılan ve ayrılmış birimleri, sınırları, dönemleri, uyarıları ve geçersiz kılmaları inceleyebilir. * Super-admin'ler başka bir tenant seçip katalog planı atayabilir. * Geçersiz kılma, sıfırlama ve atama geçmişine API ve denetim izi üzerinden erişilebilir. ### Ölçüm ve Faturalandırma `//dashboard/admin/metering-billing` adresini açın. 1. Tüm ağ geçitlerini veya tek bir ağ geçidini seçin. 2. 7, 30 veya 90 günlük önizleme aralığı seçin. 3. İstekleri, aşım tutarını, AI token'larını ve sağlayıcı maliyetini, ayrıca etkin veya bekleyen portal uygulamalarını inceleyin. 4. Her satırın kullanım kaynağını ve kota durumunu kontrol edin. 5. Önizlemeyi CSV veya JSON olarak dışa aktarın; kesin dışa aktarım için kalıcı ledger veya dönem kimliğini kullanın. Sayfa ayrıca faturalandırma döneminin kapatılmasına izin verilip verilmediğini, aylık kapatma sayısını veya kotasını ve son kalıcı reconciliation kaydını gösterir. ## Faturalandırma planı kataloğu Sunucu tarafı ölçüm kataloğu şu ağ geçidi plan kodlarını tanır: | Plan kodu | Ağ geçidi-ay başına taban ücret | Aylık dahil istek | Her 1.000 fazla istek için ücret | | --------------------- | ------------------------------: | ----------------: | -------------------------------: | | `serverless_starter` | $0 | 1.000.000 | $0,20 | | `serverless_team` | $49 | 5.000.000 | $0,16 | | `dedicated_cloud` | $499 | 10.000.000 | $0,12 | | `self_managed_hybrid` | $999 | 25.000.000 | $0,05 | Katalog girdilerinin tamamı istekleri kesin olarak engellemek yerine ölçümlü aşım uygular. Taban ücret ve dahil istekler seçili dönem için `days / 30` oranıyla hesaplanır. Kanıt varsa AI sağlayıcı maliyeti eklenir; plan markup oranı %0'dır. Fatura önizlemeleri USD kullanır ve vergiyi sıfır kabul eder. Eksik veya tanınmayan ağ geçidi `plan_code` değerleri ölçüm hesabında `serverless_starter` planına döner. Ağ geçidi oluşturma veya güncelleme sonrasında ve faturalandırma dönemini kapatmadan önce kodu doğrulayın. Bu değerler çalışma zamanı kataloğudur; sipariş formu, vergi hesabı, sağlayıcı faturası veya müzakere edilmiş sözleşmenin yerine geçmez. ## Ölçülen değerler | Ölçüm | Kaynak ve davranış | | ------------------------- | ---------------------------------------------------------------------------------------- | | İstekler | Açıkça belirtilen dönemde tenant ve ağ geçidi kapsamlı trafik günlüğü kayıtlarını sayar. | | AI token'ları ve maliyeti | Başarılı AI denetim olaylarını kullanır; cache hit ve başarısız istekler sıfır sayılır. | | Portal uygulamaları | Etkin ve bekleyen uygulamaları raporlar; bunlar faturada bilgilendirici toplamlardır. | | Taban ücret | Ağ geçidi planının taban tutarını seçili döneme oranlar. | | İstek aşımı | Döneme oranlanmış dahil miktarı aşan isteklerdir. | Ucu açık dashboard önizlemesinde kesin kayıt yoksa yedi günlük toplam ağ geçidi metrikleri seçilen aralığa ölçeklenebilir. Bu sonuç tahminidir ve kesinleştirilemez. ## Tenant ve ağ geçidi kapsamı Her özet, snapshot, kapatılmış dönem ve dışa aktarım tenant kapsamlıdır. Standart yönetici başka bir `tenant_id` koyamaz. İsteğe bağlı `gateway_id`, hesabı daraltır; ledger veya dönem sorgusu yine aynı tenant'ı gerektirir. Başka tenant'a ait bilinmeyen kimlikler reddedilir veya bulunamadı olarak görünür. ## Operasyon notları * Fatura önizlemesini ticari bir kararda kullanmadan önce her ağ geçidinin tanınan `plan_code` değerini doğrulayın. * Muhasebe devri için açık UTC dönem sınırları kullanın ve `data_quality: exact` değerini zorunlu tutun. * Kalıcı içerikten bir ledger snapshot'ı veya faturalandırma dönemi kesinleştirilip dışa aktarılana kadar dashboard önizlemelerini operasyonel tahmin olarak değerlendirin. * Her sözleşme değişikliğinden sonra tenant entitlement'larını ve ağ geçidi faturalandırma planlarını uzlaştırın; bunlar ayrı kontrollerdir. ## Önizleme API'si ```bash export KANGAL_URL='https://api.example.com' export KANGAL_API_TOKEN='' curl --get "$KANGAL_URL/admin/metering-billing/summary" \ --header "Authorization: Bearer $KANGAL_API_TOKEN" \ --data-urlencode 'tenant_id=acme' \ --data-urlencode 'days=30' ``` Kesin ve sınırlı bir hesaplama için hem `period_start` hem `period_end` kullanın. Bitiş sınırı hariçtir ve bir dönem 366 günü aşamaz. Önizleme dışa aktarımları kullanışlıdır ancak tahmin içerebilir. Muhasebe devri için kesinleştirilmiş ledger snapshot'ını veya kapatılmış dönemi dışa aktarın: ```bash curl --get "$KANGAL_URL/admin/metering-billing/invoice/export" \ --header "Authorization: Bearer $KANGAL_API_TOKEN" \ --data-urlencode 'tenant_id=acme' \ --data-urlencode 'period_id=' \ --data-urlencode 'format=csv' ``` `ledger_id` ve `period_id` birlikte gönderilemez. Taslak ledger dışa aktarılmadan önce kesinleştirilmelidir. ## Faturalandırma durumlarının anlamı | Durum | Anlamı | | ------------------- | -------------------------------------------------------------------------------------------------------- | | `current_cycle` | Seçili dönem kesin ve faturalandırmaya uygun veriye sahiptir. | | `estimated_preview` | En az bir ağ geçidi ölçeklenmiş metrik veya tahmini AI maliyeti kullanır. | | `usage_unavailable` | Gerekli kullanım kanıtı doğrulanamıyordur. | | `within_limit` | Dahil isteklerin %80'inden azı kullanılmıştır. | | `approaching_limit` | En az %80'i kullanılmış ancak dahil miktar aşılmamıştır. | | `overage` | Ölçümlü aşım politikası altında dahil istek miktarı aşılmıştır. | | `blocked` | Kesin engelleyen faturalandırma politikası için ayrılmıştır; katalog planlarının hiçbiri bunu kullanmaz. | ## Sorun giderme | Belirti | Kontrol | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | Kullanım görünmüyor | Ağ geçidinin tenant'a ait olduğunu ve trafik günlüğü veya toplam metrik ürettiğini doğrulayın. | | Özet `503` döndürüyor | Bir ölçüm kaynağı başarısızdır; Kangal sessizce sıfır raporlamak yerine işlemi durdurur. | | Önizleme tahmini görünüyor | Açık dönem sınırları kullanın ve kesin trafik ile faturalandırılmış AI denetim verisinin bulunduğundan emin olun. | | Kullanım kullanılamıyor | AI toplamları kullanım gösteriyor, ancak başarılı olaylara ait kesin kanıt eksik veya tamamlanmamıştır. | | Beklenen plan Starter görünüyor | Ağ geçidi `plan_code` değeri eksik veya tanınan faturalandırma kataloğunda değildir. | | Dışa aktarım `409` döndürüyor | Ledger hâlâ taslaktır, veri tahmini veya uygun değildir, watermark eşleşmiyordur ya da bütünlük doğrulaması başarısızdır. | | Dönem kapatma reddediliyor | Tenant faturalandırma etkinliğini, dönem kapatma etkinliğini ve aylık kapatma kotasını kontrol edin. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.kangal.dev/tr/metering-ve-billing/billing.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.