הגדרה של התראות פרוגרמטיות

במאמר הזה נסביר איך מגדירים התראות פרוגרמטיות לגבי תקציבים ולגבי חריגות בעלויות (גרסת טרום-השקה (Preview)) באמצעות Pub/Sub.

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

מגבלות

ההרשאות שנדרשות לביצוע המשימה הזו

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

כדי להגדיר התראות פרוגרמטיות לגבי תקציבים, אתם צריכים הרשאות ליצירה או לשינוי של תקציבים ונושאי Pub/Sub. אתם צריכים הגדרה שונה של הרשאות בהתאם לרמת הגישה שלכם.

משתמשים עם הרשאות לחשבון לחיוב ב-Cloud משתמשים עם הרשאות ברמת הפרויקט בלבד (גרסת טרום-השקה (Preview))

אם בארגון שלכם משתמשים בתפקידים בהתאמה אישית לצורך אימות, צריך להתאים אישית את התפקידים ולהוסיף להם את ההרשאות האלה:

כדי לשנות תקציב קיים לחיוב ב-Cloud באמצעות תפקיד בהתאמה אישית ולקשר אותו לנושא Pub/Sub קיים, צריך את ההרשאות האלה:

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

וגם לבקש מהאדמין שבפרויקט היעד יוקצה לכם תפקיד שכולל את נושאי Pub/Sub האלה:

אם בארגון שלכם משתמשים בתפקידים בהתאמה אישית לצורך אימות, צריך להתאים אישית את התפקידים ולהוסיף להם את ההרשאות האלה:

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

וגם לבקש מהאדמין שבפרויקט היעד יוקצה לכם תפקיד שכולל את נושאי Pub/Sub האלה:

התראות לגבי חריגות

כדי להגדיר התראות פרוגרמטיות לגבי חריגות, אתם צריכים הרשאות ליצירה או לשינוי של חריגות ונושאי Pub/Sub. צריכות להיות לכם הרשאות בחשבון לחיוב ב-Cloud.

משתמשים עם הרשאות לחשבון לחיוב ב-Cloud (גרסת טרום-השקה (Preview))

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

וגם לבקש מהאדמין שבפרויקט היעד יוקצה לכם תפקיד שכולל את נושאי Pub/Sub האלה:

יצירת נושא Pub/Sub

כדי להגדיר התראות פרוגרמטיות לגבי תקציבים או חריגות, קודם צריך ליצור נושא Pub/Sub. אם כבר הגדרתם נושא Pub/Sub של תקציבים או חריגות בעלויות, אתם יכולים לדלג על השלב הזה.

  1. נכנסים לדף Pub/Sub במסוף Google Cloud.

    כניסה לדף Pub/Sub במסוף Google Cloud

  2. בוחרים פרויקט שיכלול את נושא ה-Pub/Sub.

    כשמגדירים נושאי Pub/Sub בשביל התראות לגבי חיוב, מומלץ להשתמש בפרויקט ניהול של FinOps שיכלול את נושאי ה-Pub/Sub שקשורים לחיוב.

  3. לוחצים על Create topic.

  4. בשדה Topic ID נותנים שם לנושא.

  5. שומרים את הגדרות ברירת המחדל של המינוי וההצפנה ולוחצים על Create.

קישור של נושא Pub/Sub

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

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

כדי לקשר נושא Pub/Sub לתקציב לחיוב ב-Cloud צריך לבצע את הפעולות האלה:

