הגדרה של מכסות הוצאות לשירותי 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: התפקיד Billing Account Administrator בחשבון Cloud Billing שמקושר לפרויקט

• אפשרות 2: התפקיד Project Owner בפרויקט שבו רוצים להגדיר תקציבים עם מגבלת הוצאות

• אפשרות 3: השילוב הבא של תפקידי IAM ברמת החשבון וברמת הפרויקט: Cloud Billing

  • Billing Account Costs Manager בחשבון Cloud Billing שמקושר לפרויקט

    וגם

  • התפקיד Project Editor בפרויקט שבו רוצים להגדיר תקציבים עם מגבלת הוצאות

הגדרת תקציב עם תקרת הוצאות

כדי ש-Cloud Billing יתחיל לעקוב באופן פעיל אחרי ההוצאות שלכם על שירות מסוים, צריך להגדיר תקציב עם מגבלת הוצאות לשירות הזה. אם הפרויקט יגיע לספי הוצאות מסוימים בשירות הזה, Cloud Billing ישלח התראות באימייל ויאכוף את תקרת ההוצאות.

כך מגדירים תקציבים עם מגבלת הוצאות באמצעות מסוף Firebase:

1. נכנסים לפרויקט במסוף Firebase ועוברים אל settings הגדרות > שימוש וחיוב > הדף פרטים והגדרות.

2. עוברים לכרטיס Service-level spend caps (תקרות הוצאות ברמת השירות).

3. מאתרים את השירות שרוצים להגביל, מגדירים את סכום התקציב החודשי ולוחצים על Configure (הגדרה).

   • תקציב עם הגבלת הוצאות מוגדר לפרויקט אחד ולשירות אחד שעומד בדרישות באותו פרויקט.

   • טווח הזמן של תקציב עם הגבלת הוצאות הוא חודשי, החל מהיום הראשון של כל חודש.

שימו לב שאפשר גם להגדיר תקציבים עם מגבלות הוצאה באמצעות מסוף Google Cloud.

התראות באימייל ואכיפה של תקרת ההוצאות

אחרי שמגדירים תקציב עם מגבלת הוצאות, מערכת Cloud Billing תעקוב באופן פעיל אחרי ההוצאות בפרויקט בשירות הזה. המערכת תשלח התראות באימייל ותאכוף את מגבלת ההוצאות על סמך ערכי הסף הבאים של ההוצאות בתקציב של מגבלת ההוצאות בשירות הזה.

• 50% ו-80% מהתקציב שהוגדר:

  • ‫Cloud Billing sends warning alert emails לכל האדמינים לחיוב, לבעלי הפרויקטים ולכל "איש קשר חיוני" רלוונטי.

• ‫100% מהתקציב שהוגדר:

  • Cloud Billing תקרה להוצאות מופעלת, כלומר כל שימוש חדש בשירות הרלוונטי יושעה למשך שאר החודש, אלא אם תבטלו את התקרה להוצאות.

  • Cloud Billing שולח עוד התראה באימייל. בנוסף, במסוף Firebase ובמסוף Google Cloud יוצגו הודעות באנר לגבי האכיפה של מגבלת ההוצאות והשירות שהושהה.

השפעה בצד הלקוח וטיפול בשגיאות

כששירות מושהה בגלל מגבלת הוצאות שהוגדרה, האפליקציה שלכם בצד הלקוח תתחיל להציג שגיאות לגבי השירות הזה. צריך לטפל בחריגים האלה בצורה תקינה בקוד האפליקציה (לדוגמה, באמצעות בלוקים של try-catch).

הסרת מגבלת הוצאות שנאכפת

אם הוגדר מכסת הוצאות והיא הופעלה, כל שימוש חדש בשירות הרלוונטי יושהה למשך שארית החודש, אלא אם תבטלו במפורש את מכסת ההוצאות שהופעלה.

כך מבטלים את ההגבלה על הוצאות באמצעות מסוף Firebase:

1. נכנסים לפרויקט במסוף Firebase ועוברים אל settings הגדרות > שימוש וחיוב > הדף פרטים והגדרות.

2. עוברים לכרטיס Service-level spend caps (תקרות הוצאות ברמת השירות).

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), הוא חל גם על כל שימוש ב-API הזה בפרויקט דרך Firebase SQL Connect, ADK,‏ Genkit וכו' (לא רק שימוש דרך Firebase AI Logic).

• טווח זמן חודשי. טווח הזמן של תקציב עם מכסת הוצאות הוא חודשי, החל מהיום הראשון של כל חודש.

• השירות מתחדש אוטומטית מדי חודש.

  • אם לא תסירו את מגבלת ההוצאות שהופעלה, השירות יישאר בהשהיה רק בחודש הנוכחי. בתחילת החודש הבא, תקרה ההוצאות שהופעלה מתאפסת אוטומטית למצב Configured (הוגדרה) עם התקציב המקורי, והשירות מתחדש.

  • אם תבטלו את תקרת ההוצאות במהלך החודש ולא תשנו את התקציב, השירות יפעל ללא הגבלת הוצאות למשך שאר החודש, ותקרת ההוצאות תתאפס אוטומטית למצב מוגדר עם התקציב המקורי, והשירות ימשיך לפעול.

• לא כולל חיסכון וזיכויים. חישובי העלויות בתקציב עם הגבלת הוצאות מבוססים על עלויות ברוטו ולא כוללים חיסכון וזיכויים.

אם הגדרתם חיוב מתקדם יותר, תוכלו למצוא פרטים נוספים על מגבלות של תקציבים עם הגבלת הוצאות במסמכי התיעוד של Google Cloud.