VM Extension Manager のポリシーを使用して Ops エージェントをインストールする

VM Extension Manager ポリシーを使用すると、Compute Engine VM のフリートに Ops エージェントをインストールできます。拡張機能ポリシーを使用すると、 Google Cloud プロジェクト全体または特定のゾーン内に Ops エージェントをグローバルにインストールし、エージェントのバージョンを更新して、カスタム構成をエージェントに適用できます。

始める前に

Ops エージェントを管理する VM Extension Manager 拡張機能ポリシーを作成する前に、次の操作を行います。

• VM Extension Manager の一般的な情報を確認する。

• サポートされているオペレーティング システムを確認して、Ops エージェントと VM Extension Manager の両方がオペレーティング システムでサポートされていることを確認します。

• VM にすでにインストールされているオブザーバビリティ エージェントを削除します。

• Ops エージェントと VM Extension Manager で使用される API を有効にします。

• Ops エージェントが使用するロールを付与する。

• VM Extension Manager の使用に必要なロールを付与します。

• コマンドライン インターフェースを使用して拡張機能ポリシーを作成して管理する場合は、Google Cloud CLI をインストールします。

  ゾーン VM 拡張機能ポリシーは、Google Cloud コンソールまたは Google Cloud CLI（gcloud）を使用して作成し、管理できます。グローバル VM 拡張機能ポリシーは、gcloud を使用して作成し、管理します。

既存のオブザーバビリティ エージェントを削除する

Ops エージェントの VM Extension Manager ポリシーを作成する前に、Ops エージェントのインスタンス、または以前の Monitoring エージェントのインスタンスと Logging エージェントのインスタンスがすでに VM に存在しないことを確認してください。同じ VM で Ops エージェントと以前のエージェントを実行すると、重複したログの取得や、指標の取得での競合が発生することがあります。

拡張機能ポリシーを使用して、別のオブザーバビリティ エージェントがすでにインストールされている VM に Ops エージェントをインストールすると、ポリシーによってエージェントがインストールされますが、競合が検出されるため、エージェントは実行されません。

既存のエージェントを削除する方法は、エージェントがインストールされた方法によって異なります。

• VM Manager OS Config ポリシーによってインストールされたエージェント。これには次のものが含まれます。

  • VM の作成時にGoogle Cloud コンソールを使用してインストールされた Ops エージェント。
  • 一般提供の VM Manager OS Config ポリシーによってインストールされた Ops エージェント。
  • ベータ版の VM Manager OS Config ポリシーによってインストールされた Ops エージェント、以前の Monitoring エージェント、または Logging エージェント。

  これらのポリシーを使用して VM を識別する方法については、Ops エージェントの OS ポリシーの対象となる VM を検出するをご覧ください。

  エージェントのアンインストールと OS Config ポリシーの削除については、Ops エージェントの OS ポリシーの対象となる VM で Ops エージェントをアンインストールするをご覧ください。

• インストール スクリプトを使用して手動でインストールされたエージェント。エージェントのアンインストールについては、以下をご覧ください。

  • Ops エージェント: エージェントをアンインストールします。
  • 以前の Monitoring エージェント: エージェントをアンインストールします。
  • 以前の Logging エージェント: エージェントをアンインストールします。

Ops エージェントの使用に必要な API を有効にする

Ops エージェントを使用してログと指標を書き込むには、 Google Cloud プロジェクトで Cloud Logging API と Cloud Monitoring API を有効にする必要があります。

API を有効にするために必要なロール

API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法を学習する。

API を有効にする

Ops エージェントの使用に必要なロールを付与する

Ops エージェントを使用してログと指標を書き込むために必要な権限を取得するには、サービス アカウントに対する次の IAM ロールを付与するよう管理者に依頼してください。

• ログを書き込むには: Logging ログ書き込み （roles/logging.logWriter）
• 指標を書き込むには: Monitoring 指標の書き込み （roles/monitoring.metricWriter）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

ロールと Ops エージェントの詳細については、Ops エージェントを認可するをご覧ください。

VM Extension Manager で使用される API を有効にする

VM Extension Manager は Compute Engine API を使用します。 Google Cloud プロジェクトでこの API が有効になっていない場合は、有効にします。

Compute Engine API を有効にする

