הגדרה של מכסות הוצאות לשירותי Firebase

גרסת טרום-השקה (Preview): תקציבים עם תקרת הוצאות זמינים בגרסת טרום-השקה (Preview), כלומר הם לא כפופים להסכם רמת שירות (SLA) או למדיניות הוצאה משימוש, ויכולים להשתנות באופן שלא תואם לדורות קודמים.

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

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

תקרת ההוצאות יכולה להיות באחד מהמצבים הבאים:

• ‫Configured: המערכת של Cloud Billing עוקבת אחרי ההוצאות בפרויקט לשירות ספציפי, בהתאם לתקציב של תקרת ההוצאות.

• ‫Enforced: ההוצאות בפרויקט הגיעו ל-100% מהתקציב החודשי שהגדרתם לאותו שירות, ולכן Cloud Billing אכפה את תקרת ההוצאות. כל שימוש חדש בשירות בשאר החודש מושהה, אלא אם תקרת ההוצאות שנאכפה מבוטלת באופן מפורש.

• ‫Lifted: המערכת של Cloud Billing אכפה את תקרת ההוצאות (והשהתה כל שימוש חדש בשירות הרלוונטי), אבל אכיפת תקרת ההוצאות בוטלה באופן מפורש כדי להמשיך את השירות.

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

הערה: אם משנים את ההגדרות של תקרת ההוצאות (אפילו אם משנים את שם התקציב במסוף Google Cloud), תקרת ההוצאות חוזרת לסטטוס Configured. אם ההוצאה החודשית כבר עומדת בסף התקציב או חורגת ממנו, התקרה מופעלת ונאכפת באופן מיידי.

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

הגדרה וניהול של תקרות הוצאה

הערה: לפני שמגדירים תקציב עם תקרת הוצאות, כדאי לקרוא את הסקירה הכללית של תקציבים עם תקרת הוצאות שמופיעה למעלה בדף הזה.

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

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

3. אפשר להסיר את תקרת ההוצאות (או להגדיל את התקציב).
   אם רוצים להמשיך להשתמש בשירות שהושהה באותו חודש (ללא הגבלה או במסגרת תקציב גבוה יותר), צריך להסיר באופן מפורש את תקרת ההוצאות שנאכפה.

ההרשאות הנדרשות

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

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

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

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

  • התפקיד ניהול עלויות בחשבון לחיוב בחשבון Cloud Billing שמקושר לפרויקט

    וגם

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

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

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

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

1. נכנסים לפרויקט במסוף Firebase, ואז עוברים לדף Settings > Usage and billing > Details & settings.

2. עוברים לכרטיס Service-level spend caps.

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

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

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

אזהרה: תקרות ההוצאות בתקציבים הן לא "תקרות קשיחות". בגלל זמן האחזור בדיווח על השימוש, אכיפת תקרת ההוצאות לא מתבצעת באופן מיידי. כל עלות חריגה שתיצבר במהלך העיכוב הזה תחויב כרגיל. מומלץ להגדיר תקציב שהוא קצת נמוך מהמגבלה המוחלטת שלכם.

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

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

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

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

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

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

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

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

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

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

ביטול של מכסת הוצאות שהופעלה

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

כך מסירים את תקרת ההוצאות שנאכפה באמצעות מסוף Firebase:

1. נכנסים לפרויקט במסוף Firebase, ואז עוברים לדף Settings > Usage and billing > Details & settings.

2. עוברים לכרטיס Service-level spend caps.

3. מאתרים את השירות שחלה עליו תקרת הוצאות, ולוחצים על הסרה.

חשוב לדעת את הדברים הבאים לגבי הסרת תקרת ההוצאות:

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

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

הגדלת תקרת ההוצאות אחרי אכיפה

אם תקרת ההוצאות שלכם נאכפת ואתם רוצים להמשיך את השירות בתקציב גבוה יותר עד סוף החודש (לדוגמה, להגדיל את המגבלה מ-10$ ל-20$), לא תוכלו לערוך את סכום התקציב כשהתקרה במצב Enforced. כדי להגדיר מגבלה גבוהה יותר, צריך קודם להסיר את המגבלה הקיימת.

כדי להמשיך להשתמש בשירות ולהגדיל את תקרת ההוצאות שלו:

1. הסרת תקרת ההוצאות: במסוף Firebase או במסוף Google Cloud, מאתרים את השירות שנאכף ולוחצים על Lift.

   תקרת ההוצאות תעבור למצב המתנה בזמן שהאכיפה תוסר.

2. ממתינים להסרת התקרה: ממתינים כמה דקות ומרעננים את הדף עד שסטטוס תקרת ההוצאות משתנה להוסרה.

   השירות יופעל מחדש. בהתאם לשירות, התהליך יכול להימשך עד שעה.

3. עדכון סכום התקציב: עורכים את תקציב תקרת ההוצאות ומזינים את סכום התקציב החודשי החדש והגבוה יותר. שומרים את השינויים.

שיקולים חשובים כשמגדילים את המכסה:

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

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

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

  1. הגדרת תקרת הוצאות של 10 $ב-Cloud Functions for Firebase.

  2. ההוצאה שלכם מגיעה ל-10 $‎ (בתוספת חריגה של 1 $‎ במהלך העיכוב בדיווח, סה"כ 11 $‎). המכסה נאכפת והפונקציות מושהות.

  3. אתם מוודאים שהתנועה לגיטימית, מבטלים את המכסה וממתינים עד שהסטטוס ישתנה ל-בוטל.

  4. אתם מעדכנים את תקרת ההוצאות ל-20$. כששומרים את השינוי, תקרת ההוצאות מתאפסת וחוזרת למצב Configured.

  5. הפונקציות ממשיכות לפעול במסגרת המכסה החדשה של 20$, ונשאר תקציב של כ-9 $לחודש (מגבלה של 20$ פחות 11$ שכבר נצברו).

  6. בחודש הבא, התקציב של תקרת ההוצאות יישאר על סף של 80 ש"ח.

מגבלות של תקציבים עם תקרת הוצאות

חשוב להבין את המגבלות הבאות לגבי תקציבים עם תקרת הוצאות:

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

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

  • אי אפשר להגדיר תקציב עם תקרת הוצאות ברמת החשבון ב-Cloud Billing, או ברמת התיקייה, הארגון או התווית.

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

  • כשמגדירים תקציב עם תקרת הוצאות לשירות, הוא חל על כל אחת מהדרכים שבהן אתם יכולים להשתמש בשירות בפרויקט. לדוגמה, אם מגדירים תקציב ל-Agent Platform Gemini API (formerly Vertex AI), הוא חל גם על כל שימוש ב-API הזה בפרויקט באמצעות Firebase SQL Connect, ‏ADK, ‏Genkit וכו' (לא רק על שימוש באמצעות Firebase AI Logic).

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

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

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

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

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

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