Firebase hizmetleri için harcama sınırları ayarlama

Önizleme: Harcama sınırı bütçeleri Önizleme aşamasındadır. Bu nedenle, herhangi bir HDS'ye veya kullanımdan kaldırma politikasına tabi değildir ve geriye dönük uyumsuzluk olacak şekilde değiştirilebilir.

Bu sayfada, Firebase projeniz Blaze fiyatlandırma planındayken harcama sınırı bütçelerini nasıl oluşturacağınız ve yöneteceğiniz açıklanmaktadır.

Harcama sınırı bütçeleri şu Firebase hizmetlerinde kullanılabilir: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase ve Firebase Extensions.

Önemli: Harcama sınırları "kesin sınırlar" değildir. Kullanım raporlamasındaki gecikme nedeniyle harcama sınırı yaptırımı anında gerçekleşmez ve birkaç dakika gecikebilir. Bu gecikme sırasında ortaya çıkan maliyet fazlalıkları normal şekilde faturalandırılır.
Bu nedenle, bütçenizi mutlak sınırınızın biraz altında belirlemeniz ve harcama sınırlarını, maliyetlerinizi yönetmenize ve beklenmedik büyük faturaların etkisini azaltmanıza yardımcı olabilecek araçlardan yalnızca biri olarak değerlendirmeniz gerekir. Ek uyarı ve mantık seçenekleri hakkında daha fazla bilgi edinin.

Harcama sınırı yapılandırma talimatlarına atlayın

Bütçeleri anlama

Google Cloud Billing için bütçe oluşturarak maliyetlerinizi kontrol edebilir ve faturanızda sürprizlerle karşılaşmaktan kaçınabilirsiniz. Bütçeler, her ay harcamayı planladığınız genel para tutarlarıdır ve yalnızca eşiğe ulaşıldığında uyarı gönderen bütçeler veya harcama sınırı bütçeleri olabilir.

Yalnızca eşiğe ulaşıldığında uyarı gönderen bütçeler

• Harcama, bütçeniz için belirlenen eşiklere ulaşırsa Cloud Billing e-posta bildirimleri gönderir.

• Aşağıdakileri göz önünde bulundurun:

  • Bütçe uyarıları hizmetleri duraklatmaz. Bu uyarılar, maliyetlerinizi izlemenize yardımcı olmak ve gerektiğinde işlem yapabilmeniz için sizi uyarmak amacıyla tasarlanmıştır. Örneğin, projede faturalandırmayı devre dışı bırakmak için bütçe bildirimlerini kullanabilirsiniz.

  • Firebase konsolunda Blaze fiyatlandırma planına geçtiğinizde otomatik olarak yalnızca eşiğe ulaşıldığında uyarı gönderen bütçe oluşturmanız istenir. Google Cloud konsolunda yalnızca eşiğe ulaşıldığında uyarı gönderen bütçeleri manuel olarak da ayarlayabilirsiniz.

Harcama sınırı bütçeleri (bu sayfa)

• Harcama, belirli bir hizmet için bütçenizde belirlenen eşiklere ulaşırsa Cloud Billing e-posta bildirimleri gönderir.

• Harcama, ilgili hizmet için bütçenizin %100'üne ulaşırsa Cloud Billing, ilgili hizmeti ayın geri kalanında duraklatır.

• Aşağıdakileri göz önünde bulundurun:

  • Harcama sınırı bütçeleri yalnızca şu Firebase hizmetlerinde kullanılabilir: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase ve Firebase Extensions.

  • Harcama sınırı bütçelerini Firebase konsolunda (bu sayfada açıklandığı gibi) veya Google Cloud konsolunda manuel olarak ayarlayabilirsiniz.

  • Harcama sınırı bütçesi oluşturmadan önce bu sayfanın ilerleyen kısımlarında yer alan harcama sınırı bütçeleriyle ilgili önemli bilgileri inceleyin.

Tüm Firebase projeleri aslında arka planda Google Cloud projeleridir. Bu nedenle, faturalandırma Firebase ve Google Cloud arasında paylaşılır. Aynı projeyi hem Firebase konsolunda hem de Google Cloud konsolunda görüntüleyebilirsiniz.

Harcama sınırı bütçelerine genel bakış