VM Extension Manager の使用に必要なロールを付与する

VM 拡張機能ポリシーの作成に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

• 拡張機能ポリシーを作成するには: VM 拡張機能ポリシー管理者 （roles/compute.vmExtensionPolicyAdmin）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

これらの事前定義ロールには、VM 拡張機能ポリシーの作成に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

VM 拡張機能ポリシーを作成するには、次の権限が必要です。

• 拡張機能ポリシーを作成するには: compute.vmExtensionPolicies.create

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

Compute Engine の IAM ロールと権限の詳細については、Compute Engine のロールと権限をご覧ください。

Google Cloud CLI をインストールする

VM 拡張機能ポリシーは、 Google Cloud コンソールまたは Google Cloud CLI（gcloud）を使用して作成し、管理できます。gcloud を使用するには、まず Google Cloud CLI をインストールする必要があります。

インストールされているコンポーネントを確認するには、次のコマンドを実行します。

gcloud components list

最新バージョンがインストールされていることを確認するには、次のコマンドを実行します。

gcloud components update

ポリシーの競合と優先度

VM Extension Manager は、新しいポリシーごとに優先度を関連付けます。数値が小さいほど優先度が高くなります。デフォルトの優先度は 1000 です。VM は、Ops エージェントなどの拡張機能の複数のポリシーの対象になりますが、VM で有効になる Ops エージェント拡張機能のポリシーは 1 つだけです。

VM Extension Manager は、優先度を使用して VM に適用されたポリシー間の競合を解決します。解決プロセスの詳細については、ポリシーの優先度と競合の解決をご覧ください。

グローバル ポリシーのポリシー ロールアウト プラン

VM Extension Manager のグローバル ポリシーは、ロールアウト プランを使用して、ポリシーをターゲット VM に配布する方法を決定します。ロールアウト プランには次の 2 種類があります。

• 事前定義のロールアウト プラン。事前定義のロールアウト プランは 2 つあり、gcloud CLI コマンドの --rollout-predefined-plan オプションで使用される値によって選択されます。

  • 段階的なロールアウト。Ops エージェントを一定期間にわたってさまざまなゾーンに段階的にデプロイします。このロールアウト プランをおすすめします。

    このロールアウト プランを指定するには、--rollout-predefined-plan=slow_rollout オプションを使用します。

  • 高速ロールアウト。すべてのゾーンとリージョンのすべての対象 VM に Ops エージェントをすぐにデプロイします。

    このロールアウト プランを指定するには、--rollout-predefined-plan=fast_rollout オプションを使用します。

• カスタム ロールアウト プラン。gcloud CLI コマンドの --rollout-custom-plan オプションを使用して指定します。

  カスタム ロールアウト プランを作成するには、 Google Cloud プロジェクトのロールアウト プランのセットに追加します。詳細については、Compute Engine API メソッド rolloutPlans.insert をご覧ください。

ロールアウト プランの詳細については、 グローバル ポリシーのロールアウト プランをご覧ください。

VM 拡張機能ポリシーを作成して Ops エージェントをインストールする

VM Extension Manager を使用すると、VM にインストールする拡張機能を宣言するポリシーを作成できます。Ops エージェントは、使用可能な拡張機能の 1 つです。ポリシーを定義すると、VM ラベルなどの指定した条件に一致する VM に、Ops エージェントなどのサポートされている拡張機能がインストールされ、維持されるようになります。

Ops エージェントの拡張ポリシーを使用すると、次のようなタスクを実行できます。

• フリート全体のインストール: 次の場所に Ops エージェントをインストールします。

  • Google Cloud プロジェクトの 1 つ以上のゾーン内のすべての VM。
  • グローバルなすべての VM（ Google Cloud プロジェクト内）。
  • ラベルで識別される、ゾーン内の VM のサブセット。
  • ラベルで識別される、 Google Cloud プロジェクトのゾーン全体の VM のサブセット。

• バージョン管理:

  • Ops エージェントを常に最新バージョンに更新します。
  • Ops エージェントのバージョンを特定のリリースに固定します。

• 構成管理: ポリシーで管理されているすべての VM の Ops エージェントにカスタム構成を適用します。

以降のセクションでは、特定の条件に従って Ops エージェントをインストールするポリシーの例を示します。

VM Extension Manager は、拡張機能ポリシーによって Ops エージェントがインストールされている場合、Ops エージェント バージョン 2.58.0 以降をサポートします。VM Extension Manager では、以前のバージョンの Ops エージェント、他の方法でインストールされた Ops エージェント インスタンス、以前の Monitoring エージェントまたは Logging エージェントを管理できません。

すべての VM に最新の Ops エージェントをインストールする

ゾーン内またはグローバルにすべての VM に最新バージョンの Ops エージェントをインストールし、新しいバージョンがリリースされたときに Ops エージェントを更新するポリシーを作成するには、次の操作を行います。

コンソール

ゾーンポリシーを作成するには、 Google Cloud コンソールを使用します。

1. Google Cloud コンソールで、[拡張機能ポリシー] ページに移動します。

   [拡張機能のポリシー] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Compute Engine] の結果を選択します。

2. [+ 作成] をクリックします。
3. [名前] フィールドに、ポリシーの名前を入力します。
4. 省略可: [説明] フィールドに、ポリシーの説明を入力します。
5. [優先度] フィールドで、ポリシー間の競合を解決するための優先度番号を指定します。数字が小さいほど優先度が高くなります。デフォルト値は 1,000 です。
6. [ゾーン] リストで、このポリシーを適用するゾーンを選択します。
7. [拡張機能を管理する] セクションで、[拡張機能を追加] をクリックして、次の操作を行います。
   1. [拡張機能] リストから、Google Cloud's Extension for Ops Agent を選択します。
   2. [バージョン] フィールドは空欄のままにします。
8. [作成] をクリックします。

gcloud

ゾーンポリシーまたはグローバル ポリシーを作成するには、gcloud CLI を使用します。

ゾーン

次の gcloud compute zone-vm-extension-policies create コマンドを使用して、ポリシーを作成します。

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 

コマンドの次の変数を置き換えます。

• POLICY_NAME: VM 拡張機能ポリシーの名前。
• PROJECT_ID: プロジェクトの ID。
• ZONE: ターゲット ゾーン（例: us-central1-f）。

gcloud compute zone-vm-extension-policies create コマンドは --version オプションを取ります。--version オプションを省略すると、ポリシーによって最新バージョンがインストールされ、新しいバージョンがリリースされると Ops エージェントが更新されます。

グローバル

次の gcloud compute global-vm-extension-policies create コマンドを使用して、ポリシーを作成します。

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout

コマンドの次の変数を置き換えます。

• POLICY_NAME: VM 拡張機能ポリシーの名前。
• PROJECT_ID: プロジェクトの ID。

gcloud compute global-vm-extension-policies create コマンドは --version オプションを取ります。--version オプションを省略すると、ポリシーによって最新バージョンがインストールされ、新しいバージョンがリリースされると Ops エージェントが更新されます。

すべての VM で Ops エージェントを特定のバージョンに固定する

ゾーン内またはグローバルにすべての VM に特定のバージョンの Ops エージェントをインストールするポリシーを作成するには、次の操作を行います。

コンソール

ゾーンポリシーを作成するには、 Google Cloud コンソールを使用します。

1. Google Cloud コンソールで、[拡張機能ポリシー] ページに移動します。

   [拡張機能のポリシー] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Compute Engine] の結果を選択します。

2. [+ 作成] をクリックします。
3. [名前] フィールドに、ポリシーの名前を入力します。
4. 省略可: [説明] フィールドに、ポリシーの説明を入力します。
5. [優先度] フィールドで、ポリシー間の競合を解決するための優先度番号を指定します。数字が小さいほど優先度が高くなります。デフォルト値は 1,000 です。
6. [ゾーン] リストで、このポリシーを適用するゾーンを選択します。
7. [拡張機能を管理する] セクションで、[拡張機能を追加] をクリックして、次の操作を行います。
   1. [拡張機能] リストから、Google Cloud's Extension for Ops Agent を選択します。
   2. [バージョン] リストから、インストールするバージョンを選択します。バージョン 2.58.0 以降を使用します。
8. [作成] をクリックします。

gcloud

ゾーンポリシーまたはグローバル ポリシーを作成するには、gcloud CLI を使用します。

ゾーン