משתמשים עם הרשאות לחשבון לחיוב ב-Cloud משתמשים עם הרשאות ברמת הפרויקט בלבד (גרסת טרום-השקה (Preview))

  1. נכנסים לדף Budgets & alerts במסוף Google Cloud.

    לפתיחת הדף Budgets & alerts
  2. בהודעה שמופיעה, בוחרים את החשבון לחיוב ב-Cloud שרוצים לנהל את התקציבים שלו.

    נפתח הדף Budgets & alerts של החשבון לחיוב שבחרתם.

  3. בוחרים את התקציב שרוצים לקשר או יוצרים תקציב חדש.
  4. בקטע Actions, באפשרויות של Manage notifications, לוחצים על Connect a Pub/Sub topic to this budget.
  5. בשדה Project, לוחצים על Select a project ובוחרים את הפרויקט שכולל את נושאי Pub/Sub שמגדירים.
  6. בקטע Select a Pub/Sub topic, בוחרים נושא קיים או לוחצים על Create a topic כדי ליצור נושא חדש.
    • אם יוצרים נושא חדש, נותנים לו שם בשדה Topic ID ולוחצים על Create topic.
    • אחרי שיוצרים את הנושא, הוא נבחר אוטומטית.
  7. לוחצים על Save.

  1. נכנסים למרכז הבקרה של מסוף Google Cloud ובוחרים פרויקט.

    לפתיחת מסוף Google Cloud
  2. בוחרים את הפרויקט שרוצים לנהל את התקציבים שלו.
  3. עוברים לקטע Billing: פותחים את תפריט הניווט במסוף Google Cloud, ולוחצים על Billing.

    אם מופיעה בקשה לבחור חשבון לחיוב, לוחצים על Go to linked billing account כדי לפתוח את החשבון לחיוב שמקושר לפרויקט שנבחר.

    נפתח הדף Overview של החשבון לחיוב שבחרתם.

  4. בקטע Cost management בתפריט הניווט Billing, בוחרים באפשרות Budgets & alerts.
  5. בוחרים את התקציב שרוצים לקשר או יוצרים תקציב חדש.
  6. בקטע Actions, באפשרויות של Manage notifications, לוחצים על Connect a Pub/Sub topic to this budget.
  7. בשדה Project, לוחצים על Select a project ובוחרים את הפרויקט שכולל את נושאי Pub/Sub שמגדירים.
  8. בקטע Select a Pub/Sub topic, בוחרים נושא קיים או לוחצים על Create a topic כדי ליצור נושא חדש.
    • אם יוצרים נושא חדש, נותנים לו שם בשדה Topic ID ולוחצים על Create topic.
    • אחרי יצירת הנושא, הוא ייבחר.
  9. לוחצים על Save.

התראות לגבי חריגות

כדי לקשר נושא Pub/Sub לחריגה בעלויות צריך לבצע את הפעולות האלה:

משתמשים עם הרשאות לחשבון לחיוב ב-Cloud (גרסת טרום-השקה (Preview))

  1. נכנסים לדף Anomalies במסוף Google Cloud.

    פתיחת הדף Anomalies

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

    ייפתח הדף Anomalies של החשבון לחיוב שבחרתם.

  3. לוחצים על Manage anomalies.
  4. מזינים ערך Anomaly threshold של Cost impact. הסכום הזה הוא ערך הסף שגורם להפעלה של ההתראות. אם לא מזינים ערך, ערך הסף שמוגדר הוא אפס ונשלחות התראות על כל החריגות.
  5. בקטע Pub/Sub notifications, בוחרים באפשרות Connect a Pub/Sub topic to receive programmatic updates about anomalies.
  6. בתפריט הנפתח שמופיע, בוחרים את נושא ה-Pub/Sub שרוצים לקשר אליו בשביל לקבל התראות.
    • הנושאים רשומים לפי פרויקט. יכול להיות שצריך לעבור לפרויקט אחר כדי למצוא את הנושא שרוצים לבחור.
    • אם רוצים ליצור נושא חדש, עוברים לפרויקט המועדף לפני שלוחצים על Create a topic.
  7. לוחצים על Save.

פורמט ההתראות

ההתראות שנשלחות לנושא Pub/Sub כוללות שני חלקים:

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

  • נתונים: מחרוזת שמכילה אובייקט JSON לתיאור הפרטים של ההתראה בקשר לתקציב.

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

מאפיינים

המאפיינים הם צמדי מפתח/ערך שכלולים בכל ההתראות שנשלחות מהחיוב ב-Cloud לנושא Pub/Sub. ההתראות תמיד כוללות את הקבוצה הבאה של צמדי מפתח/ערך, ללא קשר למטען הייעודי (payload) שלהן.

