تعیین سقف هزینه برای سرویس‌های فایربیس


این صفحه نحوه تنظیم و مدیریت بودجه‌های سقف هزینه را هنگامی که پروژه 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 محدودیت هزینه را اعمال کرده بود (و هرگونه استفاده جدید از سرویس مربوطه را متوقف کرده بود)، اما محدودیت هزینه اجباری به صراحت لغو شد تا سرویس از سر گرفته شود.

تنظیم و مدیریت سقف هزینه‌ها

  1. بودجه‌ای برای سقف هزینه‌ها تعیین کنید.
    یک سقف بودجه برای هزینه‌ها تنظیم کنید تا Cloud Billing بتواند به طور فعال هزینه‌های پروژه شما را برای یک سرویس خاص رصد کند.

  2. هشدارها را درک کنید و محدودیت هزینه را اعمال کنید.
    اگر هزینه‌های پروژه شما به آستانه‌های مشخصی از بودجه ماهانه شما برای آن سرویس برسد، Cloud Billing ایمیل‌های هشدار ارسال می‌کند و سقف هزینه را اعمال می‌کند. اعمال محدودیت به این معنی است که هرگونه استفاده جدید از آن سرویس برای بقیه آن ماه متوقف می‌شود.

  3. به صورت اختیاری، سقف هزینه اجباری را بردارید.
    اگر می‌خواهید استفاده از یک سرویس متوقف‌شده در آن ماه را از سر بگیرید، باید صریحاً سقف هزینه اجباری را افزایش دهید.

مجوزهای مورد نیاز

برای تنظیم و مدیریت بودجه‌ی سقف هزینه، به دسترسی سطح ادمین به پروژه و حساب Cloud Billing مرتبط با آن نیاز دارید. هر یک از گزینه‌های زیر مجوزهای لازم را به شما می‌دهد:

پیکربندی بودجه سقف هزینه

برای اینکه Cloud Billing به طور فعال شروع به نظارت بر هزینه‌های شما برای یک سرویس کند، باید یک بودجه برای سقف هزینه برای آن سرویس پیکربندی کنید . اگر پروژه شما به آستانه‌های هزینه خاصی برای آن سرویس برسد، Cloud Billing ایمیل‌های هشدار ارسال کرده و سقف هزینه را اعمال می‌کند .

در اینجا نحوه پیکربندی بودجه‌های سقف هزینه با استفاده از کنسول Firebase آورده شده است:

  1. به پروژه خود در کنسول Firebase دسترسی پیدا کنید، سپس به > استفاده و صورتحساب > صفحه جزئیات و تنظیمات .

  2. به کارت محدودیت‌های هزینه سطح سرویس بروید.

  3. سرویسی را که می‌خواهید محدودیت ایجاد کنید، پیدا کنید، مبلغ بودجه ماهانه خود را تنظیم کنید و سپس روی پیکربندی کلیک کنید.

    • بودجه‌ی سقف هزینه به یک پروژه‌ی واحد و یک سرویس واجد شرایط واحد در آن پروژه محدود می‌شود.

    • محدوده زمانی برای بودجه سقف هزینه، ماهانه است و از روز اول هر ماه شروع می‌شود.

توجه داشته باشید که می‌توانید بودجه‌های مربوط به سقف هزینه را با استفاده از کنسول Google Cloud نیز پیکربندی کنید .

ایمیل‌های هشدار و اعمال محدودیت هزینه

پس از پیکربندی بودجه‌ی سقف هزینه، Cloud Billing به طور فعال هزینه‌های پروژه‌ی شما را برای آن سرویس رصد می‌کند. این سرویس ایمیل‌های هشدار ارسال می‌کند و سقف هزینه را بر اساس آستانه‌های هزینه‌ی زیر برای بودجه‌ی سقف هزینه‌ی آن سرویس اعمال می‌کند .

  • ۵۰٪ و ۸۰٪ از بودجه تعیین شده:

    • Cloud Billing ایمیل‌های هشدار دهنده را برای همه مدیران صورتحساب، صاحبان پروژه و هر "شخص ضروری" مربوطه ارسال می‌کند.
  • ۱۰۰٪ بودجه تعیین شده:

    • Cloud Billing سقف هزینه را اعمال می‌کند ، به این معنی که هرگونه استفاده جدید برای سرویس مربوطه برای بقیه ماه متوقف می‌شود، مگر اینکه صریحاً سقف هزینه اجباری را بردارید .

    • Cloud Billing یک ایمیل هشدار دیگر ارسال می‌کند . همچنین، کنسول Firebase و کنسول Google Cloud اعلان‌های بنری در مورد اجرای محدودیت هزینه و توقف سرویس نمایش می‌دهند.

تأثیر سمت کلاینت و مدیریت خطا