次の gcloud compute zone-vm-extension-policies create コマンドを使用して、ポリシーを作成します。

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --version=ops-agent=VERSION

コマンドの次の変数を置き換えます。

• POLICY_NAME: VM 拡張機能ポリシーの名前。
• PROJECT_ID: プロジェクトの ID。
• ZONE: ターゲット ゾーン（例: us-central1-f）。
• VERSION: インストールする Ops エージェントのバージョン。バージョン 2.58.0 以降を使用します。

  --version オプションを省略した場合、ポリシーによって最新バージョンがインストールされ、新しいバージョンがリリースされると Ops エージェントが更新されます。最新バージョンをインストールする例をご覧ください。

グローバル

次の gcloud compute global-vm-extension-policies create コマンドを使用して、ポリシーを作成します。

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

コマンドの次の変数を置き換えます。

• POLICY_NAME: VM 拡張機能ポリシーの名前。
• PROJECT_ID: プロジェクトの ID。
• VERSION: インストールする Ops エージェントのバージョン。バージョン 2.58.0 以降を使用します。

  --version オプションを省略した場合、ポリシーによって最新バージョンがインストールされ、新しいバージョンがリリースされると Ops エージェントが更新されます。最新バージョンをインストールする例をご覧ください。

Ops エージェントのバージョンのリストについては、Ops エージェントの GitHub のリリースページをご覧ください。

特定のラベルが付いた VM に Ops エージェントをインストールする

特定のラベルが付いたゾーン内またはグローバルな VM に最新バージョンの Ops エージェントをインストールするポリシーを作成するには、次の操作を行います。

コンソール

ゾーンポリシーを作成するには、 Google Cloud コンソールを使用します。

1. Google Cloud コンソールで、[拡張機能ポリシー] ページに移動します。

   [拡張機能のポリシー] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Compute Engine] の結果を選択します。

2. [+ 作成] をクリックします。
3. [名前] フィールドに、ポリシーの名前を入力します。
4. 省略可: [説明] フィールドに、ポリシーの説明を入力します。
5. [優先度] フィールドで、ポリシー間の競合を解決するための優先度番号を指定します。数字が小さいほど優先度が高くなります。デフォルト値は 1,000 です。
6. [ゾーン] リストで、このポリシーを適用するゾーンを選択します。
7. [拡張機能を管理する] セクションで、[拡張機能を追加] をクリックして、次の操作を行います。
   1. [拡張機能] リストから、Google Cloud's Extension for Ops Agent を選択します。
   2. [バージョン] フィールドは空欄のままにします。
8. [ターゲット VM インスタンス] セクションで、ポリシーの VM を選択します。特定のラベルを持つ VM を選択するには、[ラベルを追加] をクリックして Key-Value ペアを追加します。
9. [作成] をクリックします。

gcloud

ゾーンポリシーまたはグローバル ポリシーを作成するには、gcloud CLI を使用します。

ゾーン

gcloud compute zone-vm-extension-policies create コマンドの --inclusion-labels オプションを使用して、Key-Value ペアのカンマ区切りのリストを指定します。

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

コマンドの次の変数を置き換えます。

• POLICY_NAME: VM 拡張機能ポリシーの名前。
• PROJECT_ID: プロジェクトの ID。
• ZONE: ターゲット ゾーン（例: us-central1-f）。
• KEY1=VALUE1,KEY2=VALUE2: セレクタの包含ラベルを定義する Key-Value ペアのカンマ区切りリスト。VM が含まれるには、セレクタで指定されたすべてのラベル（論理積）が VM に設定されている必要があります。--inclusion_labels オプションを複数回指定すると、ポリシーは、いずれかのセレクタのすべてのラベルと一致する VM をターゲットにします（論理和）。このオプションを省略すると、ポリシーは指定されたゾーン内のすべての VM をターゲットにします。

グローバル

gcloud compute global-vm-extension-policies create コマンドの --inclusion-labels オプションを使用して、Key-Value ペアのカンマ区切りのリストを指定します。

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

コマンドの次の変数を置き換えます。

