מעקב בפלטפורמה של מפות Google

‫Cloud Monitoring אוסף מדדים לגבי ממשקי ה-API והשירות שלכם, וגם לגבי משאבי Google Cloud שבהם אתם משתמשים. במאמר הזה מוסבר איך להגדיר את Cloud Monitoring ואיך להשתמש בו כדי לעקוב אחרי השימוש ב-API, ליצור לוחות בקרה וליצור התראות.

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

הגדרת Cloud Monitoring

בעזרת המעקב תוכלו לראות ולנהל את המדדים:

  • לפרויקט בודד
  • לכמה פרויקטים בארגון אחד
  • למספר פרויקטים בכמה ארגונים

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

  1. במסוף Google Cloud, בוחרים באפשרות Monitoring:

    כניסה ל-Monitoring

  2. מוודאים שבחרתם בפרויקט הנכון.
  3. בחלונית הניווט של Monitoring, לוחצים על > משמאל להיקף המדדים. בצילום המסך הבא מוצג הדף שמופיע כשבוחרים בפרויקט AllEnvironments:

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

בטבלה שכותרתה Metrics monitored by this project (מדדים שנבדקים על ידי הפרויקט הזה) מפורטים הפרויקטים שהמדדים שלהם נגישים להיקף המדדים הנוכחי. כל שורה בטבלה מפרטת פרויקט ואת התפקיד של הפרויקט:

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

בטבלה עם הכותרת The projects listed below can view this project's metrics (הפרויקטים שמפורטים בהמשך יכולים לראות את המדדים של הפרויקט הזה) מפורטים הפרויקטים שהיקף המדדים שלהם כולל את הפרויקט הנוכחי. בצילום המסך הקודם אפשר לראות שאין פרויקטים אחרים שיכולים לגשת למדדים שמאוחסנים בפרויקט AllEnvironments.

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

עיון במדדים

כדי לבחון את נתוני המדדים, יוצרים תרשים באמצעות Metrics Explorer , שכלול ב-Cloud Monitoring. לדוגמה, אם רוצים לראות את השימוש במכסה של API, אפשר להשתמש ב-Metrics Explorer כדי ליצור תרשים שמציג את הנתונים האחרונים.

בתמונה הבאה מוצג תרשים עם פרטים על השימוש במכסות של ממשקי API של מפות Google:

צילום מסך של נתוני מדדי המכסה של כל Maps API. התרשים הוא תרשים עמודות אופקי שבו כל פלח בעמודה מתאים ל-API אחר.

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

בתמונה הזו:

  • השדות סוג המשאב ומדד מימין לתרשים מגדירים את נתוני המדד שמוצגים בתרשים.
  • בתפריט הנפתח של סוג התרשים שמעל התרשים, אפשר לבחור את סוג התרשים. בדוגמה הזו, ההגדרה היא Stacked bar chart.
  • פרק הזמן שמעל התרשים מוגדר כ1W (שבוע אחד).
  • מתחת לתרשים מופיעה רשימת השירותים, מדדי הקווטה, השיטות של ה-API והערכים של המדדים שמוצגים בתרשים. בוחרים באפשרות הוספת מסנן כדי להשתמש במידע הזה לצמצום הנתונים שמוצגים.

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

יצירת תרשים של מדד יחיד

