Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

MySQL ワークロードのエージェントを設定する

このドキュメントでは、Compute Engine インスタンスにコンピューティングワークロード用エージェントをインストールし、これらのコンピューティングインスタンスで実行されている MySQL ワークロードに接続するようにエージェントを構成する方法について説明します。

エージェントをインストールして構成すると、MySQL ワークロードと基盤となるコンピューティングインスタンスから指標が収集され、Workload Manager に送信されます。その後、 Workload Manager の評価を使用して、インフラストラクチャ、オペレーティングシステム、ワークロード構成のベストプラクティスからの逸脱がないか MySQL ワークロードをスキャンできます。

始める前に

コンピューティングワークロード用エージェントをインストールして構成する前に、次の前提条件を満たしていることを確認する必要があります。

1 つ以上のコンピューティングインスタンスに MySQL ワークロードをデプロイしている。
Workload Manager の評価を作成できるサポート対象リージョンを確認している。
管理者が、ワークロードマネージャーの評価を作成して実行するために必要な IAM ロールを付与している。
エージェントに必要な IAM ロールを付与している。
Cloud APIs へのアクセスを有効にしている。

エージェントに必要な IAM ロール

コンピューティングワークロード用エージェントは、認証とリソースへのアクセスに、コンピューティングインスタンスに接続されたサービスアカウントを使用します。 Google Cloud

セキュリティを強化するため、Compute Engine のデフォルトのサービスアカウントではなく、単一目的のサービスアカウントを使用することをおすすめします。

コンピューティングワークロード用エージェントが認証してGoogle Cloud リソースにアクセスするために必要な権限がサービスアカウントに付与されるように、プロジェクトに対する次の IAM ロールをサービスアカウントに付与するよう管理者に依頼してください。 Google Cloud

コンピューティングインスタンスから指標を収集する: コンピューティング閲覧者（roles/compute.viewer）
ワークロードマネージャーデータウェアハウスにデータを書き込む: Workload Manager Insights ライター (roles/workloadmanager.insightWriter)
エージェントログを Cloud Logging に送信する: ログ書き込み（roles/logging.logWriter）
Secret Manager を使用して MySQL インスタンスに接続するパスワードを保存する場合: Secret Manager シークレットアクセサー (roles/secretmanager.secretAccessor)

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

管理者は、カスタムロールや他の事前定義ロールを使用して、必要な権限をサービスアカウントに付与することもできます。

Cloud APIs へのアクセスを有効にする

Compute Engine では、すべての Cloud APIs にすべてのアクセススコープを使用できるようにインスタンスを構成し、インスタンスサービスアカウントの IAM 権限のみを使用してリソースへのアクセスを制御することをおすすめします。 Google Cloud 詳細については、ユーザー管理のサービスアカウントを使用する VM を作成するをご覧ください。

Cloud APIs へのアクセスを制限する場合、コンピューティングワークロード用エージェントには、ホストコンピューティングインスタンスで次の最小 Cloud APIs アクセススコープが必要です。

https://www.googleapis.com/auth/cloud-platform

詳細については、スコープのベストプラクティスをご覧ください。

外部 IP アドレスを持たないコンピューティングインスタンスで MySQL アプリケーションを実行している場合は、インスタンスのサブネットでプライベート Google アクセスを有効にして、コンピューティングワークロード用エージェントが Google API とサービスにアクセスできるようにする必要があります。プライベート Google アクセスを有効にする方法については、プライベート Google アクセスを構成するをご覧ください。

パッケージ管理システムを使用してエージェントをインストールして構成する

このセクションでは、パッケージ管理システムを使用して、コンピューティングインスタンスにコンピューティングワークロード用エージェントをインストールし、MySQL インスタンスに接続するように構成する方法について説明します。

コンピューティングワークロード用エージェントをインストールする手順は次のとおりです。

RHEL

Red Hat Enterprise Linux（RHEL）では、yum パッケージ管理コマンドを使用してコンピューティングワークロード用エージェントをインストールします。このコマンドは、次のタスクを完了します。

エージェントの最新バージョンをダウンロードします。
エージェントの systemd サービス（google-cloud-workload-agent という名前）を作成します。
google-cloud-workload-agent サービスを有効にして開始します。

RHEL ベースのコンピューティングインスタンスにコンピューティングワークロード用エージェントをインストールして構成する手順は次のとおりです。

コンピューティングインスタンスとの SSH 接続を確立します。

ターミナルで、エージェントをインストールします。

sudo tee /etc/yum.repos.d/google-cloud-workload-agent.repo << EOM
[google-cloud-workload-agent]
name=Google Cloud Agent for Compute Workloads
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-workload-agent-$basearch
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-workload-agent

