این صفحه نحوه تنظیم و مدیریت بودجههای سقف هزینه را هنگامی که پروژه Firebase شما در طرح قیمتگذاری Blaze قرار دارد، شرح میدهد.
بودجههای سقف هزینه برای سرویسهای منتخب فایربیس زیر در دسترس هستند: منطق هوش مصنوعی فایربیس ، Firebase App Hosting ، Cloud Functions for Firebase و Firebase Extensions .
پرش به دستورالعملهای پیکربندی سقف هزینه
بودجهها را درک کنید
شما میتوانید با ایجاد بودجه برای Google Cloud Billing ، هزینههای خود را کنترل کرده و از غافلگیری در صورتحساب خود جلوگیری کنید. بودجهها مبالغ پولی کلی هستند که شما قصد دارید هر ماه خرج کنید و میتوانند بودجههای فقط هشدار یا بودجههای سقف هزینه باشند.
بودجههای فقط هشدار
اگر هزینهها به آستانههای تعیینشده برای بودجه شما برسد، Cloud Billing اعلانهای ایمیلی ارسال میکند .
به موارد زیر توجه کنید:
هشدارهای بودجه، خدمات را متوقف نمیکنند . هدف آنها کمک به شما در نظارت بر هزینههایتان و هشدار دادن به شما برای اقدام در صورت نیاز است. به عنوان مثال، میتوانید از اعلانهای بودجه برای غیرفعال کردن صورتحساب پروژه استفاده کنید .
وقتی در کنسول Firebase به طرح قیمتگذاری Blaze ارتقا میدهید، بهطور خودکار از شما خواسته میشود که بودجهای فقط برای هشدارها تنظیم کنید. همچنین میتوانید بهصورت دستی بودجههایی فقط برای هشدارها را در کنسول Google Cloud تنظیم کنید .
بودجههای سقف هزینه (این صفحه)
اگر هزینهها برای یک سرویس خاص به آستانههای تعیینشده برای بودجه شما برسد، Cloud Billing اعلانهای ایمیلی ارسال میکند .
اگر هزینهها به ۱۰۰٪ بودجه شما برای آن سرویس برسد، Cloud Billing آن سرویس را برای بقیه ماه متوقف میکند .
به موارد زیر توجه کنید:
بودجههای مربوط به سقف هزینه فقط برای سرویسهای فایربیس زیر در دسترس هستند: منطق هوش مصنوعی فایربیس ، Firebase App Hosting ، Cloud Functions for Firebase و Firebase Extensions .
شما میتوانید به صورت دستی سقف بودجه را در کنسول Firebase (همانطور که در این صفحه توضیح داده شده است) یا در کنسول Google Cloud تنظیم کنید.
- قبل از تنظیم بودجه سقف هزینه، اطلاعات مهم در مورد بودجههای سقف هزینه را که بعداً در این صفحه آمده است، مرور کنید.
مروری بر بودجههای سقف هزینه
قبل از تنظیم بودجه سقف هزینه، اطلاعات موجود در این بخش را که شامل لیست خدمات واجد شرایط و ایالتهای احتمالی سقف هزینه است، بررسی کنید. همچنین توصیه میکنیم محدودیتهای بودجههای سقف هزینه را بعداً در این صفحه بررسی کنید.
همچنین میتوانید فهرستی از سوالات متداول در مورد بودجههای سقف هزینه را در مستندات Google Cloud پیدا کنید.
خدمات واجد شرایط
بودجههای مربوط به سقف هزینه را میتوان برای سرویسهای فایربیس زیر تنظیم کرد:
- منطق هوش مصنوعی فایربیس : برای دسترسی به Gemini Developer API یا Agent Platform Gemini API (که قبلاً Vertex AI نام داشت) محدودیت تعیین کنید.
- Firebase App Hosting : محدودیتهایی را برای سرویس Cloud Run تعیین کنید.
- Cloud Functions for Firebase : محدودیتهایی را برای سرویس توابع ابری اصلی تعیین کنید.
- Firebase Extensions : محدودیتهایی را برای سرویس توابع Cloud Run تعیین کنید.
ما در تلاشیم تا خدمات واجد شرایط برای بودجههای سقف هزینه را به این لیست اضافه کنیم، بنابراین مرتباً این لیست را بررسی کنید.
ایالتهای دارای سقف هزینه
سقف هزینه میتواند در یکی از حالتهای زیر باشد:
پیکربندیشده : Cloud Billing بهطور فعال هزینههای پروژه شما را برای یک سرویس خاص بر اساس بودجهی سقف هزینهی شما رصد میکند.
اجباری : هزینههای پروژه شما به ۱۰۰٪ بودجه ماهانه تعیینشده برای آن سرویس رسیده است، بنابراین Cloud Billing سقف هزینه را اعمال کرده است. هرگونه استفاده جدید از سرویس برای بقیه ماه متوقف میشود، مگر اینکه سقف هزینه اجباری صراحتاً برداشته شود.
لغو شد : Cloud Billing محدودیت هزینه را اعمال کرده بود (و هرگونه استفاده جدید از سرویس مربوطه را متوقف کرده بود)، اما محدودیت هزینه اجباری به صراحت لغو شد تا سرویس از سر گرفته شود.
در حالت «افزایش یافته» ، سرویس بدون محدودیت هزینه برای بقیه ماه اجرا میشود، مگر اینکه سقف هزینه را دوباره پیکربندی یا افزایش دهید. در شروع ماه بعد، بودجه سقف هزینه اصلی به طور خودکار دوباره فعال میشود.
اگر سقف هزینه اجباری را لغو نکنید ، سرویس فقط برای ماه جاری متوقف خواهد ماند. سپس، در ابتدای ماه بعد، سقف هزینه اجباری به طور خودکار تنظیم مجدد میشود و سرویس از سر گرفته میشود.
تنظیم و مدیریت سقف هزینهها
بودجهای برای سقف هزینهها تنظیم کنید.
یک سقف بودجه برای هزینهها تنظیم کنید تا Cloud Billing بتواند به طور فعال هزینههای پروژه شما را برای یک سرویس خاص رصد کند.هشدارها را درک کنید و محدودیت هزینه را اعمال کنید.
اگر هزینههای پروژه شما به آستانههای مشخصی از بودجه ماهانه شما برای آن سرویس برسد، Cloud Billing ایمیلهای هشدار ارسال میکند و سقف هزینه را اعمال میکند. اعمال محدودیت به این معنی است که هرگونه استفاده جدید از آن سرویس برای بقیه آن ماه متوقف میشود.در صورت تمایل، سقف هزینه اجباری را بردارید (یا بودجه آن را افزایش دهید).
اگر میخواهید استفاده از سرویسی که در آن ماه متوقف شده است را از سر بگیرید (چه بدون محدودیت و چه با بودجه بالاتر)، باید صریحاً سقف هزینه اجباری را افزایش دهید.
مجوزهای مورد نیاز
برای تنظیم و مدیریت بودجهی سقف هزینه، به دسترسی سطح ادمین به پروژه و حساب Cloud Billing مرتبط با آن نیاز دارید. هر یک از گزینههای زیر مجوزهای لازم را به شما میدهد:
گزینه ۱ : نقش مدیر حساب صورتحساب در حساب Cloud Billing متصل به پروژه
گزینه ۲ : نقش مالک پروژه در پروژهای که میخواهید بودجههای مربوط به سقف هزینه را پیکربندی کنید
گزینه ۳ : ترکیب زیر از نقشهای حساب Cloud Billing و مدیریت دسترسی به اطلاعات (IAM) در سطح پروژه:
نقش مدیر هزینههای حساب صورتحساب در حساب Cloud Billing مرتبط با پروژه
و
نقش ویرایشگر پروژه در پروژهای که میخواهید بودجههای مربوط به سقف هزینه را در آن پیکربندی کنید
پیکربندی بودجه سقف هزینه
برای اینکه Cloud Billing به طور فعال شروع به نظارت بر هزینههای شما برای یک سرویس کند، باید یک بودجه برای سقف هزینه برای آن سرویس پیکربندی کنید . اگر پروژه شما به آستانههای هزینه خاصی برای آن سرویس برسد، Cloud Billing ایمیلهای هشدار ارسال کرده و سقف هزینه را اعمال میکند .
در اینجا نحوه پیکربندی بودجههای سقف هزینه با استفاده از کنسول Firebase آورده شده است:
به پروژه خود در کنسول Firebase دسترسی پیدا کنید، سپس به
> استفاده و صورتحساب > صفحه جزئیات و تنظیمات . به کارت محدودیتهای هزینه سطح سرویس بروید.
سرویسی را که میخواهید محدودیت ایجاد کنید، پیدا کنید، مبلغ بودجه ماهانه خود را تنظیم کنید و سپس روی پیکربندی کلیک کنید.
بودجهی سقف هزینه به یک پروژهی واحد و یک سرویس واجد شرایط واحد در آن پروژه محدود میشود.
محدوده زمانی برای بودجه سقف هزینه، ماهانه است و از روز اول هر ماه شروع میشود.
توجه داشته باشید که میتوانید بودجههای مربوط به سقف هزینه را با استفاده از کنسول Google Cloud نیز پیکربندی کنید .
ایمیلهای هشدار و اعمال محدودیت هزینه
پس از پیکربندی بودجهی سقف هزینه، Cloud Billing به طور فعال هزینههای پروژهی شما را برای آن سرویس رصد میکند. این سرویس ایمیلهای هشدار ارسال میکند و سقف هزینه را بر اساس آستانههای هزینهی زیر برای بودجهی سقف هزینهی آن سرویس اعمال میکند .
۵۰٪ و ۸۰٪ از بودجه تعیین شده:
- Cloud Billing ایمیلهای هشدار دهنده را برای همه مدیران صورتحساب، صاحبان پروژه و هر "شخص ضروری" مربوطه ارسال میکند.
۱۰۰٪ بودجه تعیین شده:
Cloud Billing سقف هزینه را اعمال میکند ، به این معنی که هرگونه استفاده جدید برای سرویس مربوطه برای بقیه ماه متوقف میشود، مگر اینکه صریحاً سقف هزینه اجباری را بردارید .
Cloud Billing یک ایمیل هشدار دیگر ارسال میکند . همچنین، کنسول Firebase و کنسول Google Cloud اعلانهای بنری در مورد اجرای محدودیت هزینه و توقف سرویس نمایش میدهند.
تأثیر سمت کلاینت و مدیریت خطا
وقتی یک سرویس به دلیل محدودیت هزینه اجباری متوقف میشود، برنامه سمت کلاینت شما شروع به ارسال خطا برای آن سرویس میکند. شما باید این استثنائات را به طور مناسب در کد برنامه خود مدیریت کنید (برای مثال، با استفاده از بلوکهای try-catch ).
سقف هزینه اجباری را بردارید
اگر سقف هزینه فعال و اعمال شود، تمام استفادههای جدید برای سرویس مربوطه برای بقیه ماه متوقف میشود، مگر اینکه صریحاً سقف هزینه اجباری را بردارید .
در اینجا نحوه برداشتن سقف هزینه اجباری با استفاده از کنسول Firebase آورده شده است:
به پروژه خود در کنسول Firebase دسترسی پیدا کنید، سپس به
> استفاده و صورتحساب > صفحه جزئیات و تنظیمات . به کارت محدودیتهای هزینه سطح سرویس بروید.
سرویسی را که سقف هزینه اجباری دارد پیدا کنید و سپس روی «افزایش» کلیک کنید.
توجه داشته باشید که میتوانید با استفاده از کنسول Google Cloud سقفهای هزینه اجباری را نیز بردارید .
افزایش سقف هزینه پس از اجرا
اگر سقف هزینه شما اعمال شده است و میخواهید سرویس را با بودجه بالاتری برای بقیه ماه از سر بگیرید (مثلاً افزایش سقف از 10 دلار به 20 دلار)، تا زمانی که سقف در حالت اعمال شده است، نمیتوانید مبلغ بودجه را ویرایش کنید . قبل از تنظیم سقف بالاتر، ابتدا باید سقف را بردارید.
در اینجا نحوه از سرگیری یک سرویس و افزایش سقف هزینه آن آورده شده است:
افزایش سقف هزینه: در کنسول Firebase یا کنسول Google Cloud ، سرویس اجباری را پیدا کنید و سپس روی افزایش سقف هزینه کلیک کنید.
سقف هزینه تا زمان لغو اجرای قانون، وارد حالت تعلیق خواهد شد.
منتظر بمانید تا افزایش موجودی کامل شود: چند دقیقه صبر کنید و صفحه را رفرش کنید تا وضعیت سقف هزینه، «افزایشیافته» (Lefted) را نشان دهد.
سرویس از سر گرفته خواهد شد. بسته به سرویس، این میتواند تا یک ساعت طول بکشد.
بهروزرسانی مبلغ بودجه: با وارد کردن مبلغ بودجه ماهانه جدید و بالاتر، بودجه سقف هزینه را ویرایش کنید. تغییرات خود را ذخیره کنید.
نکات مهم هنگام افزایش سقف تعهدات:
وابسته به کل هزینههای ماه جاری: مبلغ بودجه جدید همچنان به کل هزینههای انباشته شما برای ماه جاری، شامل هرگونه اضافه هزینهای که در طول تأخیر در گزارشدهی قبل از اعمال محدودیت ایجاد شده است، وابسته است.
بودجهای بالاتر از هزینه ماه جاری تعیین کنید: مطمئن شوید که بودجه جدید شما بالاتر از هزینهای است که قبلاً در این ماه انجام دادهاید (شامل هزینههای اضافی). در غیر این صورت، محدودیت بلافاصله فعال شده و سرویس دوباره متوقف میشود.
محاسبه بودجه باقیمانده: بودجه باقیمانده شما برای ماه برابر است با مبلغ آستانه جدید منهای کل هزینه شما تاکنون. برای مثال:
شما Cloud Functions for Firebase سقف هزینه 10 دلار تعیین کردهاید.
هزینه شما به 10 دلار میرسد (بهعلاوه 1 دلار اضافی در طول تأخیر گزارشدهی، که در مجموع 11 دلار میشود). سقف تعیینشده اعمال میشود و عملکردهای شما متوقف میشود.
شما تأیید میکنید که ترافیک قانونی است، بنابراین محدودیت را برمیدارید و منتظر میمانید تا وضعیت «Lifted» را نشان دهد.
شما سقف هزینه را به 20 دلار تغییر میدهید. وقتی این تغییر را ذخیره میکنید، سقف هزینه به حالت پیکربندیشده (Configured) برمیگردد.
توابع شما همچنان با سقف جدید ۲۰ دلار اجرا میشوند و تقریباً ۹ دلار از بودجه ماه باقی مانده است (۲۰ دلار سقف منهای ۱۱ دلار از قبل انباشته شده).
ماه آینده، سقف بودجهی هزینهها روی آستانهی ۲۰ دلار باقی خواهد ماند.
محدودیتهای بودجههای سقف هزینه
محدودیتهای مهمی که باید در مورد بودجهبندی سقف هزینهها بدانید، عبارتند از:
بودجههای مربوط به سقف هزینه، «سقفهای قطعی» نیستند . به دلیل تأخیر در گزارش میزان مصرف، اعمال سقف هزینه آنی نیست و میتواند چند دقیقه به تأخیر بیفتد. هرگونه اضافه هزینهای که در طول این تأخیر ایجاد شود، به صورت عادی محاسبه خواهد شد. در نظر داشته باشید که بودجه خود را کمی پایینتر از حد مطلق خود تنظیم کنید.
محدوده پروژه و خدمات. بودجه سقف هزینه به یک پروژه واحد و یک سرویس واجد شرایط واحد در آن پروژه محدود میشود.
شما نمیتوانید در کل سطح حساب Cloud Billing یا در سطح پوشه، سازمان یا برچسب، سقف بودجه تعیین کنید.
شما نمیتوانید یک بودجهی واحد برای سقف هزینه تعیین کنید که چندین پروژه یا چندین سرویس را پوشش دهد.
وقتی برای یک سرویس، سقف بودجه تعیین میکنید، این سقف بودجه برای هر روشی که ممکن است با سرویس در پروژه تعامل داشته باشید، اعمال میشود. برای مثال، اگر برای API پلتفرم Agent Gemini (که قبلاً Vertex AI نام داشت) بودجه تعیین کنید، این سقف بودجه برای هر گونه استفاده از آن API در پروژه از طریق Firebase SQL Connect ، ADK، Genkit و غیره نیز اعمال میشود (نه فقط استفاده از طریق Firebase AI Logic ).
محدوده زمانی ماهانه. محدوده زمانی بودجه سقف هزینه، ماهانه است و از روز اول هر ماه شروع میشود.
سرویس هر ماه به طور خودکار از سر گرفته میشود.
اگر سقف هزینه اجباری را لغو نکنید ، سرویس فقط برای ماه جاری متوقف خواهد ماند. در ابتدای ماه بعد، سقف هزینه اجباری به طور خودکار با بودجه اولیه به حالت پیکربندی شده (Configured) بازنشانی میشود و سرویس از سر گرفته میشود.
اگر در طول ماه، سقف هزینه اجباری را بردارید و بودجه را تغییر ندهید ، سرویس برای بقیه آن ماه بدون محدودیت هزینه اجرا میشود و سقف هزینه به طور خودکار با بودجه اولیه به حالت پیکربندی شده (Configured) بازنشانی میشود و سرویس از سر گرفته میشود.
شامل پسانداز و اعتبار نمیشود. محاسبات هزینه برای بودجه سقف هزینه بر اساس هزینههای ناخالص است و شامل پسانداز و اعتبار نمیشود .
اگر تنظیمات صورتحساب پیشرفتهتری دارید، میتوانید جزئیات بیشتری در مورد محدودیتهای بودجهی سقف هزینه را در مستندات Google Cloud بیابید.