• POLICY_NAME: VM 拡張機能ポリシーの名前。
• PROJECT_ID: プロジェクトの ID。
• KEY1=VALUE1,KEY2=VALUE2: セレクタの包含ラベルを定義する Key-Value ペアのカンマ区切りリスト。VM が含まれるには、セレクタで指定されたすべてのラベル（論理積）が VM に設定されている必要があります。--inclusion_labels オプションを複数回指定すると、ポリシーは、いずれかのセレクタのすべてのラベルと一致する VM をターゲットにします（論理和）。このオプションを省略すると、ポリシーは指定されたゾーン内のすべての VM をターゲットにします。

すべての VM にカスタム構成で Ops エージェントをインストールする

ゾーン内またはグローバルにすべての VM に最新バージョンの Ops エージェントをインストールし、Ops エージェントのカスタム構成を提供するポリシーを作成するには、次の操作を行います。

コンソール

ゾーンポリシーを作成するには、 Google Cloud コンソールを使用します。

1. Google Cloud コンソールで、[拡張機能ポリシー] ページに移動します。

   [拡張機能のポリシー] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Compute Engine] の結果を選択します。

2. [+ 作成] をクリックします。
3. [名前] フィールドに、ポリシーの名前を入力します。
4. 省略可: [説明] フィールドに、ポリシーの説明を入力します。
5. [優先度] フィールドで、ポリシー間の競合を解決するための優先度番号を指定します。数字が小さいほど優先度が高くなります。デフォルト値は 1,000 です。
6. [ゾーン] リストで、このポリシーを適用するゾーンを選択します。
7. [拡張機能を管理する] セクションで、[拡張機能を追加] をクリックして、次の操作を行います。
   1. [拡張機能] リストから、Google Cloud's Extension for Ops Agent を選択します。
   2. [バージョン] フィールドは空欄のままにします。
   3. [構成ファイルの内容] フィールドに、Ops エージェントの YAML 構成文字列を入力します。
8. [作成] をクリックします。

gcloud

ゾーンポリシーまたはグローバル ポリシーを作成するには、gcloud CLI を使用します。

ゾーン

gcloud compute zone-vm-extension-policies create コマンドの --config-from-file オプションを使用して、構成ファイルを指定します。

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

コマンドの次の変数を置き換えます。

• POLICY_NAME: VM 拡張機能ポリシーの名前。
• PROJECT_ID: プロジェクトの ID。
• ZONE: ターゲット ゾーン（例: us-central1-f）。
• OPS_AGENT_CONFIG_PATH: Ops エージェントの YAML 構成文字列を含むファイルへのパス。このファイルは、gcloud コマンドを実行する環境に存在する必要があります。

  Ops エージェントの構成 YAML は長くなることがあります。構成をファイルに格納して gcloud CLI に渡す方が、コマンドラインで適切な形式の YAML を入力するよりも大幅にエラーが発生しにくくなります。ポリシーの作成後にこのファイルを変更しても、ポリシーは更新されません。ポリシーを更新するには、 gcloud compute zone-vm-extension-policies update コマンドを使用します。

グローバル

gcloud compute global-vm-extension-policies create コマンドの --config-from-file オプションを使用して、構成ファイルを指定します。

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

コマンドの次の変数を置き換えます。

• POLICY_NAME: VM 拡張機能ポリシーの名前。
• PROJECT_ID: プロジェクトの ID。
• OPS_AGENT_CONFIG_PATH: Ops エージェントの YAML 構成文字列を含むファイルへのパス。このファイルは、gcloud コマンドを実行する環境に存在する必要があります。

  Ops エージェントの構成 YAML は長くなることがあります。構成をファイルに格納して gcloud CLI に渡す方が、コマンドラインで適切な形式の YAML を入力するよりも大幅にエラーが発生しにくくなります。ポリシーの作成後にこのファイルを変更しても、ポリシーは更新されません。ポリシーを更新するには、gcloud compute global-vm-extension-policies update コマンドを使用します。

拡張機能ポリシーの作成または更新時に Ops エージェントのカスタム構成を指定すると、ポリシーによってカスタム構成で Ops エージェントがデプロイされます。エージェントを手動で再起動する必要はありません。

構成は拡張機能ポリシーに基づいて保存されるため、パスワードなどの機密データを構成に含めないでください。構成は拡張機能ポリシーに基づいて保存されるため、構成ファイルを変更してもエージェントの構成は変更されません。適切な gcloud コマンドを使用して、ポリシーに基づいて保存されている構成を更新する必要があります。

