מעקב בפלטפורמה של מפות 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. כדי להשתמש בשפת השאילתות של Monitoring‏ (MQL), בוחרים בכרטיסייה MQL.
    1. כדי ליצור תרשים של ניצול המכסה, בוחרים באפשרות Consumer Quota בתור Resource type. לחלופין, אם רוצים ליצור תרשים של השימוש ב-API, בוחרים באפשרות Consumed API או Google Maps API (פרטים נוספים על מדדי השימוש שזמינים לממשקי ה-API של הפלטפורמה של מפות Google מופיעים בקטע מדדי שימוש). מעבירים את העכבר מעל כל סוג משאב כדי לראות את התיאור שלו.
    2. בקטע metric, בוחרים באפשרות Rate quota usage. התרשים מתעדכן אוטומטית ומציג את נתוני המדד. שימו לב שיש אפשרויות אחרות למכסת השימוש במדד. מעבירים את העכבר מעל כל מדד כדי לראות תיאור. מידע נוסף על השדות ב-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. כשמסיימים לערוך, לוחצים על החץ שמאלה כדי לצאת מלוח הבקרה, או בוחרים באפשרות אחרת בתפריט Monitoring. לוח הבקרה נשמר אוטומטית.

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

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

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

    כניסה ל-Monitoring

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

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

מדדי שימוש

יש שני סוגים של מדדים שזמינים לניטור השימוש בממשקי API של הפלטפורמה של מפות Google: מדדי זמן ריצה של שירותים (סוג המשאב consumed_api) שזמינים לרוב ממשקי Google Cloud API, ומדדים של הפלטפורמה של מפות 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 (צריכת API) כמשאב ובאפשרות Request Count (מספר הבקשות) כמדד, ואז לוחצים על Apply (החלה).
    2. (אופציונלי) מתחת לתרשים מופיעה רשימה של service,‏ quota_metrics,‏ API method וערך המדד value. בוחרים באפשרות הוספת מסנן כדי לסנן את הנתונים על סמך המידע הזה. לדוגמה, אפשר להשתמש במסנן כדי לציין שהשיטה צריכה להיות שווה ל-google.places.Autocomplete.http כדי להפעיל את ההתראה.
    3. בקטע שינוי נתונים, בוחרים באפשרות 5 דקות בשדה חלון נע ובאפשרות ממוצע בשדה פונקציית חלון נע.
    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. לוחצים על שם ההתראה כדי לראות מידע עליה, כולל תרשים שמציג את האירוע שהפעיל אותה.

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