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

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

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

הגדרת Cloud Monitoring

ב-Monitoring אפשר לראות ולנהל את המדדים:

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

כדי לוודא שהמדדים של הפרויקטים זמינים:

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

   כניסה לדף Monitoring

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

   

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

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

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

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

עיון במדדים

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

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

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

בתמונה הזו:

• השדות Resource Type ו-Metric שמשמאל לתרשים מגדירים את נתוני המדדים שמוצגים בתרשים.
• בתפריט הנפתח של סוג התרשים שמעל לתרשים, אתם יכולים לבחור את סוג התרשים. בדוגמה הזו, ההגדרה היא תרשים עמודות אופקי מוערם.
• מרווח הזמן שמעל התרשים מוגדר ל-1W (שבוע אחד).
• מתחת לתרשים מופיעה רשימה של service,‏ quota_metrics,‏ method של ה-API ו-value של המדד שמגדירים את הנתונים בתרשים. בוחרים באפשרות Add Filter כדי להשתמש במידע הזה לצמצום הנתונים שמוצגים.

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

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

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

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

   כניסה לדף Monitoring

2. בחלונית הניווט, בוחרים באפשרות Metrics explorer.
3. בסרגל הכלים, בוחרים באפשרות Stacked bar chart בתפריט הנפתח של סוג התרשים כדי להציג את נתוני המדדים בתרשים עמודות אופקי מוערם.
4. בוחרים מרווח זמן, למשל 1W (שבוע אחד).
5. מציינים את הנתונים שיופיעו בתרשים. כדי להשתמש בממשק מבוסס-תפריט או כדי להזין מסנן, בוחרים בכרטיסייה Configuration. כדי להשתמש בשפת השאילתות של Monitoring‏ (MQL), בוחרים בכרטיסייה MQL.
הערה: MQL מספק ממשק אקספרסיבי מבוסס-טקסט לנתוני סדרות הזמן של Cloud Monitoring. בכל הדוגמאות במאמר הזה נעשה שימוש במסוף Cloud. למידע נוסף, קראו את המאמר מבוא לשפת השאילתות של Monitoring.
1. כדי להציג בתרשים את השימוש במכסות, בוחרים באפשרות Consumer Quota בתור Resource type. לחלופין, אם רוצים ליצור תרשים לשימוש ב-API, בוחרים באפשרות Consumed API או Google Maps API (לפרטים נוספים על מדדי השימוש שזמינים לממשקי ה-API של Google Maps Platform, עיינו בקטע מדדי שימוש). אפשר להציב את הסמן מעל כל סוג משאב כדי לראות את התיאור שלו.
2. בשדה metric, בוחרים באפשרות Rate quota usage. התרשים מתעדכן באופן אוטומטי ומציג את נתוני המדדים.
   הערה: אם לא מופיעים נתונים בתרשים, צריך להאריך את מרווח הזמן או לצאת ולשלוח כמה בקשות API כדי ליצור נתוני מדדים.
   שימו לב שיש עוד אפשרויות למכסות של המדד. כדי לראות תיאור של כל מדד, מעבירים את העכבר מעליו. למידע נוסף על השדות של Metrics Explorer, קראו את המאמרים בחירת מדדים ובחירת אופן ההצגה של נתונים בתרשים.
6. (אופציונלי) אפשר להשתמש באפשרויות הבאות כדי לשנות את התצוגה:
   1. כדי לציין קבוצת משנה של נתונים שרוצים להציג, מוסיפים מסננים. כדי להוסיף מסנן, לוחצים על Add filter וממלאים את תיבת הדו-שיח. מידע נוסף זמין במאמר סינון נתונים בתרשים. לדוגמה, כדי להציג נתונים של API יחיד:
   1. בשדה Label, בוחרים באפשרות method.
   2. בשדה Comparison, בוחרים בסימן השוויון =.
   3. בשדה ערך, בוחרים את השם של שיטה ספציפית. תתבקשו לבחור את השם של השיטה עם הנתונים שאתם רוצים להציג.
   4. לוחצים על סיום כדי לעדכן את התרשים.
   2. כדי לקבץ סדרות זמנים לפי תווית, משתמשים בשדה Group by. כשבוחרים ערך בשדה הזה, נבחר באופן אוטומטי ערך בשדה Aggregator.
   3. כדי לציין איך לשלב סדרות זמנים, מגדירים את השדה Aggregator. לדוגמה, אם השדה קיבוץ לפי ריק והשדה Aggregator מוגדר ל-mean, בתרשים יוצג הממוצע של סדרת הזמנים.
   4. כדי להגדיר איך לעבד את הסדרות העתיות הנפרדות, בוחרים באפשרות Advanced Options. מידע נוסף זמין במאמר איך בוחרים מדדים כשמשתמשים ב-Metrics Explorer.

7. אם רוצים, מוסיפים את התרשים למרכז בקרה.

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

תרשים של כמה מדדים

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

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

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

מקורות מידע שקשורים לנושא

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

• יצירת תרשימים באמצעות Metrics Explorer
• בחירת מדדים כשמשתמשים ב-Metrics Explorer
• מדדים שזמינים לכל ממשקי ה-API של Google Cloud
• מדדים ספציפיים לממשקי ה-API של Google Maps Platform
• מדדי התפלגות בתרשים
• הצגת האפשרויות

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

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

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

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

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

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

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

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

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

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

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

   כניסה לדף Monitoring

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

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

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

      

      הערה: אם לא מופיעים נתונים בתרשים, צריך להאריך את מרווח הזמן או לצאת ולשלוח כמה בקשות API כדי ליצור נתוני מדדים.
   2. בוחרים את Resource type ואת Metric, ומפעילים את המסננים כמו שעשיתם קודם כשנוצר התרשים.

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

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

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

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

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

   כניסה לדף Monitoring

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

מקורות מידע שקשורים לנושא

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

• מרכזי בקרה ותרשימים
• ניהול מרכזי בקרה בהתאמה אישית במסוף
• ניהול מרכזי בקרה באמצעות API

מדדי השימוש

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

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

• תוויות משאבים של מדדי Serviceruntime
• תוויות של משאבים ב-Google Maps Platform

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

במדד Request Count אפשר לפצל את תנועת השימוש לפי תוויות המדדים protocol,‏ grpc_status_code,‏ response_code ו-response_code_class. בנוסף, אפשר לפצל לפי platform_type במדדים של Google Maps Platform.

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

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

• מדדי Serviceruntime
• מדדים של Google Maps Platform

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

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

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

קודי תגובה שמוחזרים בתגובות מה-API		קודי תגובה שמדווחים ל-Monitoring
סטטוס Maps API	קוד תגובת HTTP	קוד תגובת HTTP	סוג קוד תגובת HTTP	קוד סטטוס של GRPC
אישור	‫200, 204, 302	‫200, 204, 302	‫2xx, 3xx	‫0 (תקין)
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS	200	200, 404^(1)	‫2xx,‏ 4xx^(1)	‫5 (NOT_FOUND)^(1)
‫INVALID_REQUEST (ערך פרמטר לא חוקי), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, וכו'.	‫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 (UNKNOWN)‏/13 (INTERNAL)^(1), ‫14 (UNAVAILABLE)
‫^1 כדי לשפר את העקביות של הדיווח על קודי שגיאה, ממשקי ה-API של הפלטפורמה של מפות Google עוברים: 1) מקוד/מחלקה של תגובת HTTP‏ 200/2xx אל 404/4xx (וקוד סטטוס GRPC מ-0 (OK) אל 5 (NOT_FOUND)) לסטטוסים של Maps API‏: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – סטטוס , 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 לא משתנים. ב-Metrics Explorer אפשר לראות את פירוט קודי התגובה שדווחו לאורך זמן.

יצירת התראות

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

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

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

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

בתמונה הזו:

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

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

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

סוגי התראות

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

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

למידע נוסף, קראו את המאמר סוגים של מדיניות התראות.

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

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

• ניהול מדיניות ההתראות באמצעות מסוף Cloud
• ניהול מדיניות ההתראות באמצעות Cloud Monitoring API

יצירת התראה

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

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

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

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

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

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

   כניסה לדף Monitoring

2. בוחרים באפשרות Alerting.
3. בוחרים באפשרות Edit Notifications Channel כדי להגדיר איך ההתראה תשלח את ההודעה. בדוגמה הזו, תשתמשו בכתובת האימייל שלכם.
1. ב-Email channel, לוחצים על Add New.
2. מזינים את כתובת האימייל (Email Address) ואת השם המוצג (Display Name).
3. לוחצים על שמירה.
4. בוחרים באפשרות Alerting.
5. לוחצים על Create Policy.
6. בוחרים מרווח זמן, למשל 7 ימים.
7. בקטע תנאים להתראה, בוחרים באפשרות New condition:
1. לוחצים על Select a Metric, בוחרים באפשרות Consumed API כמשאב ובאפשרות Request Count כמדד, ואז לוחצים על Apply.
   הערה: אם המדד Request Count לא מופיע ברשימת המדדים, יוצאים ושולחים כמה בקשות API. אפשר לבחור מדד רק אם יש נתונים קיימים לגביו.
2. (אופציונלי) מתחת לתרשים מופיעה רשימה של service,‏ quota_metrics,‏ method של ה-API ו-value של המדד. בוחרים באפשרות הוספת מסנן כדי לסנן את הנתונים על סמך המידע הזה. לדוגמה, אפשר להשתמש במסנן כדי לציין שההתראה תופעל רק אם השיטה שווה ל-google.places.Autocomplete.http.
3. בקטע Transform data, בוחרים באפשרות 5 min בשדה חלון זמן דינמי ובאפשרות 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. לוחצים על Create Policy.
11. שולחים כמה בקשות API. כדי ליצור את ההתראה באימייל, צריך לשלוח יותר משתי בקשות API תוך חמש דקות.
12. אחרי שמקבלים את האימייל לגבי ההתראה, נכנסים לדף Alerting.
    1. בטבלה שבה מופיעות ההתראות, לוחצים על ההתראה כדי לראות מידע נוסף.
    2. לוחצים על שם ההתראה כדי לראות מידע עליה, כולל תרשים שמציג את האירוע שהפעיל אותה.

מקורות מידע שקשורים לנושא

למידע נוסף על התראות, אפשר לעיין במאמרים הבאים:

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