שם המאפיין דוגמה תיאור
billingAccountId 01D4EE-079462-DFD6EC המזהה של החשבון לחיוב ב-Cloud שהתקציב בבעלותו.
budgetId de72f49d-779b-4945-a127-4d6ce8def0bb המזהה של ההתראה לגבי תקציבים בחשבון לחיוב ב-Cloud.
schemaVersion 1.0 גרסת הסכימה שבשימוש בהתראות.

נתונים

הפרטים של ההתראות לגבי תקציבים מוחזרים במחרוזת מסוג UTF-8 בקידוד base64 עם אובייקט JSON שכולל את המאפיינים האלה:

נתונים דוגמה תיאור
budgetDisplayName "My Personal Budget" השם שהוקצה לתקציב, בפורמט שקריא לבני אדם.
costAmount 140.321 סכום העלויות שהצטברו. סוג העלויות שבמעקב תלוי במסננים ובהגדרות של התקציב.
costIntervalStart "2021-02-01T08:00:00Z" מועד ההתחלה של פרק הזמן להתראות בקשר לתקציב. הערך ב-'costAmount' כולל את עלויות השימוש שמתחילות בפרק הזמן הזה. זהו היום הראשון בפרק הזמן של התקציב (חודש, רבעון, שנה או טווח תאריכים מותאם אישית) שבמהלכו התבצע השימוש בתקציב.
budgetAmount 152.557 הסכום שהוקצה בתקציב.
budgetAmountType "SPECIFIED_AMOUNT" הסוג של סכום התקציב. יכול להיות אחד מהערכים האלה:
  • ‫"SPECIFIED_AMOUNT": סכום קבוע.
  • ‫"LAST_MONTH_COST": העלות הכוללת שהצטברה במהלך החודש הקלנדרי האחרון.
  • ‫"LAST_PERIODS_COST": העלויות שהצטברו במהלך התקופה הקלנדרית האחרונה, שהיא לא חודשית, כמו רבעון או שנה.
alertThresholdExceeded 0.9 הסף הגבוה ביותר שהוגדר להתראות שהעלות בפועל חרגה ממנו. הערך הוא אחוז שמוצג כשבר עשרוני (לדוגמה, 0.9 הוא 90%). המפתח הזה לא נמצא אם העלות בפועל לא חורגת מסף כלשהו.
forecastThresholdExceeded 0.2 הסף הגבוה ביותר שהוגדר להתראות שהעלות החזויה חרגה ממנו. הערך הוא אחוז שמוצג כשבר עשרוני (לדוגמה, 0.2 הוא 20%). המפתח הזה לא נמצא אם העלות החזויה לא חורגת מסף כלשהו.
currencyCode "USD" המטבע שבו משתמשים בהתראות בקשר לתקציב. כל העלויות והסכומים של ההתראות לגבי תקציבים הם במטבע הזה.

התראות לגבי חריגות

מאפיינים

המאפיינים הם צמדי מפתח/ערך שכלולים בכל ההתראות שנשלחות מהחיוב ב-Cloud לנושא Pub/Sub. לא משנה מהו המטען הייעודי (payload) של ההתראה, ההתראות תמיד כוללות את צמדי המפתח/ערך האלה:

שם המאפיין דוגמה תיאור
scope scope_project היקף החריגה.
billingAccountName billingAccounts/01D4EE-079462-DFD6EC המזהה של החשבון לחיוב ב-Cloud שהייתה בו חריגה.
resourceDisplayName My project השם המוצג של המשאב שהייתה בו חריגה.
resourceName projects/123456 המזהה של המשאב שהייתה בו חריגה.
SchemaVersion 1.0 הגרסה של סכימת ה-Pub/Sub.

נתונים

הפרטים של ההתראות לגבי חריגה מוחזרים במחרוזת מסוג UTF-8 בקידוד base64 עם אובייקט JSON שכולל את המאפיינים האלה:

נתונים דוגמה תיאור
anomalyName billingAccounts/01D4EE-079462-DFD6EC/anomalies/aaa שם המשאב שהייתה בו חריגה.
billingAccountName billingAccounts/01D4EE-079462-DFD6EC המזהה של החשבון לחיוב.
resourceName "projects/12345" המזהה של המשאב שהייתה בו חריגה.
resourceDisplayName "My project" השם המוצג של המשאב שהייתה בו חריגה.
detectionDate "2024-02-01T08:00:00Z" התאריך שזוהתה בו החריגה בעלויות.
Scope SCOPE_PROJECT ציון ההיקף של החריגה.
expectedSpendAmount {
"currencyCode": "USD",
"units": "8",
"nanos": 988106832
}
 		ההוצאה הצפויה על המשאב.
actualSpendAmount 196.22 ההוצאה בפועל על המשאב.
deviationAmount 31.01 ההפרש בין ההוצאה בפועל להוצאה הצפויה.
deviationPercentage 18.77 אחוז הסטייה של הסכום מההוצאה הצפויה.
Root cause 
root_causes {
resource: "services/XXX-XXXX-XXX"
display_name: "BigQuery"
cause_type: CAUSE_TYPE_SERVICE
deviation {
  expected_spend {
    currency_code: "USD"
    units: "5000"
  }
  actual_spend {
    currency_code: "USD"
    units: "5000"
  }
  deviation_amount {
    currency_code: "USD"
    units: "5000"
  }
  deviation_percentage: "Infinity"
}
sub_causes {
  resource: "locations/us-west1",
  display_name: "us-west1",
  cause_type: CAUSE_TYPE_LOCATION,
  deviation {
    expected_spend {
      currency_code: "USD",
    }
    actual_spend {
      currency_code: "USD",
      units:"5000"
    }
    deviation_amount {
      currency_code: "USD",
      units: "5000"
    }
    deviation_percentage: "Infinity"
  }
  sub_causes {
    resource: "services/XXXX-XXXX-XXXX/skus/XXXX-XXXX-XXXX"
    display_name: "Some display name"
    cause_type: CAUSE_TYPE_SKU
    deviation {
      expected_spend {
        currency_code: "USD"
      }
      actual_spend {
        currency_code: "USD"
        units: 5000
      }
      deviation_amount {
        currency_code: "USD"
        units: 5000
      }
      deviation_percentage: "Infinity"
    }
  }
  sub_causes {
    resource: "services/XXXX-XXXX-XXXX/skus/XXXX-XXXX-XXXX"
    display_name: "Some display name"
    cause_type: CAUSE_TYPE_SKU
    deviation {
      expected_spend {
        currency_code: "USD"
        units: "1"
        nanos: 5413077
      }
      actual_spend {
        currency_code: "USD"
        units: "1",
        nanos: 122606000
      }
      deviation_amount {
        currency_code: "USD"
        nanos: 117192923
      }
      deviation_percentage:11.656196419841217
    }
  }
}
}
שדה חוזר שכולל מידע על שורש הבעיה של החריגה.

התחייבויות למסירת התראות ל-Pub/Sub

אחרי שמקשרים את התקציב או החריגה לנושא Pub/Sub, כך אתם אמורים לקבל את ההתראות הפרוגרמטיות:

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

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

מסירת ההתראות עשויה להיכשל בגלל אחת מהסיבות הבאות:

התראות לגבי חריגות

  • התראות לגבי חריגות נשלחות לנושא Pub/Sub רק כשמגיעים לסף.
  • בזכות השימוש ב-Pub/Sub תישלח הודעה אחת לפחות לכל התראה, אבל יכול להיות שתקבלו את אותה הודעה כמה פעמים ויכול להיות שההודעות יגיעו בסדר הלא נכון.
  • אם המסירה נכשלת בגלל הגדרה שגויה של נושא Pub/Sub, לא תקבלו התראה.

מסירת ההתראות עשויה להיכשל בגלל אחת מהסיבות הבאות:

מידע נוסף על פרסום וקבלת הודעות ב-Pub/Sub

המאמרים הבאים

למידע נוסף על שימוש בהתראות פרוגרמטיות, כדאי לעיין בדוגמאות לתגובות פרוגרמטיות לבקרת עלויות שמפורטות כאן: