הגדרת המלצות לניצול טוב יותר של הזמנות

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

לפני שמתחילים

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

    צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:

    gcloud

    1. התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם. אחרי שנכנסתם לחשבון, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה: 

      gcloud init
  • הגדרת אזור ותחום כברירת מחדל

    • REST

    כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

      התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.

    מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Cloud de Confiance .

הגדרת ההמלצות

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

  1. מקבלים את ההגדרה הנוכחית כדי לקבל את קובץ ה-JSON של ההגדרה.
  2. עורכים את קובץ ההגדרות בפורמט JSON.
  3. מעלים את קובץ ההגדרות החדש כדי להחיל את השינויים.

אחזור ההגדרה הנוכחית

אפשר לקבל את ההגדרה הנוכחית של המלצות לניצול חלקי של מקומות שמורים בפרויקט באמצעות Google Cloud CLI או REST.

כדי לבצע את המשימה הזו, אפשר להשתמש באחת מהשיטות הבאות.

gcloud

כדי לקבל את פרמטרים ההגדרה הנוכחיים, משתמשים בפקודה gcloud recommender recommender-config describe ומזינים google.compute.RightSizeResourceRecommender בתור מזהה הכלי להמלצות:

gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \
  --location=ZONE --billing-account=BILLING_ACCOUNT_ID

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ZONE עם האזור שמכיל את השריונים שרוצים לראות לגביהם המלצות.
  • BILLING_ACCOUNT_ID במזהה של החשבון לחיוב.

לדוגמה:

gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \
  --location=us-central1-c --billing-account=my-billing-account-id

הפקודה מחזירה את ההגדרה של הכלי להמלצות, כולל שדות המשנה שניתנים לשינוי params.under_utilized_reservation_lookback_period ו-params.under_utilized_reservation_utilization_threshold.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P7D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

REST

כדי לאחזר את ההגדרה הנוכחית, משתמשים בשיטה recommenders.getConfig ומציינים את google.compute.RightSizeResourceRecommender כמזהה של שירות ההמלצות:

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט שרוצים לשנות את ההגדרות של הכלי להמלצות.
  • ‫ZONE: האזור שמכיל את הפרויקט.

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

PROJECT_ID=PROJECT_ID
ZONE=ZONE
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: ${PROJECT_ID}" \
https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.RightSizeResourceRecommender/config

הפקודה מחזירה את הגדרות הכלי להמלצות, כולל שדות המשנה שאפשר לשנות: params.under_utilized_reservation_lookback_period ו-params.under_utilized_reservation_utilization_threshold.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P7D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

עדכון ההגדרה של פרויקט

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

אפשר להגדיר את תקופת התצפית לערך של 7 עד 30 ימים, באמצעות מחרוזת שמתחילה ב-P, ואחריה מספר שלם שמייצג את מספר הימים (מינימום 7 ומקסימום 30), ואז D. לדוגמה:

  • לתקופת תצפית של 7 ימים, משתמשים ב-"P7D".
  • לתקופת תצפית של 30 ימים, משתמשים ב-"P30D".

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

  • לסף של 80%, "0.8".

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

כדי לבצע את המשימה הזו, אפשר להשתמש באחת מהשיטות הבאות.

gcloud

כדי לעדכן את פרמטרי ההגדרה, משתמשים בפקודה gcloud recommender recommender-config update ומזינים google.compute.RightSizeResourceRecommender כמזהה של שירות ההמלצות:

gcloud recommender recommender-config update google.compute.RightSizeResourceRecommender\
  --location=ZONE \
  --config-file=CONFIG_FILE_PATH \
  --etag=ETAG \
  --billing-account=BILLING_ACCOUNT_ID

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ZONE: האזור שרוצים לקבל את ההגדרות הנוכחיות שלו
  • ‫CONFIG_FILE_PATH: הנתיב לקובץ ה-JSON עם ההגדרה הנוכחית
  • ‫ETAG: ערך ה-etag של ההגדרה הנוכחית
  • ‫BILLING_ACCOUNT_ID: המזהה של החשבון לחיוב

בקובץ ההגדרות, מציינים רק את האובייקט recommenderGenerationConfig עם פרמטרים ההגדרות המעודכנים. לדוגמה, כדי לציין תקופת תצפית של 21 ימים וסכום מינימלי של 80% מההזמנה שלא נוצל, משתמשים בקובץ התצורה הבא:

{
  "params": {
    "under_utilized_reservation_lookback_period": "P21D",
    "under_utilized_reservation_utilization_threshold": "0.8"
  }
}

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

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P21D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

REST

כדי לעדכן את ההגדרות, שולחים בקשת PATCH אל ה-method‏ recommenders.updateConfig ומציינים את google.compute.RightSizeResourceRecommender כמזהה של Recommender:

PATCH https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P21D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\""
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט שרוצים לשנות את ההגדרות של הכלי להמלצות.
  • ‫ZONE: האזור שמכיל את הפרויקט.

שומרים את גוף הבקשה בקובץ, למשל config.json. אחר כך תוכלו להפנות לקובץ כשמעדכנים את הגדרות הכלי להמלצות בפרויקט, באמצעות פקודה שדומה לפקודה הבאה:

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "x-goog-user-project: ${PROJECT_ID}" \
-d @config.json \
https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.RightSizeResourceRecommender/config

הפקודה POST מחזירה גוף תגובה שדומה לזה שמוצג בהמשך, עם ההגדרה החדשה והפרמטרים ששיניתם.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P21D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

המאמרים הבאים