エージェントの構成ファイルを開きます。
```
/etc/google-cloud-workload-agent/configuration.json
```
構成パラメータの説明に従って、必須パラメータの値を指定します。
構成ファイルを保存します。
変更を有効にするには、エージェントを再起動します。

SLES

SUSE Linux Enterprise Server（SLES）では、zypper パッケージ管理コマンドを使用してコンピューティングワークロード用エージェントをインストールします。このコマンドは、次のタスクを完了します。

エージェントの最新バージョンをダウンロードします。
エージェントの systemd サービス（google-cloud-workload-agent という名前）を作成します。
google-cloud-workload-agent サービスを有効にして開始します。

SLES ベースのコンピューティングインスタンスにコンピューティングワークロード用エージェントをインストールして構成する手順は次のとおりです。

コンピューティングインスタンスとの SSH 接続を確立します。

ターミナルで、エージェントをインストールします。

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-workload-agent-$basearch
google-cloud-workload-agent
sudo zypper install google-cloud-workload-agent

エージェントの構成ファイルを開きます。
```
/etc/google-cloud-workload-agent/configuration.json
```
構成パラメータの説明に従って、必須パラメータの値を指定します。
構成ファイルを保存します。
変更を有効にするには、エージェントを再起動します。

Debian

Debian では、apt パッケージ管理コマンドを使用してコンピューティングワークロード用エージェントをインストールします。このコマンドは、次のタスクを完了します。

エージェントの最新バージョンをダウンロードします。
エージェントの systemd サービス（google-cloud-workload-agent という名前）を作成します。
google-cloud-workload-agent サービスを有効にして開始します。

Debian ベースのコンピューティングインスタンスにコンピューティングワークロード用エージェントをインストールして構成する手順は次のとおりです。

コンピューティングインスタンスとの SSH 接続を確立します。

ターミナルで、エージェントをインストールします。

echo 'deb https://packages.cloud.google.com/apt google-cloud-workload-agent-x86-64-apt main' | sudo tee -a /etc/apt/sources.list.d/google-cloud-workload-agent.list
sudo apt-get update
sudo apt-get install google-cloud-workload-agent

エージェントの構成ファイルを開きます。
```
/etc/google-cloud-workload-agent/configuration.json
```
構成パラメータの説明に従って、必須パラメータの値を指定します。
構成ファイルを保存します。
変更を有効にするには、エージェントを再起動します。

Windows

Windows では、googet パッケージ管理コマンドを使用してコンピューティングワークロード用エージェントをインストールします。このコマンドは、次のタスクを完了します。

エージェントの最新バージョンをダウンロードします。
google-cloud-workload-agent という名前の Windows サービスを作成します。
毎分実行されるスケジュール設定されたタスクを作成して、サービスが実行されているかどうかを確認し、必要に応じてサービスを再起動します。

google-cloud-workload-agent

Windows ベースのコンピューティングインスタンスにコンピューティングワークロード用エージェントをインストールして構成する手順は次のとおりです。

RDP を使用してコンピューティングインスタンスとの接続を確立します。

手順については、 RDP を使用して Windows VM に接続するをご覧ください。

管理者として PowerShell から次のコマンドを実行します。

googet addrepo google-cloud-workload-agent  https://packages.cloud.google.com/yuck/repos/google-cloud-workload-agent-windows-x86_64
googet install google-cloud-workload-agent

エージェントの構成ファイルを開きます。

%ProgramFiles%\Google\google-cloud-workload-agent\conf\configuration.json

構成パラメータの説明に従って、必須パラメータの値を指定します。
構成ファイルを保存します。
変更を有効にするには、エージェントを再起動します。

VM Extension Manager を使用して VM フリートにエージェントをインストールして管理する

VM Extension Manager を設定する

VM Extension Manager を設定するには、次の手順を行います。

VM Extension Manager のドキュメントの始める前にをご覧ください。
VM Extension Manager ポリシーの作成と管理に必要な IAM ロールを設定します。詳しくは以下をご覧ください。

VM フリートにエージェントをインストールする

VM Extension Manager ポリシーを使用して、特定のゾーン内の VM フリートに最新バージョンのコンピューティングワークロード用エージェントをインストールする手順は次のとおりです。

コンソール

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

[VM 拡張機能ポリシー] に移動
[拡張機能ポリシーを作成] をクリックします。
[名前] フィールドに、ポリシーの名前を入力します。
省略可: [説明] フィールドに、ポリシーの説明を入力します。
[優先度] フィールドで、ポリシー間の競合を解決するための優先度番号を指定します。数字が小さいほど優先度が高くなります。デフォルト値は 1000 です。
[リージョン] リストと [ゾーン] リストを使用して、このポリシーを適用するゾーンを選択します。
[拡張機能] セクションで [拡張機能を追加] をクリックし、次の操作を行います。
1. [拡張機能] リストから [Google Cloud の Compute Workloads 用拡張機能] を選択します。
2. [バージョン] フィールドは空欄のままにします。
  
  これにより、ポリシーはコンピューティングワークロード用エージェントの最新バージョンをインストールします。