• ゾーンポリシーの場合は、 gcloud compute zone-vm-extension-policies update コマンドを使用します。
• グローバル ポリシーの場合は、 gcloud compute global-vm-extension-policies update コマンドを使用します。

Ops エージェントのカスタム構成を指定すると、VM Extension Manager は、ターゲット VM の ユーザー指定の構成ファイル用に Ops エージェントが使用する場所に構成をコピーします。

• Linux: /etc/google-cloud-ops-agent/config.yaml
• Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

VM に config.yaml ファイルが存在する場合、拡張機能ポリシーによって上書きされます。

Google Cloud コンソールと gcloud CLI を使用して VM 拡張機能ポリシーを作成する方法については、 拡張機能ポリシーを使用して VM 拡張機能をインストールするをご覧ください。

優先度の高い高速ロールアウト プランで Ops エージェントをインストールする（グローバルのみ）

デフォルトよりも高い優先度と高速ロールアウト プランを使用して、最新バージョンの Ops エージェントをインストールするグローバル ポリシーを作成するには、次の gcloud compute global-vm-extension-policies create コマンドを使用します。

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=fast_rollout \
  --priority=500

コマンドの次の変数を置き換えます。

• POLICY_NAME: VM 拡張機能ポリシーの名前。
• PROJECT_ID: プロジェクトの ID。

Google Cloud プロジェクトのゾーンのサブセットに Ops エージェントをインストールする（グローバルのみ）

Google Cloud プロジェクトのゾーンのサブセットにのみ適用されるグローバル ポリシーを作成するには、ポリシーを適用するゾーンを指定するカスタム ロールアウト プランを使用する必要があります。カスタム ロールアウト プランの作成については、 ロールアウト プランについてをご覧ください。ゾーンのセットを指定するには、ロールアウト プランの作成時に locationSelector.includedLocations フィールドを使用します。

カスタム ロールアウト プランを使用する拡張機能ポリシーを作成するには、次の gcloud compute global-vm-extension-policies create コマンドを使用します。

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/CUSTOM_PLAN_NAME

コマンドの次の変数を置き換えます。

• POLICY_NAME: VM 拡張機能ポリシーの名前。
• PROJECT_ID: プロジェクトの ID。
• CUSTOM_PLAN_NAME: カスタム ロールアウト プランに関連付けられている名前。

Ops エージェントのインストールを確認する

このセクションでは、次の操作を行う方法について説明します。

• Ops エージェントのインストールのステータスまたはバージョンを確認する
• Ops エージェントがテレメトリーを収集していることを確認する

Ops エージェントのインストールのステータスまたはバージョンを確認する

Ops エージェントのステータスまたはバージョンを確認するには、次のいずれかのGoogle Cloud コンソール ページを使用します。

Compute Engine

1. Google Cloud コンソールで [VM インスタンス] ページに移動します。

   [VM インスタンス] に移動

   このページを検索バーで検索する場合は、小見出しが「Compute Engine」の結果を選択します。

2. リストから VM を選択します。
3. [オブザーバビリティ] タブをクリックします。

Cloud Monitoring

1. Google Cloud コンソールで [VM インスタンス] ページに移動します。

   [VM インスタンス] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] の結果を選択します。

2. [リスト] ビューを選択します。

Ops エージェントが VM にインストールされ、ログと指標を収集している場合、エージェントのステータスは [Ops エージェント] ラベルの横にある緑色のチェックマークで示されます。

インストールされているエージェントのバージョンを確認するには、Compute Engine または Monitoring のダッシュボードで [Ops エージェント] ラベルにカーソルを合わせます。

Ops エージェントがテレメトリーを収集していることを確認する

Ops エージェントが正常にインストールされ、正しく実行されている場合、指標は Cloud Monitoring に送信され、ログは Cloud Logging に送信されます。

• 指標の収集の確認については、エージェントは実行されているが、データが取得されないをご覧ください。
• ログの収集の確認については、ログ収集の成功を確認するをご覧ください。

次のステップ

• 拡張機能ポリシーを更新してインストールを変更する。
• 拡張機能ポリシーの問題のトラブルシューティング。
• VM Extension Manager の詳細を確認する。
• Ops エージェントの構成に関する詳細情報を表示する。