כדי להגדיר תרשים באמצעות Metrics Explorer:

  1. ב-Cloud Console, בוחרים באפשרות Monitoring:

    כניסה ל-Monitoring

  2. בחלונית הניווט, בוחרים באפשרות כלי לבחירת מדדים.
  3. בסרגל הכלים, בוחרים באפשרות תרשים עמודות מוערם מהתפריט הנפתח של סוג התרשים כדי לראות את נתוני המדדים כתרשים עמודות.
  4. בוחרים מרווח זמן, למשל 1W (שבוע אחד).
  5. מגדירים את הנתונים שיופיעו בתרשים. כדי להשתמש בממשק מבוסס-תפריט או כדי להזין מסנן, בוחרים בכרטיסייה Configuration. כדי להשתמש בשפת שאילתת מעקב (MQL), בוחרים בכרטיסייה MQL.
    1. כדי ליצור תרשים של ניצול המכסה, בוחרים באפשרות Consumer Quota בתור Resource type. לחלופין, אם רוצים ליצור תרשים של השימוש ב-API, בוחרים באפשרות Consumed API או Google Maps API (בקטע מדדי שימוש יש פרטים נוספים על מדדי השימוש שזמינים לממשקי ה-API של הפלטפורמה של מפות Google). מעבירים את העכבר מעל כל סוג משאב כדי לראות את התיאור שלו.
    2. בקטע מדד, בוחרים באפשרות שימוש במכסת קצב. התרשים מתעדכן אוטומטית ומציג את נתוני המדד. שימו לב שיש אפשרויות אחרות למכסת השימוש במדד. מעבירים את העכבר מעל כל מדד כדי לראות תיאור. מידע נוסף על השדות ב-Metrics Explorer זמין במאמרים בחירת מדדים ובחירת אופן הצגת הנתונים בתרשים.
  6. (אופציונלי) משתמשים באפשרויות הבאות כדי לשפר את התצוגה:
    1. כדי לציין קבוצת משנה של נתונים להצגה, מוסיפים מסננים. כדי להוסיף מסנן, לוחצים על הוספת מסנן ומשלימים את תיבת הדו-שיח. מידע נוסף זמין במאמר בנושא סינון נתונים בתרשים. לדוגמה, כדי להציג נתונים של API יחיד:
      1. בשדה Label (תווית), בוחרים באפשרות method (שיטה).
      2. בשדה השוואה, בוחרים באפשרות = (שווה).
      3. בשדה ערך, בוחרים את השם של שיטה ספציפית. תוצג בקשה לבחור את השם של שיטה עם נתונים להצגה.
      4. לוחצים על סיום כדי לעדכן את התרשים.
    2. כדי לקבץ סדרות זמנים לפי תוויות, משתמשים בשדה Group by. בחירה של ערך בשדה הזה תגרום לבחירה אוטומטית של ערך בשדה Aggregator.
    3. כדי לציין איך לשלב סדרות עיתיות, מגדירים את השדה Aggregator [מצבר]. לדוגמה, אם השדה Group by ריק והשדה Aggregator מוגדר ל-mean, בתרשים מוצג הממוצע של סדרת הזמנים.
    4. כדי להגדיר איך לעבד את סדרות הזמן האישיות, בוחרים באפשרות אפשרויות מתקדמות. מידע נוסף זמין במאמר איך בוחרים מדדים כשמשתמשים ב-Metrics Explorer.

  7. אפשר גם להוסיף ללוח בקרה.

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

הצגת כמה מדדים בתרשים

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

כדי להוסיף מדד לתרשים קיים:

  1. בתרשים הקיים, לוחצים על הוספת מדד נוסף בתחתית המסך.
  2. בוחרים את המדד ומציינים איך להציג את ציר הזמן של המדד הזה, באותו אופן שבו הגדרתם את המדד המקורי שלמעלה.

מידע נוסף על ניתוח מדדים זמין במאמרים הבאים:

יצירת מרכזי בקרה

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

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

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

  • תרשים של מכסת השימוש בצד שמאל
  • תרשים של מספר קריאות ה-API בצד ימין

צילום מסך של מרכז בקרה בהתאמה אישית, שבו מוצגים שני תרשימים. התרשים בצד ימין הוא תרשים מכסות, והתרשים בצד שמאל הוא תרשים של שימוש ב-API. בשני התרשימים מופיעות נקודות זמן בציר האופקי.

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

אם אתם בוחרים לנהל לוחות בקרה מותאמים אישית באמצעות Cloud Monitoring API, כלי Metrics Explorer מספק לכם שני כלי עזר שימושיים:

  • כדי ליצור ייצוג JSON לתרשים שמתכננים להוסיף ללוח בקרה, צריך להגדיר את התרשים באמצעות Metrics Explorer. אחר כך אפשר לגשת לייצוג ה-JSON מהפריט אפשרויות נוספות בתפריט של סרגל הכלים של כלי המדדים.
  • כדי לזהות את התחביר של מסנן Monitoring, שמשמש עם Cloud Monitoring API, משתמשים בממשק מבוסס התפריטים של Metrics Explorer כדי להגדיר את התרשים. אחרי שבוחרים את המדד והמסננים, עוברים אל מצב סינון ישיר כדי לראות את המסנן המקביל של המעקב.

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

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

  1. ב-Cloud Console, בוחרים באפשרות Monitoring:

    כניסה ל-Monitoring

  2. בחלונית הניווט, בוחרים באפשרות מרכזי בקרה.
  3. בדף 'סקירה כללית של מרכזי בקרה', לוחצים על יצירת מרכז בקרה.
  4. לכל תרשים שרוצים להוסיף למרכז הבקרה, מבצעים את הפעולות הבאות:

    1. בוחרים סוג תרשים מתוך הוספת תרשים, או גוררים תרשים מהספרייה לאזור הגרף.

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

      צילום מסך של הכלי Metrics Explorer שבו משתמשים כדי ליצור תרשים שאפשר להוסיף ללוח בקרה.

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

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

  5. (אופציונלי) בסרגל הכלים של מרכז הבקרה, לוחצים על הוספת תרשים כדי להוסיף עוד תרשים, וחוזרים על השלבים הקודמים כדי להתאים אישית את התרשים.
  6. כשמסיימים לערוך, לוחצים על החץ שמאלה כדי לצאת מלוח הבקרה, או בוחרים פריט אחר בתפריט מעקב. מרכז הבקרה נשמר אוטומטית.

צפייה במרכז בקרה

כדי להציג מרכז בקרה:

  1. ב-Cloud Console, בוחרים באפשרות Monitoring:

    כניסה ל-Monitoring

  2. בחלונית הניווט, בוחרים באפשרות מרכזי בקרה.
  3. בוחרים מהרשימה את מרכז הבקרה המותאם אישית או את מרכז הבקרה המוגדר מראש.

מידע נוסף על יצירת מרכזי בקרה זמין במאמרים הבאים:

מדדי שימוש

יש שני סוגים של מדדים לניטור השימוש בממשקי ה-API של הפלטפורמה של מפות Google: מדדי זמן ריצה של שירותים (סוג המשאב consumed_api) שזמינים לרוב ממשקי ה-API של Google Cloud, ומדדים של הפלטפורמה של מפות Google, שהם מדדים ספציפיים לממשקי ה-API של הפלטפורמה של מפות Google (סוג המשאב maps.googleapis.com/Api).

שני מדדי התנועה תומכים באותה קבוצה של תוויות משאבים לצורך פיצול תנועת השימוש בממשקי API: project_id, service, method, version, location ו-credential_id. תיאורים של תוויות המשאבים מופיעים במסמכי העזרה של משאב המדדים המתאים:

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

במדד Request Count (מספר הבקשות) אפשר לפלח את תנועת השימוש לפי התוויות של המדדים protocol, grpc_status_code, response_code ו-response_code_class. בנוסף, אפשר לפצל לפי platform_type במדדים של הפלטפורמה של מפות Google.

במדד Request Latencies אפשר לפלח את תנועת השימוש לפי התוויות של המדדים protocol, platform_type, response_code ו-response_code_class רק במדדים של Google Maps Platform.

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

מיפוי של תוויות קוד התגובה וסטטוס התגובה

בטבלה הבאה מוצג המיפוי בין קוד הסטטוס של התגובה לבין קוד התגובה של HTTP שמוחזר בתגובה לבקשות של Google Maps Platform API, וגם תוויות של קודי תגובה שזמינות ב-Cloud Monitoring: קוד התגובה של HTTP, סיווג קוד התגובה של HTTP וקוד הסטטוס של GRPC. קוד הסטטוס של GRPC הוא קוד תגובה מספרי של gRPC לבקשות gRPC, או קוד מקביל של gRPC לבקשות HTTP.

קודי תגובה שמוחזרים בתגובות מה-API קודי תגובה שמדווחים לניטור
סטטוס Maps API קוד תגובת HTTP קוד תגובת HTTP סיווג של קוד תגובת HTTP קוד סטטוס של GRPC
אישור ‫200,
‫204,
‫302		 ‫200,
‫204,
‫302		 ‫2xx,
3xx		 ‫0 (OK)
DATA_NOT_AVAILABLE,
NOT_FOUND,
ZERO_RESULTS		 200 ‫200, 404(1) ‫2xx, ‏
‫4xx(1)		 ‫5 (NOT_FOUND)(1)
INVALID_REQUEST (invalid parameter value),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
etc.		 ‫200,
400		 400 ‫4xx ‫3 (INVALID_ARGUMENT)
INVALID_REQUEST (פרמטר לא תקין או חסר, שגיאה בניתוח הבקשה) ‫200,
400		 400 ‫4xx ‫3 (INVALID_ARGUMENT)
REQUEST_DENIED 200, 403,
200, 400		 403,
401(1)		 ‫4xx(1) ‫7 (PERMISSION_DENIED),
‫16 (UNAUTHENTICATED)
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded 		200,
403,
429		 ‫429(1) ‫4xx(1) ‫8 (RESOURCE_EXHAUSTED)
UNKNOWN_ERROR ‫200, ‏ 500,
503		 ‫500(1),
503		 ‫5xx(1) ‫2 (לא ידוע)/13 (פנימי)(1),‏
‫14 (לא זמין)
‫1 כדי לשפר את העקביות של הדיווח על קודי שגיאה, אנחנו מעבירים את ממשקי ה-API של הפלטפורמה של מפות Google: ‏ 1) מקוד/סיווג תגובת HTTP‏ 200/2xx אל 404/4xx (וקוד סטטוס GRPC מ-0 (OK) אל 5 (NOT_FOUND)) לסטטוסים של Maps API: ‏ DATA_NOT_AVAILABLE, ‏ NOT_FOUND,‏ ZERO_RESULTS – status,‏ 2) מקוד/סיווג תגובת HTTP‏ 200/2xx,‏ 400/4xx אל 403/4xx (וקוד סטטוס GRPC‏ 7 (PERMISSION_DENIED)) לסטטוס של Maps API: ‏ REQUEST_DENIED,‏ 3) מקוד/סיווג תגובת HTTP‏ 200/2xx,‏ 403/4xx אל 401/4xx (קוד סטטוס GRPC‏ 16 (UNAUTHENTICATED)) לסטטוס של Maps API: ‏ REQUEST_DENIED,‏ 4) מקוד/סיווג תגובת HTTP‏ 200/2xx,‏ 403/4xx אל 429/4xx לסטטוסים של Maps API: ‏ OVER_QUERY_LIMIT,‏ dailyLimitExceeded, ‏ rateLimitExceeded,‏ userRateLimitExceeded,‏ 5) מקוד/סיווג תגובת HTTP‏ 200/2xx אל 500/5xx (וקוד סטטוס GRPC‏ 2 (UNKNOWN), ‏ 13 (INTERNAL)) לסטטוס של Maps API: ‏ UNKNOWN_ERROR. במהלך תקופת המעבר, תוכלו לראות את שני קודי התגובה. קודי התגובה שמוחזרים בתגובות של Maps API לא משתנים. אפשר לראות את פירוט קודי התגובה שדווחו לאורך זמן בכלי לבחירת מדדים.

יצירת התראות

התראות מאפשרות לכם לזהות בעיות באפליקציות בזמן אמת ולפתור אותן במהירות. ב-Cloud Monitoring, כלל מדיניות התראות מתאר את הנסיבות שבהן רוצים לקבל התראה ואת האופן שבו רוצים לקבל את ההתראה.

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

  • אני רוצה לקבל הודעה כשמספר הבקשות לממשק API ספציפי חורג מ-1,000 בקשות בחלון של 5 דקות.
  • שליחת התראה לצוות התמיכה התורן כשערך האחוזון ה-90 של תגובות HTTP 200 חורג מ-100 אלפיות השנייה של זמן האחזור עבור 3 ממשקי API או יותר.

בתמונה הבאה מוצגת הגדרת התראה ליצירת התראה כשמספר הבקשות ל-API חורג מ-20 בקשות בחלון של 5 דקות:

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

בתמונה הזו:

  • בתרשים מוצג מספר הקריאות ל-API לאורך זמן עבור ממשקי API שונים.
  • הקו האדום מציין את סף ההתראה. קריאות ל-API שחורגות מהסף הזה בחלון של 5 דקות מפעילות את ההתראה. בדוגמה הזו אפשר לראות שאחד מממשקי ה-API חרג מהמגבלה.

כשמתקיימים התנאים של מדיניות התראות, Cloud Monitoring פותח אירוע ושולח התראות:

  • אירוע הוא רשומה קבועה שמאחסנת מידע על המשאבים שבמעקב כשהתנאי התקיים. כשהתנאי מפסיק להתקיים, התקרית נסגרת באופן אוטומטי. כדי לראות את כל האירועים, פתוחים וסגורים, אפשר להשתמש בלוח הבקרה של ההתראות.
  • כשמגדירים כלל מדיניות התראות, מציינים מי יקבל התראות. ‫Monitoring תומך בערוצי התראות נפוצים, כולל אימייל, אפליקציית Cloud לנייד ושירותים כמו PagerDuty או Slack. רשימה מלאה של ערוצי התראות זמינה במאמר אפשרויות של התראות.

