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

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

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

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

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

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

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

يمكنك التحكّم في التكاليف وتجنُّب تلقّي فواتير بمبالغ مفاجئة من خلال إنشاء ميزانيات لـ "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".

  • قبل إعداد ميزانية حدّ الإنفاق، راجِع المعلومات المهمة حول ميزانيات حدّ الإنفاق أدناه في هذه الصفحة.

جميع مشاريع Firebase هي في الواقع مشاريع Google Cloud في الخلفية، ما يعني أنّه تتم مشاركة الفوترة بين Firebase وGoogle Cloud ويمكنك عرض المشروع نفسه في كل من وحدة تحكّم 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 الأساسية.

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

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

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

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

• تم الضبط: يراقب "Cloud Billing" بشكل نشط إنفاق مشروعك على خدمة معيّنة استنادًا إلى ميزانية حد الإنفاق.

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

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

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

ملاحظة: يؤدي تعديل أي إعدادات لحد الإنفاق (حتى إعادة تسمية الميزانية في Google Cloud وحدة التحكم) إلى إعادة حد الإنفاق إلى الحالة تم الضبط. إذا كان إنفاقك الشهري يستوفي حد الميزانية أو يتجاوزه، سيتم تفعيل الحد الأقصى وتطبيقه على الفور.

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

إعداد حدود الإنفاق وإدارتها

ملاحظة: قبل إعداد ميزانية حدّ الإنفاق، راجِع نظرة عامة على ميزانيات حدّ الإنفاق في وقت سابق من هذه الصفحة.

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، ثم انتقِل إلى الإعدادات > الاستخدام والفوترة > صفحة التفاصيل والإعدادات.

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.

زيادة حدّ الإنفاق الأقصى بعد تنفيذ الإجراءات

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

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

1. إلغاء حدّ الإنفاق الأقصى: في وحدة تحكّم "Firebase" أو وحدة تحكّم "Google Cloud"، ابحث عن الخدمة التي تم تنفيذ الإجراء عليها، ثم انقر على إلغاء.

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

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

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

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

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

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

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

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

  1. لقد ضبطت حدّ إنفاق أقصى بقيمة ‎ $10 على "Cloud Functions for Firebase".

  2. يصل إنفاقك إلى 10 دولار أمريكي (بالإضافة إلى دولار أمريكي واحد كرسوم استخدام زائد خلال فترة تأخير إعداد التقارير، ليصبح المجموع 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.