إعداد حدود الإنفاق لخدمات Firebase


توضّح هذه الصفحة كيفية إعداد ميزانيات الحدّ الأقصى للإنفاق وإدارتها عندما يكون مشروع Firebase على خطة Blaze المَرِنة.

تتوفّر ميزانيات الحدّ الأقصى للإنفاق لخدمات Firebase المحدّدة التالية: Firebase AI Logic وFirebase App Hosting وCloud Functions for Firebase وFirebase Extensions.

الانتقال إلى تعليمات ضبط حد أقصى للإنفاق

فهم الميزانيات

يمكنك التحكّم في تكاليفك وتجنُّب تلقّي فواتير بمبالغ مفاجئة من خلال إنشاء ميزانيات Google Cloud Billing. الميزانيات هي مبالغ نقدية عامة تخطّط لإنفاقها كل شهر، ويمكن أن تكون ميزانيات تنبيه فقط أو ميزانيات حدّ الإنفاق.

الميزانيات التي تتضمّن تنبيهات فقط

  • إذا بلغ الإنفاق الحدود المحدّدة لميزانيتك، سيرسل Cloud Billing إشعارات عبر البريد الإلكتروني.

  • لاحظ ما يلي:

ميزانيات حدّ الإنفاق (هذه الصفحة)

  • إذا بلغ الإنفاق الحدود المحدّدة لميزانيتك لخدمة معيّنة، سترسل Cloud Billing إشعارات عبر البريد الإلكتروني.

  • إذا بلغ الإنفاق% 100 من ميزانيتك لهذه الخدمة، سيؤدي ذلك إلى Cloud Billing إيقاف هذه الخدمة مؤقتًا لبقية الشهر.

  • لاحظ ما يلي:

    • لا تتوفّر ميزانيات الحدّ الأقصى للإنفاق إلا لخدمات Firebase التالية: Firebase AI Logic وFirebase App Hosting وCloud Functions for Firebase وFirebase Extensions.

    • يمكنك إعداد ميزانيات الحد الأقصى للإنفاق يدويًا في وحدة تحكّم Firebase (كما هو موضّح في هذه الصفحة) أو في وحدة تحكّم Google Cloud.

نظرة عامة على ميزانيات حدّ الإنفاق

قبل إعداد ميزانية الحد الأقصى للإنفاق، راجِع المعلومات الواردة في هذا القسم، والتي تتضمّن قائمة بالخدمات المؤهَّلة وحالات الحد الأقصى للإنفاق المحتملة. ننصحك أيضًا بمراجعة قيود ميزانيات الحدّ الأقصى للإنفاق لاحقًا في هذه الصفحة.

يمكنك أيضًا العثور على قائمة بالأسئلة الشائعة حول ميزانيات الحدّ الأقصى للإنفاق في مستندات Google Cloud.

الخدمات المؤهَّلة

يمكن إعداد ميزانيات الحدّ الأقصى للإنفاق لخدمات Firebase التالية:

  • Firebase AI Logic: وضع قيود على الوصول إلى Gemini Developer API أو Agent Platform Gemini API (formerly Vertex AI)
  • Firebase App Hosting: تحديد حدود قصوى لخدمة Cloud Run الأساسية
  • Cloud Functions for Firebase: يمكنك ضبط حدود قصوى على خدمة دوال Cloud Run الأساسية.
  • Firebase Extensions: يمكنك ضبط حدود قصوى على خدمة دوال Cloud Run الأساسية.

نعمل على إضافة المزيد من الخدمات المؤهَّلة إلى هذه القائمة التي تتضمّن ميزانيات الحد الأقصى للإنفاق، لذا يُرجى الاطّلاع على هذه القائمة بشكل دوري.

حالات الحدّ الأقصى للإنفاق

يمكن أن تكون حدّ الإنفاق في إحدى الحالات التالية:

  • تمّ الإعداد: تراقب خدمة Cloud Billing بشكل نشط إنفاق مشروعك على خدمة معيّنة استنادًا إلى ميزانية الحدّ الأقصى للإنفاق.
  • مفروض: وصل إنفاق مشروعك إلى% 100 من ميزانيتك الشهرية المحدّدة لتلك الخدمة، لذا فرضت 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 بشكل نشط إنفاق مشروعك على هذه الخدمة. سيتم إرسال رسائل تنبيه إلكترونية وفرض الحد الأقصى للإنفاق استنادًا إلى حدود الإنفاق التالية لميزانية الحد الأقصى للإنفاق الخاصة بهذه الخدمة.

  • ‫50% و80% من الميزانية المحدّدة:

    • Cloud Billing يرسل رسائل إلكترونية تتضمّن تنبيهات تحذيرية إلى جميع مشرفي الفوترة ومالكي المشاريع و"جهات الاتصال الأساسية" المعنيّة.

  • ‫100% من الميزانية المحدّدة:

    • يفرض Cloud Billing حد الإنفاق، ما يعني أنّه سيتم إيقاف أي استخدام جديد للخدمة المعنية مؤقتًا لبقية الشهر ما لم تزِل حد الإنفاق المفروض بشكل صريح.

    • Cloud Billing إرسال رسالة إلكترونية أخرى للتنبيه بالإضافة إلى ذلك، تعرض وحدة تحكّم Firebase ووحدة تحكّم Google Cloud إشعارات بانر بشأن فرض الحد الأقصى للإنفاق وإيقاف الخدمة مؤقتًا.

التأثير من جهة العميل والتعامل مع الأخطاء

عند إيقاف خدمة مؤقتًا بسبب حد أقصى إلزامي للإنفاق، سيبدأ تطبيقك من جهة العميل في عرض أخطاء لهذه الخدمة. عليك التعامل مع هذه الاستثناءات بشكل سليم في رمز تطبيقك (على سبيل المثال، باستخدام حِزم try-catch).

إزالة حدّ أقصى مفروض للإنفاق

في حال تم تفعيل حد الإنفاق وفرضه، سيتم إيقاف جميع عمليات الاستخدام الجديدة للخدمة المعنيّة لبقية الشهر ما لم تُلغِ حد الإنفاق المفروض صراحةً.

في ما يلي كيفية إزالة الحدّ الأقصى المفروض للإنفاق باستخدام وحدة تحكّم Firebase:

  1. انتقِل إلى مشروعك في Firebase، ثم انتقِل إلى صفحة الإعدادات > الاستخدام والفوترة > التفاصيل والإعدادات.

  2. انتقِل إلى بطاقة حدود الإنفاق على مستوى الخدمة.

  3. ابحث عن الخدمة التي تم فرض حدّ أقصى للإنفاق عليها، ثمّ انقر على رفع.

يُرجى العِلم أنّه يمكنك أيضًا إزالة حدود الإنفاق المفروضة باستخدام Google Cloud.

قيود ميزانيات الحدّ الأقصى للإنفاق

في ما يلي بعض القيود المهمة التي يجب معرفتها بشأن الميزانيات المحدّدة بسقف للإنفاق:

  • إنّ ميزانيات حدود الإنفاق ليست "حدودًا قصوى". بسبب التأخّر في إعداد تقارير الاستخدام، لا يتم فرض الحد الأقصى للإنفاق بشكل فوري، ويمكن أن يتأخّر التنفيذ لعدة دقائق. وسيتم تحصيل رسوم أي تكاليف زائدة تم تكبّدها خلال فترة التأخير هذه كالمعتاد. ننصحك بضبط ميزانيتك على قيمة أقل قليلاً من الحد الأقصى.

  • على مستوى المشروع والخدمة: تقتصر ميزانية الحد الأقصى للإنفاق على مشروع واحد وخدمة واحدة مؤهّلة ضمن هذا المشروع.

    • لا يمكنك ضبط ميزانية الحد الأقصى للإنفاق على مستوى حساب Cloud Billing بالكامل أو على مستوى المجلد أو المؤسسة أو التصنيف.

    • لا يمكنك تحديد ميزانية واحدة للحد الأقصى للإنفاق تغطي مشاريع متعددة أو خدمات متعددة.

    • عندما تحدّد ميزانية ذات حد أقصى للإنفاق لإحدى الخدمات، يتم تطبيقها على أي من الطرق التي قد تتفاعل بها مع الخدمة في المشروع. على سبيل المثال، إذا ضبطت ميزانية على Agent Platform Gemini API (formerly Vertex AI)، سيتم تطبيقها أيضًا على أي استخدام لواجهة برمجة التطبيقات هذه في المشروع من خلال Firebase SQL Connect وADK وGenkit وما إلى ذلك (وليس فقط الاستخدام من خلال Firebase AI Logic).

  • النطاق الزمني الشهري: النطاق الزمني لميزانية الحدّ الأقصى للإنفاق هو شهري، ويبدأ في اليوم الأول من كل شهر.

  • تتم استعادة الخدمة كل شهر تلقائيًا. في حال عدم إزالة الحد الأقصى المفروض للإنفاق، ستبقى الخدمة متوقّفة مؤقتًا للشهر الحالي فقط.

    • في بداية الشهر التالي، سيتم تلقائيًا إلغاء الحد الأقصى الإلزامي للإنفاق واستئناف الخدمة.

    • ومع ذلك، يمكنك تعديل إعدادات ميزانية الحدّ الأقصى للإنفاق ليبقى الحدّ الأقصى للإنفاق مفروضًا (وتبقى الخدمة متوقّفة مؤقتًا) إلى أجل غير مسمّى إلى أن تزيل الحدّ الأقصى للإنفاق المفروض بشكل صريح.

    بشكلٍ تلقائي، إذا لم ترفع الحدّ الأقصى المفروض للإنفاق، ستبقى الخدمة متوقّفة مؤقتًا خلال الشهر الحالي، ولكن سيتم استئنافها تلقائيًا في بداية الشهر التالي. ومع ذلك، يمكنك تعديل إعدادات الميزانية المحدّدة بسقف الإنفاق لكي يبقى سقف الإنفاق مفروضًا (وتبقى الخدمة متوقّفة مؤقتًا) إلى أجل غير مسمّى إلى أن تزيل سقف الإنفاق المفروض بشكلٍ صريح.

  • لا يشمل ذلك التوفير والائتمانات. تستند عمليات احتساب التكلفة لميزانية ذات حد أقصى للإنفاق إلى التكاليف الإجمالية ولا تشمل الخصومات والرصيد.

إذا كان لديك إعداد فوترة أكثر تقدّمًا، يمكنك الاطّلاع على مزيد من التفاصيل حول قيود ميزانيات الحدّ الأقصى للإنفاق في مستندات Google Cloud.