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

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

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

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

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

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

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

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

• لاحظ ما يلي:

  • لا تؤدي تنبيهات الميزانية إلى إيقاف الخدمات مؤقتًا. وهي تهدف إلى مساعدتك في مراقبة تكاليفك وتنبيهك لاتّخاذ إجراء، إذا لزم الأمر. على سبيل المثال، يمكنك استخدام إشعارات الميزانية لإيقاف الفوترة في المشروع.

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

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

• في حال بلوغ الإنفاق الحدود المحدّدة لميزانيتك لخدمة معيّنة، سترسل 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 المرتبط به. يمنحك أيّ من الخيارات التالية الأذونات المطلوبة:

• الخيار 1: دور "مشرف حساب الفوترة" في حساب Cloud Billing المرتبط بالمشروع

• الخيار 2: دور مالك المشروع في المشروع الذي تريد ضبط ميزانيات الحدّ الأقصى للإنفاق فيه

• الخيار 3: مجموعة أدوار إدارة الهوية وإمكانية الوصول التالية على مستوى حساب Cloud Billing والمشروع:

  • دور مدير تكاليف حساب الفوترة في حساب Cloud Billing المرتبط بالمشروع

    و

  • دور "محرِّر المشروع" في المشروع الذي تريد ضبط ميزانيات الحدّ الأقصى للإنفاق فيه

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

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

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

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

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

3. ابحث عن الخدمة التي تريد وضع حدّ أقصى لها، وحدِّد مبلغ ميزانيتك الشهرية، ثم انقر على إعداد.

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

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

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

رسائل التنبيه الإلكترونية وتنفيذ الحدّ الأقصى للإنفاق

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

زيادة الحد الأقصى للإنفاق بعد تنفيذه

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

في ما يلي كيفية استئناف خدمة وزيادة الحد الأقصى للإنفاق فيها:

1. إزالة الحد الأقصى للإنفاق: في وحدة تحكّم Firebase أو وحدة تحكّم Google Cloud، ابحث عن الخدمة المفروضة، ثم انقر على إزالة.

   ستصبح حالة الحد الأقصى للإنفاق "في انتظار المراجعة" أثناء إزالة إجراء التنفيذ.

2. انتظِر إلى أن يكتمل رفع الحدّ الأقصى للإنفاق: انتظِر بضع دقائق وأعِد تحميل الصفحة إلى أن تظهر حالة الحدّ الأقصى للإنفاق تم رفعه.

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

3. تعديل مبلغ الميزانية: عدِّل ميزانية الحدّ الأقصى للإنفاق عن طريق إدخال مبلغ ميزانيتك الشهرية الجديد الأعلى. احفظ التغييرات.

اعتبارات مهمة عند رفع الحد الأقصى:

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

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

• احتساب الميزانية المتبقية: إنّ ميزانيتك المتبقية للشهر هي مبلغ الحدّ الجديد مطروحًا منه إجمالي إنفاقك حتى الآن. على سبيل المثال:

  1. لقد ضبطت حدًا أقصى للإنفاق يبلغ 10 دولار أمريكي على Cloud Functions for Firebase.

  2. يبلغ إنفاقك 10 دولار أمريكي (بالإضافة إلى 1 دولار أمريكي كرسوم استخدام زائد خلال فترة تأخُّر عرض البيانات، ليصبح الإجمالي 11 دولار أمريكي). يتم فرض الحدّ الأقصى، ما يؤدي إلى إيقاف وظائفك مؤقتًا.

  3. تؤكّد أنّ الزيارات شرعية، لذا تزيل الحد الأقصى وتنتظر إلى أن تظهر الحالة تمت إزالة الحد الأقصى.

  4. عدِّل الحد الأقصى للإنفاق إلى 20 دولارًا أمريكيًا. عند حفظ هذا التعديل، ستتم إعادة ضبط الحد الأقصى للإنفاق إلى الحالة تم ضبطه.

  5. تستمر وظائفك في العمل ضمن الحدّ الأقصى الجديد البالغ 20 دولارًا أمريكيًا، مع بقاء حوالي 9 دولارات أمريكية من الميزانية للشهر (الحدّ الأقصى البالغ 20 دولارًا أمريكيًا مطروحًا منه 11 دولارًا أمريكيًا تم تحصيلها بالفعل).

  6. في الشهر التالي، ستحافظ ميزانية الحدّ الأقصى للإنفاق على الحدّ الأدنى البالغ 20 دولارًا أمريكيًا.

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

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

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

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

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

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

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

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

• تتم استعادة الخدمة تلقائيًا كل شهر.

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

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

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

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