3. [構成ファイルの内容] フィールドに、エージェントに適用する構成を入力します。
  
  MySQL ワークロードのエージェントでサポートされている構成パラメータについては、構成パラメータをご覧ください。
  
  注: コンピューティングワークロード用エージェントがすでに実行されている VM に VM Extension Manager ポリシーを適用すると、ポリシーによって既存のエージェントのバージョンと構成がポリシーで設定した内容でオーバーライドされます。
  
  エージェントの既存の構成は、それぞれの VM の /etc/google-cloud-workload-agent/ ディレクトリにある BAK ファイルに書き込まれます。
4. [完了] をクリックします。
省略可: ポリシーのロールアウトを必要な VM に制限するには、次の操作を行います。
1. [ラベルを追加] をクリックし、必要な VM を識別するラベルを追加します。
2. [完了] をクリックします。
[作成] をクリックします。

gcloud

gcloud compute zone-vm-extension-policies create POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-workload-extension \
    --config-from-file=google-cloud-workload-extension=CONFIG_FILE_PATH \
    [--description="DESCRIPTION" \]
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY]

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

POLICY_NAME: VM 拡張機能ポリシーの名前。

指定した名前のポリシーがゾーンにすでに存在する場合、コマンドは失敗します。
ZONE: このポリシーを適用するゾーン。
CONFIG_FILE_PATH: コンピューティングワークロード用エージェントが MySQL ワークロードに接続するための構成を含む JSON ファイルのローカルパス。
- あるいは、構成をインライン文字列として指定する場合は、 --config ではなく --config-from-file フラグを使用します。たとえば、 --config=google-cloud-workload-extension="CONFIG"。 Google Cloud --config-from-file の使用をおすすめします。
- --config-from-file または --config のどちらかを使用できますが、同じコマンドで両方を使用することはできません。
- MySQL ワークロードのエージェントでサポートされている構成パラメータについては、構成パラメータをご覧ください。
注: コンピューティングワークロード用エージェントがすでに実行されている VM に VM Extension Manager ポリシーを適用すると、ポリシーによって既存のエージェントのバージョンと構成がポリシーで設定した内容でオーバーライドされます。

エージェントの既存の構成は、それぞれの VM の /etc/google-cloud-workload-agent/ ディレクトリにある BAK ファイルに書き込まれます。
DESCRIPTION: ポリシーの説明（省略可）。
KEY_1=VALUE_1: ポリシーが VM をターゲットにするために使用するラベルを定義する Key-Value ペアのカンマ区切りのリスト。
- ポリシーのターゲットとなる VM には、指定されたすべてのラベルが必要です。
- --inclusion-labels を複数回指定すると、ポリシーは、指定されたセレクタのいずれかに一致する VM をターゲットにします（論理 OR）。このフラグを省略すると、ポリシーは指定されたゾーン内のすべての VM をターゲットにします。
PRIORITY: ポリシーの優先度を定義する 0～65535 の整数。数字が小さいほど優先度が高くなります。デフォルト値は 1000 です。

例:

次のコマンドは、test-project という名前のプロジェクトに test-agent-policy という名前のポリシーを作成します。このポリシーは、ゾーン us-centrail-f にデプロイされたすべての VM に最新バージョンの Agent for Compute Workloads をインストールします。Google Cloud agent-config.json で指定された構成がエージェントに適用されます。

gcloud compute zone-vm-extension-policies create test-agent-policy  \
    --project=test-project \
    --zone=us-central1-f \
    --extensions=google-cloud-workload-extension \
    --config-file-path=google-cloud-workload-extension="/usr/agent-config.json"

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

エージェントが想定どおりに実行されていることを確認する手順は次のとおりです。

RHEL

コンピューティングインスタンスとの SSH 接続を確立します。

エージェントパッケージのステータスを確認します。

systemctl status google-cloud-workload-agent

エージェントパッケージが想定どおりに実行されている場合、出力には active (running) が含まれます。次に例を示します。

google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

SLES

コンピューティングインスタンスとの SSH 接続を確立します。

エージェントパッケージのステータスを確認します。

systemctl status google-cloud-workload-agent

エージェントパッケージが想定どおりに実行されている場合、出力には active (running) が含まれます。次に例を示します。

google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

Debian

コンピューティングインスタンスとの SSH 接続を確立します。

エージェントパッケージのステータスを確認します。

systemctl status google-cloud-workload-agent

エージェントパッケージが想定どおりに実行されている場合、出力には active (running) が含まれます。次に例を示します。

google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

Windows

RDP を使用してコンピューティングインスタンスとの接続を確立します。

手順については、 RDP を使用して Windows VM に接続するをご覧ください。
管理者として PowerShell から次のコマンドを実行します。
```
$(Get-Service -Name 'google-cloud-workload-agent' -ErrorAction Ignore).Status
```
エージェントが想定どおりに実行されている場合、ステータスは Running と表示されます。

構成ファイルの例

次に、コンピューティングワークロード用エージェントが MySQL インスタンスに接続できるようにする構成の例を示します。認証には、MySQL インスタンスが実行されている同じ Google Cloud プロジェクトに保存されている Secret Manager シークレットが使用されます。

{
  "log_level": "INFO",
  "common_discovery": {
    "collection_frequency": "10800s"
  },
  "mysql_configuration": {
    "enabled": true,
    "connection_parameters": {
      "username": "db_user_name",
      "secret": {
        "secret_name": "db_pwd_secret_name",
        "project_id": ""
      },
      "host": "localhost",
      "port": 1433
    }
  }
}

構成パラメータ

次の表に、MySQL ワークロードの評価をサポートするコンピューティングワークロード用エージェントの構成パラメータを示します。

パラメータ
`log_level`	`String` エージェントのロギングレベルを設定するには、必要な値を設定します。使用可能なログレベルは次のとおりです。 `DEBUG` `INFO` `WARNING` `ERROR` デフォルトのログレベルは `INFO` です。Cloud カスタマーケアから指示されない限り、ロギングレベルを変更しないでください。
`log_to_cloud`	`Boolean` エージェントのログを Cloud Logging にリダイレクトするには、 `true` を指定します。デフォルト値は `true` です。
`agent_properties.log_usage_metrics`	`Boolean` エージェントの健全性指標のロギングを有効にするには、値を `true`に設定します。デフォルト値は `false` です。
`common_discovery.collection_frequency`	`Duration` エージェントのワークロード検出サービスを実行する頻度を秒単位で指定します。デフォルト値は `10800s` です。このパラメータの値は小文字の `s` で終わるようにしてください。
`mysql_configuration.enabled`	`Boolean` エージェントが MySQL インスタンスから指標を収集できるようにするには、値を `true` に設定します。デフォルト値は `false`です。重要: 他の MySQL 固有のエージェントパラメータを機能させるには、 `mysql_configuration.enabled` を `true` に設定する必要があります。
`mysql_configuration.connection_parameters.username`	`String` エージェントが MySQL インスタンスのクエリに使用するユーザーアカウントを指定します。
`mysql_configuration.connection_parameters.password`	`String` エージェントが MySQL インスタンスのクエリに使用するユーザーアカウントのパスワード（書式なしテキスト）を指定します。書式なしテキストパスワードを指定する代わりに、 `secret.name` パラメータと `secret.project_id` パラメータを使用することをおすすめします。認証の場合、エージェントは次の優先順位を使用します。指定されている場合、`secret` パラメータセットは `password` パラメータよりも優先されます。エージェントの構成ファイルで設定する認証オプションは 1 つだけにすることをおすすめします。
`mysql_configuration.connection_parameters.secret.secret_name`	`String` 省略可。エージェントが MySQL インスタンスのクエリに使用するユーザーアカウントのパスワードを安全に指定するには、パスワードを含む Secret Manager シークレットの名前を指定します。認証の場合、エージェントは次の優先順位を使用します。指定されている場合、`secret` パラメータセットは `password` パラメータよりも優先されます。エージェントの構成ファイルで設定する認証オプションは 1 つだけにすることをおすすめします。
`mysql_configuration.connection_parameters.secret.project_id`	`String` 省略可。`secret.secret_name` パラメータを使用して、指定したユーザーアカウントを認証するには、 Google Cloud Secret Manager シークレットが保存されているプロジェクトのプロジェクト ID を指定します。シークレットとワークロードが同じ Google Cloud プロジェクトにある場合は、このパラメータの値を空の文字列（`""`）に設定します。
`mysql_configuration.connection_parameters.host`	`String` MySQL ホスト名を指定します。
`mysql_configuration.connection_parameters.port`	`Int` MySQL インスタンスがクエリを受け付けるポートを指定します。

次のステップ

評価を作成して実行する
MySQL のワークロードマネージャーのベストプラクティスについて学習する

MySQL ワークロードのエージェントを設定する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

エージェントに必要な IAM ロール

Cloud APIs へのアクセスを有効にする

パッケージ管理システムを使用してエージェントをインストールして構成する

RHEL

SLES

Debian

Windows

VM Extension Manager を使用して VM フリートにエージェントをインストールして管理する

VM Extension Manager を設定する

VM フリートにエージェントをインストールする

コンソール

gcloud

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

RHEL

SLES

Debian

Windows

構成ファイルの例

構成パラメータ

次のステップ

MySQL ワークロードのエージェントを設定する