マシンタイプの推奨事項を構成する

このページでは、マシンタイプの推奨事項の構成を表示して変更する方法について説明します。推奨されるマシンタイプを変更して、生成される推奨事項に優先するマシンシリーズのみを含めることができます。メモリに関する推奨事項の生成に使用される指標を変更して、推奨事項の精度を高めることもできます。構成の変更はプロジェクト レベルで適用されます。

マシンタイプの推奨事項の詳細については、VM のマシンタイプに関する推奨事項を適用するをご覧ください。

始める前に

  • まだ設定していない場合は、認証を設定します。認証とは、 Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

必要なロール

マシンタイプの推奨事項を変更するために必要な権限を取得するには、プロジェクトに対する Compute Recommender 管理者 （roles/recommender.computeAdmin）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、マシンタイプの推奨事項の変更に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

マシンタイプの推奨事項を変更するには、次の権限が必要です。

  • プロジェクトのマシンタイプに関する推奨事項の構成（recommender.computeInstanceMachineTypeRecommenderConfig.get）を確認します。
  • マシンタイプに関する推奨事項の構成を変更します。プロジェクトに対する recommender.computeInstanceMachineTypeRecommenderConfig.update

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

推奨事項を構成する

マシンタイプの推奨事項を構成する手順は次のとおりです。

  1. 構成の JSON ファイルを取得するために、現在の構成を取得します。
  2. JSON 形式の構成ファイルを編集します。
  3. 新しい構成ファイルをアップロードして、変更を適用します。

現在の構成を取得する

プロジェクトのマシンタイプの推奨事項に関する現在の構成は、Google Cloud CLI を使用して取得できます。

gcloud

現在の構成パラメータを取得するには、gcloud beta recommender recommender-config describe コマンドを使用し、Recommender ID として google.compute.instance.MachineTypeRecommender を指定します。

gcloud beta recommender recommender-config describe google.compute.instance.MachineTypeRecommender \
  --project=PROJECT_ID \
  --location=ZONE

次のように置き換えます。

  • PROJECT_ID: オブジェクトの ID。
  • ZONE: 現在の構成を取得する対象のゾーン。

このコマンドから返される Recommender 構成に、変更可能なサブフィールド preferred_machine_types と memory_metrics が含まれています。

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.MachineTypeRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "preferred_machine_types": "STANDARD_AND_CUSTOM",
      "memory_metrics": "MONITORING_AGENT_ONLY"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-08-20T04:41:15.330351Z"
}

構成をローカル ファイルに保存して、後で編集してアップロードできるようにするには、次のコマンドを実行します。

gcloud beta recommender recommender-config describe \
  google.compute.instance.MachineTypeRecommender \
  --project=PROJECT_ID \
  --location=ZONE > LOCAL_FILE_PATH_AND_NAME

推奨事項の設定を編集する

この構成では、次のパラメータをカスタマイズできます。

  • preferred_machine_types: 受け取るマシンタイプの推奨事項。
  • memory_metrics: メモリ指標を使用して推奨事項を生成する方法。

マシンタイプに関する推奨事項のオプション

取得するマシンタイプの推奨事項を指定するには、preferred_machine_types 設定を次のいずれかの値に変更します。

  • DEFAULT: デフォルト値は STANDARD_AND_CUSTOM です。
  • STANDARD_AND_CUSTOM: 標準マシンタイプとカスタム マシンタイプから最適なものを推奨します。
  • STANDARD_ONLY: 標準マシンタイプから最適なもののみを推奨します。

メモリに関する推奨事項のオプション

推奨事項の生成に使用されるメモリ指標には、次の値を設定できます。

  • MEMORY_METRICS_DEFAULT: デフォルトの指標を使用して推奨事項を生成します。
  • MEMORY_METRICS_ALL: 使用可能なすべての指標を使用して推奨事項を生成します。
  • MONITORING_AGENT_ONLY: Cloud Monitoring Ops エージェントによって収集された指標のみを使用します。
  • Ops エージェントを使用しないで、メモリに関する推奨事項を受信しない場合は、MEMORY_AGENT_ONLY 値を使用して推奨事項を無効にします。

メモリ使用量に関するより正確な推奨事項を取得するには、Ops エージェントを使用します。

プロジェクトに対する構成を更新する

マシンタイプの推奨事項の構成を更新するには、構成値を変更し、プロジェクトの新しい構成をアップロードします。推奨されるマシンタイプ、推奨に使用されるメモリ指標、または両方の値を同じリクエストで変更できます。

新しい構成をアップロードした後、変更が適用されるまでに約 48 時間かかります。それまでは、生成された推奨事項は以前の構成を使用します。

gcloud

構成パラメータを更新するには、gcloud beta recommender recommender-config update コマンドを使用し、Recommender ID として google.compute.instance.MachineTypeRecommender を指定します。

gcloud beta recommender recommender-config update google.compute.instance.MachineTypeRecommender\
  --project=PROJECT_ID \
  --location=ZONE \
  --config-file=LOCAL_FILE_PATH_AND_NAME \
  --etag=ETAG

次のように置き換えます。

  • PROJECT_ID: オブジェクトの ID。
  • ZONE: 現在の構成を取得する対象のゾーン。
  • LOCAL_FILE_PATH_AND_NAME: 現在の構成を含む JSON ファイルのパス。
  • ETAG: 現在の構成の ETag 値。この値は、前のコマンドの出力で確認できます。

構成ファイル内で、構成パラメータを更新した recommenderGenerationConfig オブジェクトのみを指定します。構成をローカル ファイルに保存した場合は、etag 値をコピーしてから、recommenderGenerationConfig 値を除くすべてのフィールドを削除します。

たとえば、標準マシンタイプのみの推奨事項を取得するには、次の構成ファイルを使用します。

{
  "params": {
    "preferred_machine_types": "STANDARD_ONLY"
  }
}

コマンドが成功すると、パラメータが変更された新しい構成を示す、次のようなレスポンス本文が返されます。

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.MachineTypeRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "preferred_machine_types": "STANDARD_ONLY"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-08-20T05:00:05Z"
}

次のステップ