Harcama sınırı bütçesi oluşturmadan önce bu bölümdeki bilgileri inceleyin. Bu bölümde, uygun hizmetlerin ve olası harcama sınırı durumlarının listesi yer alır. Ayrıca bu sayfanın ilerleyen kısımlarında yer alan harcama sınırı bütçelerinin sınırlamaları bölümünü incelemenizi öneririz.

Google Cloud belgelerinde harcama sınırı bütçeleriyle ilgili SSS listesini de bulabilirsiniz.

Uygun hizmetler

Harcama sınırı bütçeleri aşağıdaki Firebase hizmetleri için ayarlanabilir:

• Firebase AI Logic: Gemini Developer API veya Agent Platform Gemini API (formerly Vertex AI) erişimine sınır koyun.
• Firebase App Hosting: Temel Cloud Run hizmetinde sınırları ayarlayın.
• Cloud Functions for Firebase: Temel Cloud Run işlevleri hizmetinde sınırları belirleyin.
• Firebase Extensions: Temel Cloud Run işlevleri hizmetinde sınırları belirleyin.

Harcama sınırı bütçeleri için uygun hizmetler listesine yeni hizmetler eklemek için çalışıyoruz. Bu nedenle, listeyi düzenli olarak kontrol edin.

Not: Yukarıdaki temel hizmetlerden biri için harcama sınırı bütçesi belirlediğinizde bu bütçe, proje düzeyinde ve projenizdeki hizmetle etkileşim kurabileceğiniz tüm yöntemler için geçerli olur. Örneğin, Agent Platform Gemini API (formerly Vertex AI) için bir bütçe belirlerseniz bu bütçe, projedeki ilgili API'nin Firebase SQL Connect, ADK, Genkit vb. üzerinden yapılan tüm kullanımları için de geçerli olur (yalnızca Firebase AI Logic üzerinden yapılan kullanımlar için geçerli olmaz).

Harcama sınırı durumları

Harcama sınırı aşağıdaki durumlardan birinde olabilir:

• Yapılandırıldı: Cloud Billing, harcama sınırı bütçenize göre projenizin belirli bir hizmet için harcamasını etkin bir şekilde izliyor.

• Uygulandı: Projenizin harcaması, ilgili hizmet için belirlediğiniz aylık bütçenin %100'üne ulaştı. Bu nedenle Cloud Billing, harcama sınırını uyguladı. Uygulanan harcama sınırı açıkça kaldırılmadığı sürece, ayın geri kalanında hizmetin yeni kullanımları duraklatılır.

• Kaldırıldı: Cloud Billing, harcama sınırını uygulamıştı (ve geçerli hizmetin yeni kullanımlarını duraklatmıştı) ancak uygulanan harcama sınırı, hizmeti devam ettirmek için açıkça kaldırıldı.

  Kaldırıldı durumundayken hizmet, sınırı yeniden yapılandırmadığınız veya artırmadığınız sürece ayın geri kalanında harcama sınırı olmadan çalışır. Bir sonraki ayın başında, orijinal harcama sınırı bütçesi otomatik olarak yeniden etkinleştirilir.

Not: Herhangi bir harcama sınırı yapılandırmasını değiştirmek (Google Cloud konsolunda bütçeyi yeniden adlandırmak bile) harcama sınırını tekrar Yapılandırıldı durumuna geçirir. Aylık harcamanız bütçe eşiğine ulaştıysa veya bu eşiği aştıysa sınır hemen tetiklenir ve uygulanır.

Uygulanan bir harcama sınırını kaldırmazsanız hizmet yalnızca geçerli ay için duraklatılır. Ardından, bir sonraki ayın başında, uygulanan harcama sınırı otomatik olarak sıfırlanır ve hizmet devam eder.

Harcama sınırlarını ayarlama ve yönetme

Not: Harcama sınırı bütçesi oluşturmadan önce bu sayfanın önceki kısımlarında yer alan harcama sınırı bütçelerine genel bakış bölümünü inceleyin.

1. Harcama sınırı bütçesi yapılandırın.
   Harcama sınırı bütçesi yapılandırarak Cloud Billing hizmetinin projenizin belirli bir hizmet için yaptığı harcamaları etkin bir şekilde izlemeye başlamasını sağlayın.

