שימוש במדדי מכסות API פשוטים ב-Cloud Monitoring

במאמר הזה מוסבר איך להשתמש במדדי המכסה הפשוטים של Compute Engine API בלוחות הבקרה, במדיניות ההתראות ובשאילתות של Cloud Monitoring.

מדדים פשוטים של מכסות ל-API

כדי לשפר את יכולת הגילוי והניהול של המכסה של Compute Engine API, Cloud de Confiance by S3NS צמצמנו את מספר מדדי המכסה על ידי איחוד מדדים למספר קטן יותר של קבוצות מכסה. בנוסף, מדדי המכסה הפשוטים האלה מציעים מגבלות גבוהות יותר לכל קבוצת מכסות.

מדדי מכסות של API קודם ו-API פשוט

בטבלה הבאה מפורטים מדדי המכסות של API מדור קודם והמדדים המקבילים הפשוטים שלהם:

מדדי מכסה של API מדור קודם מדד מכסת API פשוט
compute.googleapis.com/list_requests compute.googleapis.com/global_reads
בקשות קריאה לדקה
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
‫compute.googleapis.com/default
מדד מכסה מדור קודם לשיטות שמציגות ברשימה משאבים של Compute Engine.
compute.googleapis.com/get_macsec_config_requests
compute.googleapis.com/license_verification_requests
compute.googleapis.com/default
מדד מכסה מדור קודם לשיטות גלובליות שיוצרות, משנות או מוחקות משאבי Compute Engine.		 compute.googleapis.com/global_writes
בקשות לשינוי לדקה
compute.googleapis.com/global_resource_write_requests
compute.googleapis.com/heavy_weight_write_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_delete_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_create_requests
compute.googleapis.com/address_move_requests
compute.googleapis.com/project_set_common_instance_metadata_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_announce_requests
compute.googleapis.com/license_insert_requests
compute.googleapis.com/heavy_weight_read_requests_per_region compute.googleapis.com/reads_per_region
בקשות קריאה לדקה לכל אזור
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region
מדד מכסה מדור קודם לשיטות אזוריות ושיטות של תחום מוגדר שמציגות משאבים של Compute Engine.
compute.googleapis.com/license_verification_requests_per_region
compute.googleapis.com/instance_list_referrers_requests_per_region
compute.googleapis.com/operation_read_requests_per_region
compute.googleapis.com/network_endpoint_list_requests_per_region
compute.googleapis.com/regional_network_endpoint_list_requests_per_region
compute.googleapis.com/get_serial_port_output_requests_per_region
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_write_requests_per_region compute.googleapis.com/writes_per_region
בקשות לשינוי נתונים לדקה לכל אזור
‫compute.googleapis.com/default_per_region
מדד מכסה מדור קודם לשיטות אזוריות ואזוריות שיוצרות, משנות או מוחקות משאבי Compute Engine.
compute.googleapis.com/global_resource_write_requests_per_region
compute.googleapis.com/network_endpoint_write_requests_per_region
compute.googleapis.com/regional_network_endpoint_write_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_create_requests_per_region
compute.googleapis.com/address_move_requests_per_region
compute.googleapis.com/simulate_maintenance_event_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_delete_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_announce_requests_per_region
compute.googleapis.com/recommend_locations_requests_per_region compute.googleapis.com/recommend_locations_per_region
בקשות RegionInstances RecommendLocations לדקה לכל אזור
compute.googleapis.com/cache_invalidation_requests compute.googleapis.com/global_cache_invalidation_requests
בקשות לביטול תוקף של מטמון לדקה

שימוש במדדים הפשוטים בלוחות הבקרה של Cloud Monitoring

כדי לעקוב אחרי השימוש ב-Compute Engine API בהשוואה למדדי ה-API הפשוטים, מוסיפים מסננים למדדים האלה בלוחות הבקרה, בהתראות ובשאילתות של Cloud Monitoring.

יצירת מרכז בקרה שמשתמש במדדי מכסת API פשוטים

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

  1. במסוף Cloud de Confiance , עוברים אל Monitoring:

    מעבר למעקב

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

  3. לוחצים על יצירת מרכז בקרה בהתאמה אישית.

  4. בסרגל הכלים של לוח הבקרה, לוחצים על הוספת ווידג'ט ובוחרים סוג ווידג'ט (לדוגמה, תרשים קו). הדף Configure widget (הגדרת הווידג'ט) ייפתח.

  5. בקטע Select a metric (בחירת מדד), מבצעים את הפעולות הבאות:

    1. בוחרים באפשרות Consumer Quota בשביל המשאב.
    2. בוחרים באפשרות Quota (מכסה) בקטגוריית המדדים.
    3. בוחרים את המדד Rate quota usage ולוחצים על Apply.

  6. בקטע Add filter, משתמשים במסנן quota_metric ובוחרים את מדד המכסה המתאים של ה-API הפשוט. במאמר מדדי מכסות לממשקי API מדור קודם ומדדים פשוטים מוסבר איך למצוא את המדד הפשוט.

  7. לוחצים על אישור כדי להוסיף את הווידג'ט ללוח הבקרה.

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

שינוי לוח בקרה שמוגדר בו מדד מכסה מדור קודם

כדי לעדכן מרכז בקרה שמכיל מדד מדור קודם:

  1. במסוף Cloud de Confiance , עוברים אל Monitoring:

    מעבר למעקב

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

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

  4. לוחצים על Edit.

  5. מוצאים את הווידג'ט שרוצים לעדכן ועורכים אותו.

  6. בקטע Select a metric, מעדכנים את המסנן שמכיל את המדד מדור קודם:

    1. בשדה Filter, בוחרים באפשרות quota_metric.
    2. בשדה Value, מעדכנים את הערך הנוכחי למדד המכסה המתאים ב-API הפשוט. כדי למצוא את המדד החדש במקום המדד מדור קודם, אפשר לעיין במאמר מדדים של מכסות לממשקי API מדור קודם ומפושטים. לדוגמה, שינוי של compute.googleapis.com/read_requests ל-compute.googleapis.com/global_reads.

  7. כדי להחיל את השינויים, לוחצים על אישור.

שימוש במדדי מכסות API פשוטים במדיניות התראות של Cloud Monitoring

כדי לעקוב אחרי השימוש ב-Compute Engine API בהשוואה למדדי ה-API הפשוטים, מוסיפים מסננים למדדים האלה במדיניות ההתראות של Cloud Monitoring.

יצירת מדיניות התראות שמשתמשת במדדי מכסות API פשוטים

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

  1. במסוף Cloud de Confiance , עוברים אל Monitoring:

    מעבר למעקב

  2. בחלונית הניווט, בוחרים באפשרות התראות.

  3. לוחצים על יצירת מדיניות.

  4. בקטע Select a metric (בחירת מדד), מבצעים את הפעולות הבאות:

    1. בוחרים באפשרות Consumer Quota בשביל המשאב.
    2. בוחרים באפשרות Quota (מכסה) בקטגוריית המדדים.
    3. בוחרים את המדד Rate quota usage ולוחצים על Apply.

  5. בקטע Add filter, משתמשים במסנן quota_metric ובוחרים את מדד המכסה המתאים של ה-API הפשוט. במאמר מדדי מכסות לממשקי API מדור קודם ומדדים פשוטים מוסבר איך למצוא את המדד הפשוט.

  6. מגדירים את התנאי, את ערוצי ההתראות ואת התיעוד לפי הצורך.

  7. לוחצים על שמירת המדיניות.

אפשר גם להשתמש ב-Terraform Provider כדי ליצור מדיניות התראות בפרויקט. Cloud de Confiance by S3NS Cloud de Confiance מידע נוסף זמין במאמר יצירת מדיניות התראות באמצעות Terraform.

שינוי מדיניות התראות שמשתמשת במדד מכסה מדור קודם

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

  1. במסוף Cloud de Confiance , עוברים אל Monitoring:

    מעבר למעקב

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

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

  4. בקטע Select a metric, מעדכנים את המסנן שמכיל את המדד מדור קודם:

    1. בשדה Filter, בוחרים באפשרות quota_metric.
    2. בשדה Value, מעדכנים את הערך למדד המכסה המתאים של ה-API הפשוט. כדי למצוא את המדד החדש במקום המדד מדור קודם, אפשר לעיין במאמר מדדים של מכסות לממשקי API מדור קודם ומפושטים. לדוגמה, שינוי של compute.googleapis.com/read_requests ל-compute.googleapis.com/global_reads.

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

  6. לוחצים על שמירת המדיניות.

שימוש במדדי מכסות פשוטים בשאילתות של Cloud Monitoring

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

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

דוגמה 1:

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

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/read_requests"}[1m])

שאילתה ששונתה באמצעות מדד פשוט:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/global_reads"}[1m])

דוגמה 2:

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

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/heavy_weight_write_requests_per_region"}[1m])

שאילתה ששונתה באמצעות מדד פשוט:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/writes_per_region"}[1m])