העברת מכסות של ממשקי API ממדדים גלובליים למדדים אזוריים

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

מדדי מכסה אזוריים של API

ממשקי API אזוריים של Compute Engine שהשתמשו במדדי המכסה הגלובלית מועברים לשימוש במדדים האזוריים. ממשקי API גלובליים ממשיכים להשתמש במדדים גלובליים ובמגבלות מכסה. מידע על מגבלות קצב בקשות ל-API עבור מדדים גלובליים

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

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

מדד המכסה הגלובלית של ה-API	מדד מכסת API אזורי
compute.googleapis.com/default	compute.googleapis.com/default_per_region
compute.googleapis.com/read_requests	compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests	compute.googleapis.com/list_requests_per_region
compute.googleapis.com/operation_read_requests	compute.googleapis.com/operation_read_requests_per_region
compute.googleapis.com/heavy_weight_read_requests	compute.googleapis.com/heavy_weight_read_requests_per_region
compute.googleapis.com/heavy_weight_write_requests	compute.googleapis.com/heavy_weight_write_requests_per_region
compute.googleapis.com/global_resource_write_requests	compute.googleapis.com/global_resource_write_requests_per_region

למדדים הבאים אין ממשקי API גלובליים. אם אתם משתמשים במדדים האלה בלוחות הבקרה, בהתראות או בשאילתות של Cloud Monitoring, עליכם להעביר את המדדים האלה למדדים האזוריים המתאימים.

מדד המכסה הגלובלית של ה-API	מדד מכסת API אזורי
compute.googleapis.com/simulate_maintenance_event_requests	compute.googleapis.com/simulate_maintenance_event_requests_per_region
compute.googleapis.com/instance_list_referrers_requests	compute.googleapis.com/instance_list_referrers_requests_per_region
compute.googleapis.com/get_serial_port_output_requests	compute.googleapis.com/get_serial_port_output_requests_per_region
compute.googleapis.com/network_endpoint_write_requests	compute.googleapis.com/network_endpoint_write_requests_per_region
compute.googleapis.com/network_endpoint_list_requests	compute.googleapis.com/network_endpoint_list_requests_per_region

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

• compute.googleapis.com/project_set_common_instance_metadata_requests
• compute.googleapis.com/license_insert_requests

העברה של מדדים מ-Cloud Monitoring

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

עדכון לוח הבקרה של Cloud Monitoring לשימוש במדדים האזוריים

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

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

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

   1. בשדה Filter, בוחרים באפשרות quota_metric.
   2. בשדה Comparator, בוחרים באפשרות =~.

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

      

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

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

   5. אופציונלי: כדי לראות את השימוש במכסה לפי אזור, מרחיבים את הכותרת Grouped ובוחרים באפשרות location בשדה קיבוץ לפי.

6. לוחצים על סגירת העורך.

עדכון מדיניות ההתראות ב-Cloud Monitoring לשימוש במדדי מכסת ה-API האזוריים

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

1. במסוף Google Cloud , בוחרים באפשרות Monitoring.
2. בחלונית הניווט, בוחרים באפשרות התראות. בדף Alerting מוצגים חלוניות עם סיכום מידע, אירועים ומדיניות התראות.
3. לוחצים על מדיניות ההתראות שרוצים לערוך כדי להשתמש במדד אזורי.
4. לוחצים על עריכה כדי לשנות את המדיניות.

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

   1. בשדה Filter, בוחרים באפשרות quota_metric.
   2. בשדה Comparator, בוחרים באפשרות =~.

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

      

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

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

   5. אופציונלי: אם רוצים לקבל התראה לכל אזור לגבי המדד האזורי, מרחיבים את הכותרת Across time series ובוחרים באפשרות location בשדה Time series group by.

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

עדכון שאילתות של Cloud Monitoring לשימוש במדדי המכסה האזוריים

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

פותחים את עורך הקוד ועורכים את השאילתה כמו בדוגמה הבאה:

rate({
   "__name__"="serviceruntime.googleapis.com/quota/rate/net_usage",
   "monitored_resource"="consumer_quota",
   "quota_metric"=~"compute.googleapis.com/read_requests.*"
}[${__interval}])

אם רוצים, אפשר גם לקבץ את התוצאות לפי מיקום באמצעות הפעולה sum by:

sum by (location) (
   rate({
       "__name__"="serviceruntime.googleapis.com/quota/rate/net_usage",
       "monitored_resource"="consumer_quota",
       "quota_metric"=~"compute.googleapis.com/read_requests.*"
   }[${__interval}])
)