وقتی یک سرویس به دلیل محدودیت هزینه اجباری متوقف می‌شود، برنامه سمت کلاینت شما شروع به ارسال خطا برای آن سرویس می‌کند. شما باید این استثنائات را به طور مناسب در کد برنامه خود مدیریت کنید (برای مثال، با استفاده از بلوک‌های try-catch ).

سقف هزینه اجباری را بردارید

اگر سقف هزینه فعال و اعمال شود، تمام استفاده‌های جدید برای سرویس مربوطه برای بقیه ماه متوقف می‌شود، مگر اینکه صریحاً سقف هزینه اجباری را بردارید .

در اینجا نحوه برداشتن سقف هزینه اجباری با استفاده از کنسول Firebase آورده شده است:

  1. به پروژه خود در کنسول Firebase دسترسی پیدا کنید، سپس به > استفاده و صورتحساب > صفحه جزئیات و تنظیمات .

  2. به کارت محدودیت‌های هزینه سطح سرویس بروید.

  3. سرویسی را که سقف هزینه اجباری دارد پیدا کنید و سپس روی «افزایش» کلیک کنید.

توجه داشته باشید که می‌توانید با استفاده از کنسول Google Cloud سقف‌های هزینه اجباری را نیز بردارید .

محدودیت‌های بودجه‌های سقف هزینه

محدودیت‌های مهمی که باید در مورد بودجه‌بندی سقف هزینه‌ها بدانید، عبارتند از:

  • بودجه‌های مربوط به سقف هزینه، «سقف‌های قطعی» نیستند . به دلیل تأخیر در گزارش میزان مصرف، اعمال سقف هزینه آنی نیست و می‌تواند چند دقیقه به تأخیر بیفتد. هرگونه اضافه هزینه‌ای که در طول این تأخیر ایجاد شود، به صورت عادی محاسبه خواهد شد. در نظر داشته باشید که بودجه خود را کمی پایین‌تر از حد مطلق خود تنظیم کنید.

  • محدوده پروژه و خدمات. بودجه سقف هزینه به یک پروژه واحد و یک سرویس واجد شرایط واحد در آن پروژه محدود می‌شود.

    • شما نمی‌توانید در کل سطح حساب Cloud Billing یا در سطح پوشه، سازمان یا برچسب، سقف بودجه تعیین کنید.

    • شما نمی‌توانید یک بودجه‌ی واحد برای سقف هزینه تعیین کنید که چندین پروژه یا چندین سرویس را پوشش دهد.

    • وقتی برای یک سرویس، سقف بودجه تعیین می‌کنید، این سقف بودجه برای هر روشی که ممکن است با سرویس در پروژه تعامل داشته باشید، اعمال می‌شود. برای مثال، اگر برای API پلتفرم Agent Gemini (که قبلاً Vertex AI نام داشت) بودجه تعیین کنید، این سقف بودجه برای هر گونه استفاده از آن API در پروژه از طریق Firebase SQL Connect ، ADK، Genkit و غیره نیز اعمال می‌شود (نه فقط استفاده از طریق Firebase AI Logic ).

  • محدوده زمانی ماهانه. محدوده زمانی بودجه سقف هزینه، ماهانه است و از روز اول هر ماه شروع می‌شود.

  • سرویس به طور پیش‌فرض هر ماه از سر گرفته می‌شود. اگر سقف هزینه اجباری را لغو نکنید ، سرویس فقط برای ماه جاری متوقف خواهد ماند.

    • به طور پیش‌فرض، در ابتدای ماه بعد، سقف هزینه اجباری به طور خودکار برداشته می‌شود و سرویس از سر گرفته می‌شود.

    • با این حال، می‌توانید تنظیمات بودجه‌ی سقف هزینه را طوری تنظیم کنید که سقف هزینه به طور نامحدود و تا زمانی که صریحاً سقف هزینه‌ی اجباری را لغو نکنید، به قوت خود باقی بماند (و سرویس متوقف بماند).

    به طور پیش‌فرض، اگر سقف هزینه اجباری را لغو نکنید ، سرویس برای ماه جاری متوقف می‌ماند، اما به طور خودکار در ابتدای ماه بعد از سر گرفته می‌شود. با این حال، می‌توانید تنظیمات بودجه سقف هزینه را طوری تنظیم کنید که سقف هزینه به طور نامحدود تا زمانی که صریحاً سقف هزینه اجباری را لغو کنید، همچنان اجباری باقی بماند (و سرویس نیز متوقف بماند).

  • شامل پس‌انداز و اعتبار نمی‌شود. محاسبات هزینه برای بودجه سقف هزینه بر اساس هزینه‌های ناخالص است و شامل پس‌انداز و اعتبار نمی‌شود .

اگر تنظیمات صورتحساب پیشرفته‌تری دارید، می‌توانید جزئیات بیشتری در مورد محدودیت‌های بودجه‌ی سقف هزینه را در مستندات Google Cloud بیابید.