2. Uyarıları ve harcama sınırı yaptırımını anlama
   Projenizin harcaması, ilgili hizmet için aylık bütçenizin belirli eşiklerine ulaşırsa Cloud Billing uyarı e-postaları gönderir ve harcama sınırını uygular. Yaptırım, ilgili hizmetin yeni kullanımlarının ayın geri kalanında duraklatılması anlamına gelir.

3. İsteğe bağlı olarak, uygulanan harcama sınırını kaldırın (veya bütçesini artırın).
   Duraklatılan bir hizmetin kullanımına o ay içinde devam etmek istiyorsanız (sınırsız veya daha yüksek bir bütçeyle) uygulanan harcama sınırını açıkça kaldırmanız gerekir.

Gerekli izinler

Harcama sınırı bütçesi oluşturmak ve yönetmek için projeye ve projenin bağlı olduğu Cloud Billing hesabına yönetici düzeyinde erişiminizin olması gerekir. Aşağıdaki seçeneklerden herhangi biri, gerekli izinleri verir:

• 1. seçenek: Projeye bağlı Cloud Billing hesabında Faturalandırma Hesabı Yöneticisi rolü

• 2. seçenek: Harcama sınırı bütçelerini yapılandırmak istediğiniz projede proje sahibi rolü

• 3. seçenek: Cloud Billing hesabı ve proje düzeyinde IAM rollerinin aşağıdaki kombinasyonu:

  • Projeye bağlı Cloud Billing hesabında Faturalandırma Hesabı Maliyetler Yöneticisi rolü

    ve

  • Harcama sınırı bütçelerini yapılandırmak istediğiniz projede Proje Düzenleyici rolü

Harcama sınırı bütçesi yapılandırma

Cloud Billing aracının bir hizmet için harcamalarınızı etkin bir şekilde izlemeye başlaması için ilgili hizmete yönelik bir harcama sınırı bütçesi yapılandırmanız gerekir. Projeniz ilgili hizmet için belirli harcama eşiklerine ulaşırsa Cloud Billing, uyarı e-postaları gönderir ve harcama sınırını uygular.

Firebase konsolunu kullanarak harcama sınırı bütçelerini nasıl yapılandıracağınız aşağıda açıklanmıştır:

1. Firebase konsolunda projenize erişin, ardından Ayarlar > Kullanım ve faturalandırma > Ayrıntılar ve ayarlar sayfasına gidin.

2. Hizmet düzeyinde harcama sınırları kartına gidin.

3. Sınırlandırmak istediğiniz hizmeti bulun, aylık bütçe tutarınızı belirleyin ve ardından Yapılandır'ı tıklayın.

   • Harcama sınırı bütçesi, tek bir proje ve bu projedeki tek bir uygun hizmetle sınırlıdır.

   • Harcama sınırı bütçesinin zaman aralığı aylıktır ve her ayın ilk günü başlar.

Dikkat: Harcama sınırı bütçeleri "kesin sınırlar" değildir. Kullanım raporlamasındaki gecikme nedeniyle harcama sınırı yaptırımı anında uygulanmaz. Bu gecikme süresinde tahakkuk eden maliyet fazlalıkları normal şekilde faturalandırılır. Bütçenizi mutlak sınırınızın biraz altında belirlemeyi düşünebilirsiniz.

Google Cloud konsolunu kullanarak harcama sınırı bütçelerini de yapılandırabileceğinizi unutmayın.

Uyarı e-postaları ve harcama sınırı yaptırımı

Harcama sınırı bütçesi yapılandırdıktan sonra Cloud Billing, projenizin ilgili hizmet için yaptığı harcamaları etkin bir şekilde izler. Bu hizmetin harcama sınırı bütçesi için aşağıdaki harcama eşiklerine göre uyarı e-postaları gönderir ve harcama sınırını uygular.

• Belirlenen bütçenin %50'si ve %80'i:

  • Cloud Billing, tüm faturalandırma yöneticilerine, proje sahiplerine ve geçerli "temel iletişim kişilerine" uyarı e-postaları gönderir.

• Belirlenen bütçenin %100'ü:

  • Cloud Billing, harcama sınırını uygular. Bu, siz uygulanan harcama sınırını açıkça kaldırmadığınız sürece, geçerli hizmet için yeni kullanımların ayın geri kalanında duraklatılacağı anlamına gelir.

  • Cloud Billing başka bir uyarı e-postası gönderir. Ayrıca, Firebase konsolu ve Google Cloud konsolunda harcama sınırı yaptırımı ve duraklatılan hizmetle ilgili banner bildirimleri gösterilir.

İstemci tarafı etkisi ve hata işleme

Bir hizmet, uygulanan harcama sınırı nedeniyle duraklatıldığında istemci tarafı uygulamanız bu hizmet için hata vermeye başlar. Bu istisnaları uygulama kodunuzda düzgün bir şekilde işlemeniz gerekir (ör. try-catch bloklarını kullanarak).

Uygulanan harcama sınırını kaldırma

Harcama sınırı tetiklenir ve uygulanırsa geçerli hizmet için tüm yeni kullanımlar, siz uygulanan harcama sınırını açıkça kaldırmadığınız sürece ayın geri kalanında duraklatılır.

Firebase konsolunu kullanarak uygulanan harcama sınırını şu şekilde kaldırabilirsiniz:

1. Firebase konsolunda projenize erişin, ardından Ayarlar > Kullanım ve faturalandırma > Ayrıntılar ve ayarlar sayfasına gidin.

2. Hizmet düzeyinde harcama sınırları kartına gidin.

3. Harcama sınırının uygulandığı hizmeti bulun ve Kaldır'ı tıklayın.

Harcama sınırını kaldırmak için aşağıdakilere dikkat edin:

• Hizmetin devam ettirilmesinde olası gecikme: Bazı hizmetlerin, zorunlu harcama sınırını kaldırdıktan sonra tamamen devam ettirilmesi bir saati bulabilir.
• Ayın geri kalanı için sınır yok: Uygulanan bir harcama sınırını kaldırır ve başka bir değişiklik yapmazsanız hizmet, o ayın geri kalanında harcama sınırı olmadan çalışır. Bir sonraki ayın başında harcama sınırı otomatik olarak orijinal bütçeyle Yapılandırıldı durumuna sıfırlanır ve hizmet devam eder.
• Uygulanan harcama sınırını kaldırmazsanız: Hizmet, yalnızca geçerli ay için duraklatılmış olarak kalır. Bir sonraki ayın başında harcama sınırı otomatik olarak orijinal bütçeyle Yapılandırıldı durumuna sıfırlanır ve hizmet devam eder.

Google Cloud konsolunu kullanarak zorunlu harcama sınırlarını kaldırabileceğinizi de unutmayın.

Yaptırımdan sonra harcama sınırını artırma

Harcama sınırınız uygulanıyorsa ve ayın geri kalanında hizmeti daha yüksek bir bütçeyle (ör. sınırınızı 10 TL'den 20 TL'ye yükselterek) devam ettirmek istiyorsanız sınır Uygulandı durumundayken bütçe tutarını düzenleyemezsiniz. Daha yüksek bir sınır belirlemeden önce sınırı kaldırmanız gerekir.

Bir hizmeti devam ettirmek ve harcama sınırını artırmak için aşağıdaki adımları uygulayın:

1. Harcama sınırını kaldırma: Firebase konsolunda veya Google Cloud konsolunda, yaptırım uygulanan hizmeti bulun ve Kaldır'ı tıklayın.

   Yaptırım kaldırılırken harcama sınırı bekleme durumuna geçer.

2. Kaldırma işleminin tamamlanmasını bekleyin: Birkaç dakika bekleyin ve harcama sınırı durumu Kaldırıldı olarak gösterilene kadar sayfayı yenileyin.

   Hizmet devam eder. Hizmete bağlı olarak bu işlem bir saati bulabilir.

3. Bütçe tutarını güncelleme: Yeni ve daha yüksek aylık bütçe tutarınızı girerek harcama sınırı bütçesini düzenleyin. Yaptığınız değişiklikleri kaydedin.

Sınırı artırırken dikkat edilmesi gereken önemli noktalar:

• Mevcut ayın toplam harcamasına bağlı: Yeni bütçe tutarı, mevcut ay için toplam harcamanıza bağlı kalmaya devam eder. Sınır uygulanmadan önce raporlama gecikmeleri sırasında ortaya çıkan maliyet fazlalıkları da buna dahildir.

• Mevcut ayın harcamasından daha yüksek bir bütçe belirleyin: Yeni bütçenizin bu ay harcadığınız tutardan (fazla harcamalar dahil) daha yüksek olduğundan emin olun. Aksi takdirde sınır tetiklenir ve hizmet hemen tekrar duraklatılır.

• Kalan bütçe hesaplaması: Ay için kalan bütçeniz, yeni eşik tutarından şu ana kadarki toplam harcamanızın çıkarılmasıyla hesaplanır. Örneğin:

  1. Cloud Functions for Firebase tarihinde 10 ABD doları tutarında bir harcama sınırı belirlediniz.

  2. Harcamanız 10 ABD dolarına ulaşır (raporlama gecikmesi sırasında 1 ABD doları tutarında bir aşım gerçekleşir ve toplam harcama 11 ABD doları olur). Sınır uygulanır ve işlevleriniz duraklatılır.

  3. Trafiğin meşru olduğunu onayladığınız için sınırı kaldırır ve durumun Kaldırıldı olarak gösterilmesini beklersiniz.

  4. Harcama sınırını 20 ABD doları olarak güncellersiniz. Bu değişikliği kaydettiğinizde harcama sınırı tekrar Yapılandırıldı durumuna sıfırlanır.

  5. İşlevleriniz yeni 20 ABD doları sınırına göre çalışmaya devam eder ve ay için yaklaşık 9 ABD doları bütçe kalır (20 ABD doları sınırından tahakkuk eden 11 ABD doları çıkarılır).

  6. Sonraki ay, harcama sınırı bütçesi 20 TL eşiğini korur.

Harcama sınırı bütçelerinin sınırlamaları

Harcama sınırı bütçeleriyle ilgili olarak bilinmesi gereken önemli sınırlamalar şunlardır:

• Harcama sınırı bütçeleri "kesin sınırlar" değildir. Kullanım raporlamasındaki gecikme nedeniyle harcama sınırı yaptırımı anında uygulanmaz ve birkaç dakika gecikebilir. Bu gecikme sırasında ortaya çıkan maliyet fazlalıkları normal şekilde faturalandırılır. Bütçenizi mutlak sınırınızın biraz altında belirleyebilirsiniz.

• Proje ve hizmet kapsamlı. Harcama sınırı bütçesi, tek bir proje ve bu projedeki tek bir uygun hizmetle sınırlıdır.

  • Harcama sınırı bütçesini tüm Cloud Billing hesabı düzeyinde veya klasör, kuruluş ya da etiket düzeyinde ayarlayamazsınız.

  • Birden fazla projeyi veya birden fazla hizmeti kapsayacak tek bir harcama sınırı bütçesi belirleyemezsiniz.

  • Bir hizmet için harcama sınırı bütçesi belirlediğinizde bu bütçe, projede hizmetle etkileşim kurabileceğiniz tüm yöntemler için geçerli olur. Örneğin, Agent Platform Gemini API (formerly Vertex AI) için bir bütçe belirlerseniz bu bütçe, projedeki API'nin Firebase SQL Connect, ADK, Genkit vb. üzerinden yapılan tüm kullanımları için de geçerli olur (yalnızca Firebase AI Logic üzerinden yapılan kullanımlar için geçerli olmaz).

• Aylık zaman aralığı. Harcama sınırı bütçesinin zaman aralığı aylıktır ve her ayın ilk günü başlar.

• Hizmet her ay otomatik olarak devam eder.

  • Uygulanan bir harcama sınırını kaldırmazsanız hizmet yalnızca geçerli ay için duraklatılmış olarak kalır. Bir sonraki ayın başında, uygulanan harcama sınırı otomatik olarak orijinal bütçeyle Yapılandırıldı durumuna sıfırlanır ve hizmet devam eder.

  • Ay içinde uygulanan bir harcama sınırını kaldırır ve bütçeyi değiştirmezseniz hizmet, ayın geri kalanında harcama sınırı olmadan çalışır. Harcama sınırı, orijinal bütçeyle otomatik olarak Yapılandırıldı durumuna sıfırlanır ve hizmet devam eder.

• Tasarruflar ve krediler dahil değildir. Harcama sınırı bütçesi için maliyet hesaplamaları brüt maliyetlere dayanır ve tasarruflar ile kredileri içermez.

Daha gelişmiş bir faturalandırma ayarınız varsa Google Cloud belgelerinde harcama sınırı bütçelerinin sınırlamaları hakkında daha fazla bilgi edinebilirsiniz.