סוגי התראות

‫Cloud Monitoring תומך בסוגים רבים של התראות. לדוגמה, אפשר להגדיר:

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

מידע נוסף זמין במאמר סוגים של מדיניות התראות.

ניהול כללי מדיניות התראות

אפשר להוסיף מדיניות התראות לפרויקט באמצעות מסוף Cloud או Cloud Monitoring API. מידע על צפייה ברשימה של מדיניות התראות מבוססת-מדדים בפרויקט ועל שינוי המדיניות הזו זמין במאמרים הבאים:

יצירת התראה

כשיוצרים התראה, אתם:

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

בדוגמה הבאה מוצג איך להגדיר התראה שתופעל כששיעור השימוש בשירות של הפלטפורמה של מפות Google עבור כל API יעלה על 2 בקשות בחלון של 5 דקות.

כדי ליצור את ההתראה:

  1. ב-Cloud Console, בוחרים באפשרות Monitoring:

    כניסה ל-Monitoring

  2. בוחרים באפשרות התראות עם צלילים או רטט.
  3. בוחרים באפשרות Edit Notifications Channel (עריכת ערוץ ההתראות) כדי להגדיר איך ההתראה תתקבל. בדוגמה הזו, תשתמשו בכתובת האימייל שלכם.
    1. בערוץ אימייל, בוחרים באפשרות הוספה חדש.
    2. מזינים כתובת אימייל ושם לתצוגה.
    3. לוחצים על שמירה.
  4. בוחרים באפשרות התראות עם צלילים או רטט.
  5. לוחצים על יצירת מדיניות.
  6. בוחרים מרווח זמן, למשל 7 ימים.
  7. בקטע תנאי התראה, בוחרים באפשרות תנאי חדש:
    1. לוחצים על Select a Metric, בוחרים באפשרות Consumed API כמשאב ובאפשרות Request Count כמדד, ואז לוחצים על Apply.
    2. (אופציונלי) מתחת לתרשים מופיעה רשימה של service,‏ quota_metrics,‏ API method וערך המדד value. בוחרים באפשרות הוספת מסנן כדי לסנן את הנתונים על סמך המידע הזה. לדוגמה, אפשר להשתמש במסנן כדי לציין שהשיטה צריכה להיות שווה ל-google.places.Autocomplete.http כדי להפעיל את ההתראה.
    3. בקטע Transform data (טרנספורמציה של נתונים), בוחרים באפשרות 5 min (5 דקות) בשדה Rolling window (חלון נע) ובאפשרות mean (ממוצע) בשדה Rolling window function (פונקציית חלון נע).
    4. לוחצים על הבא.
  8. בקטע Configure alert trigger, מגדירים את Threshold value ל-2 כדי לציין שההתראה תופעל אם יהיו יותר מ-2 בקשות בחלון של 5 דקות. שימו לב שבתרשים מוצג עכשיו הקו האדום שמציין את סף ההתראה למרווח הזמן שנבחר. בטבלה אפשר לראות איפה התרעה הייתה מופעלת. התרשים הזה יכול לעזור לכם לשנות את המגבלה לפי הצורך.
  9. לוחצים על הבא.
  10. בדף Configure notifications and finalize alert:
    1. בוחרים את כתובת האימייל שיצרתם עבור ערוץ ההתראות.
    2. בקטע Name the alert (שם ההתראה), מזינים My Test Alert (התראת הבדיקה שלי).
    3. לוחצים על יצירת מדיניות.
  11. שולחים כמה בקשות API. כדי ליצור את ההתראה באימייל, צריך לוודא ששולחים יותר משתי בקשות API תוך חמש דקות.
  12. אחרי שמקבלים את האימייל עם ההתראה, עוברים לדף התראות.
    1. כדי לראות מידע נוסף על התראה, לוחצים עליה בטבלה שבה מפורטות ההתראות.
    2. לוחצים על שם ההתראה כדי לראות מידע על ההתראה, כולל תרשים שמציג את האירוע שהפעיל אותה.

מידע נוסף על התראות: