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

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

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

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

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

מדדים קיימים של מכסות API	מדד מכסת API פשוט
compute.googleapis.com/list_requests	Read requests per minute 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.	Mutation requests per minute 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	Read requests per minute 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	Mutation requests per minute 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	RegionInstances RecommendLocations requests per minute per region compute.googleapis.com/recommend_locations_per_region
compute.googleapis.com/cache_invalidation_requests	Cache invalidation requests per minute compute.googleapis.com/global_cache_invalidation_requests

שימוש במדדים פשוטים ב-Cloud Monitoring

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

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

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

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

   מעקב

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

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

4. לוחצים על עריכת מרכז הבקרה ומוסיפים ווידג'ט.

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

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

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

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

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

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

   מעקב

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

3. לוחצים על יצירת מדיניות כדי להוסיף מדיניות התראות.

4. בוחרים מסנן שמתאים למדד שרוצים לעקוב אחריו:

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

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

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

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

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

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