사용률이 저조한 예약 추천 구성

이 페이지에서는 활용도가 낮은 온디맨드 예약 추천 구성을 보고 수정하는 방법을 설명합니다. 수신되는 추천 수를 늘리거나, 사용하려는 예약을 삭제하기 위해 더 적은 수의 추천이 표시되도록 구성을 수정할 수 있습니다.

추천을 맞춤설정하는 데 사용할 수 있는 파라미터에 대한 자세한 내용은 올바른 구성 파라미터 선택을 참조하세요.
유휴 또는 사용률이 낮은 예약에 관한 추천을 받을 때 취할 조치에 관한 자세한 내용은 유휴 예약 권장사항 보기 및 적용 또는 사용률이 낮은 예약 권장사항 보기 및 적용을 참조하세요.

시작하기 전에

아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음과 같이 Compute Engine에 인증하면 됩니다.

Select the tab for how you plan to use the samples on this page:
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

추천 구성

사용률이 낮은 상태 예약 추천을 구성하려면 다음을 수행합니다.

현재 구성을 가져와서 구성의 JSON 파일을 가져옵니다.
구성 파일을 JSON 형식으로 수정합니다.
새 구성 파일을 업로드하여 변경사항을 적용합니다.

현재 구성 가져오기

Google Cloud CLI 또는 REST를 사용하여 프로젝트의 사용률이 낮은 상태 예약 추천에 대한 현재 구성을 가져올 수 있습니다.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한이 있어야 합니다.

프로젝트에 대한 recommender.computeRightSizeResourceRecommender.get

다음 방법 중 하나를 사용하여 이 작업을 완료합니다.

gcloud

현재 구성 파라미터를 가져오려면 gcloud recommender recommender-config describe 명령어를 사용하고 google.compute.RightSizeResourceRecommender를 추천자 ID로 사용합니다.

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

다음을 바꿉니다.

ZONE을 추천을 나열할 예약이 포함된 영역으로 바꿉니다.
BILLING_ACCOUNT_ID를 결제 계정의 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를 추천자 ID로 지정합니다.

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

다음을 바꿉니다.

PROJECT_ID: 추천자 구성을 수정하려는 프로젝트의 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의 값을 수정하고 프로젝트의 새 구성을 업로드합니다.

관찰 기간은 P로 시작하는 문자열, 일 수에 해당하는 정수(7 최솟값 및 30 최댓값), D를 사용하여 7일에서 30일 사이의 값으로 설정할 수 있습니다. 예를 들면 다음과 같습니다.

관찰 기간이 7일이면 "P7D"를 사용합니다.
관찰 기간이 30일이면 "P30D"를 사용합니다.

마찬가지로 under_utilized_reservation_utilization_threshold의 값을 수정하여 사용량 기준점을 설정하고 프로젝트의 새 구성을 업로드하여 사용량이 부족한 예약 추천을 트리거합니다. 예를 들면 다음과 같습니다.

기준점이 80%인 경우 "0.8"입니다.

새 구성을 업로드한 후 적용되는 데 약 48시간이 걸립니다. 그 때까지는 생성된 모든 추천이 이전 구성을 사용합니다.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한이 있어야 합니다.

구성을 볼 수 있는 프로젝트에 대한 recommender.computeRightSizeResourceRecommender.get 권한
구성을 수정할 수 있는 프로젝트에 대한 recommender.computeRightSizeResourceRecommender.update 권한

다음 방법 중 하나를 사용하여 이 작업을 완료합니다.

gcloud

구성 파라미터를 업데이트하려면 gcloud recommender recommender-config update 명령어를 사용하고 google.compute.RightSizeResourceRecommender를 추천자 ID로 사용합니다.

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: 결제 계정의 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

구성을 업데이트하려면 recommenders.updateConfig 메서드에 PATCH 요청을 수행하고 google.compute.RightSizeResourceRecommender를 추천자 ID로 지정합니다.

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: 추천자 구성을 수정하려는 프로젝트의 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"
}

다음 단계

유휴 예약 권장사항을 보고 적용하는 방법 알아보기
사용률이 저조한 예약 권장사항을 보고 적용하는 방법 알아보기