Menyiapkan agen untuk workload MySQL

Dokumen ini menunjukkan cara menginstal Agen untuk Compute Workloads di instance Compute Engine, dan mengonfigurasi agen untuk terhubung dengan workload MySQL yang berjalan di instance komputasi tersebut.

Sebelum memulai

Sebelum menginstal dan mengonfigurasi Agen untuk Workload Compute, Anda harus memastikan bahwa prasyarat berikut terpenuhi:

• Anda telah men-deploy beban kerja MySQL di instance komputasi.
• Anda telah memberikan peran IAM yang diperlukan ke akun layanan yang terlampir pada instance komputasi.
• Anda telah mengaktifkan akses ke Cloud API.

Peran IAM yang diperlukan

Agen untuk Compute Workloads menggunakan akun layanan yang terlampir ke instance komputasi untuk autentikasi dan untuk mengakses resource Google Cloud .

Untuk meningkatkan keamanan, sebaiknya gunakan akun layanan khusus daripada menggunakan akun layanan default Compute Engine.

Untuk memastikan bahwa akun layanan memiliki izin yang diperlukan agar Agent for Compute Workloads dapat melakukan autentikasi dengan Google Cloud dan mengakses Google Cloud resource, minta administrator untuk memberikan peran IAM berikut kepada akun layanan di project Anda:

Penting: Anda harus memberikan peran ini ke akun layanan, bukan ke akun pengguna Anda. Kegagalan memberikan peran ke akun utama yang benar dapat menyebabkan error izin.

• Compute Viewer (roles/compute.viewer): untuk mengumpulkan metrik dari instance compute.
• Penulis Insight Workload Manager (roles/workloadmanager.insightWriter): untuk menulis data ke data warehouse Workload Manager.
• (Direkomendasikan) Logs Writer (roles/logging.logWriter): untuk mengirim log agen ke Cloud Logging.
• (Opsional) Secret Manager Secret Accessor (roles/secretmanager.secretAccessor): jika Anda menggunakan Secret Manager untuk menyimpan sandi guna terhubung dengan instance MySQL.

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Administrator Anda mungkin juga dapat memberikan izin yang diperlukan kepada akun layanan melalui peran khusus atau peran yang telah ditetapkan lainnya.

Mengaktifkan akses ke Cloud API

Compute Engine merekomendasikan agar Anda mengonfigurasi instance untuk mengizinkan semua cakupan akses ke semua Cloud API dan hanya menggunakan izin IAM akun layanan instance untuk mengontrol akses ke resourceGoogle Cloud . Untuk mengetahui informasi selengkapnya, lihat Membuat VM yang menggunakan akun layanan yang dikelola pengguna.

Jika Anda membatasi akses ke Cloud API, maka Agen untuk Compute Workloads memerlukan cakupan akses Cloud API minimum berikut pada instance komputasi host:

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

Untuk mengetahui informasi selengkapnya, lihat Praktik terbaik cakupan.

Jika Anda menjalankan aplikasi MySQL di instance komputasi yang tidak memiliki alamat IP eksternal, Anda harus mengaktifkan Akses Google Pribadi di subnet instance agar Agen untuk Compute Workloads dapat mengakses Google API dan layanan Google. Untuk mengetahui informasi tentang cara mengaktifkan Akses Google Pribadi, lihat Mengonfigurasi Akses Google Pribadi.

Menginstal dan mengonfigurasi agen

Untuk menginstal Agen untuk Compute Workloads di instance komputasi Anda, dan mengonfigurasinya agar terhubung dengan instance MySQL, selesaikan langkah-langkah berikut:

RHEL

Di Red Hat Enterprise Linux (RHEL), Anda menginstal Agen untuk Compute Workloads menggunakan perintah pengelolaan paket yum. Perintah ini akan menyelesaikan tugas berikut:

• Mendownload agen versi terbaru.
• Membuat layanan systemd untuk agen, yang bernama google-cloud-workload-agent.
• Mengaktifkan dan memulai layanan google-cloud-workload-agent.

Untuk menginstal dan mengonfigurasi Agen untuk Compute Workloads di instance komputasi berbasis RHEL, selesaikan langkah-langkah berikut:

1. Buat koneksi SSH dengan instance komputasi Anda.

2. Di terminal, instal agen:

   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
   

3. Buka file konfigurasi agen:

   /etc/google-cloud-workload-agent/configuration.json
   

4. Tentukan nilai untuk semua parameter wajib, seperti yang dijelaskan dalam Parameter konfigurasi.

5. Simpan file konfigurasi

6. Mulai ulang agen agar perubahan diterapkan.

SLES

Di SUSE Linux Enterprise Server (SLES), Anda menginstal Agen untuk Compute Workloads menggunakan perintah pengelolaan paket zypper. Perintah ini akan menyelesaikan tugas berikut:

• Mendownload agen versi terbaru.
• Membuat layanan systemd untuk agen, yang bernama google-cloud-workload-agent.
• Mengaktifkan dan memulai layanan google-cloud-workload-agent.

Untuk menginstal dan mengonfigurasi Agen untuk Compute Workloads di instance compute berbasis SLES, selesaikan langkah-langkah berikut:

1. Buat koneksi SSH dengan instance komputasi Anda.

2. Di terminal, instal agen:

   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
   

3. Buka file konfigurasi agen:

   /etc/google-cloud-workload-agent/configuration.json
   

4. Tentukan nilai untuk semua parameter wajib, seperti yang dijelaskan dalam Parameter konfigurasi.

5. Simpan file konfigurasi

6. Mulai ulang agen agar perubahan diterapkan.

Debian

Di Debian, Anda menginstal Agen untuk Compute Workloads menggunakan perintah pengelolaan paket apt. Perintah ini menyelesaikan tugas berikut:

• Mendownload agen versi terbaru.
• Membuat layanan systemd untuk agen, yang bernama google-cloud-workload-agent.
• Mengaktifkan dan memulai layanan google-cloud-workload-agent.

Untuk menginstal dan mengonfigurasi Agen untuk Compute Workloads di instance komputasi berbasis Debian, selesaikan langkah-langkah berikut:

1. Buat koneksi SSH dengan instance komputasi Anda.

2. Di terminal, instal agen:

   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
   

3. Buka file konfigurasi agen:

   /etc/google-cloud-workload-agent/configuration.json
   

4. Tentukan nilai untuk semua parameter wajib, seperti yang dijelaskan dalam Parameter konfigurasi.

5. Simpan file konfigurasi

6. Mulai ulang agen agar perubahan diterapkan.

Windows

Di Windows, Anda menginstal Agen untuk Compute Workloads menggunakan perintah pengelolaan paket googet. Perintah ini menyelesaikan tugas berikut:

• Mendownload agen versi terbaru.
• Membuat layanan Windows bernama google-cloud-workload-agent.
• Membuat tugas terjadwal yang berjalan setiap menit untuk memeriksa apakah layanan berjalan dan jika perlu, memulai ulang layanan.

Peringatan: Jangan menghentikan layanan Windows google-cloud-workload-agent secara manual atau menghapus tugas terjadwalnya.

Untuk menginstal dan mengonfigurasi Agen untuk Compute Workloads di instance komputasi berbasis Windows, selesaikan langkah-langkah berikut:

1. Buat koneksi dengan instance komputasi Anda menggunakan RDP.

   Untuk mengetahui informasi tentang cara melakukannya, lihat Menghubungkan ke VM Windows menggunakan RDP.

2. Sebagai administrator, jalankan perintah berikut dari 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
   

3. Buka file konfigurasi agen:

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

4. Tentukan nilai untuk semua parameter wajib, seperti yang dijelaskan dalam Parameter konfigurasi.

5. Simpan file konfigurasi

6. Mulai ulang agen agar perubahan diterapkan.

Memverifikasi penginstalan agen

Untuk memastikan bahwa agen berjalan seperti yang diharapkan, selesaikan langkah-langkah berikut:

RHEL

1. Buat koneksi SSH dengan instance komputasi Anda.

2. Periksa status paket agen:

   systemctl status google-cloud-workload-agent
   

   Jika paket agen berjalan seperti yang diharapkan, output akan berisi active (running). Contoh:

   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

1. Buat koneksi SSH dengan instance komputasi Anda.

2. Periksa status paket agen:

   systemctl status google-cloud-workload-agent
   

   Jika paket agen berjalan seperti yang diharapkan, output akan berisi active (running). Contoh:

   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

1. Buat koneksi SSH dengan instance komputasi Anda.

2. Periksa status paket agen:

   systemctl status google-cloud-workload-agent
   

   Jika paket agen berjalan seperti yang diharapkan, output akan berisi active (running). Contoh:

   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

1. Buat koneksi dengan instance komputasi Anda menggunakan RDP.

   Untuk mengetahui informasi tentang cara melakukannya, lihat Menghubungkan ke VM Windows menggunakan RDP.

2. Sebagai administrator, jalankan perintah berikut dari PowerShell:

   $(Get-Service -Name 'google-cloud-workload-agent' -ErrorAction Ignore).Status
   

   Jika agen berjalan seperti yang diharapkan, Anda akan melihat statusnya sebagai Running.

Contoh file konfigurasi

Berikut adalah contoh konfigurasi yang memungkinkan Agen untuk Compute Workloads terhubung dengan instance MySQL. Untuk autentikasi, secret Secret Manager digunakan, yang disimpan dalam Google Cloud project yang sama dengan instance MySQL yang sedang berjalan.

{
  "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
    }
  }
}

Parameter konfigurasi

Tabel berikut menjelaskan parameter konfigurasi Agen untuk Compute Workloads yang mendukung evaluasi untuk workload MySQL:

Parameter
log_level	String Untuk menetapkan level logging agen, tetapkan nilai yang diperlukan. Level log yang tersedia adalah sebagai berikut: DEBUG INFO WARNING ERROR Level log default adalah INFO. Jangan ubah level logging kecuali jika Anda diarahkan oleh Cloud Customer Care.
log_to_cloud	Boolean Untuk mengalihkan log agen ke Cloud Logging, tentukan true. Nilai defaultnya adalah true.
agent_properties.log_usage_metrics	Boolean Untuk mengaktifkan logging metrik kesehatan agen, tetapkan nilai ke true. Nilai defaultnya adalah false.
common_discovery.collection_frequency	Duration Tentukan frekuensi, dalam detik, saat layanan penemuan beban kerja agen dijalankan. Nilai defaultnya adalah 10800s. Pastikan nilai parameter ini diakhiri dengan s huruf kecil.
mysql_configuration.enabled	Boolean Agar agen dapat mengumpulkan metrik dari instance MySQL, tetapkan nilai ke true. Nilai defaultnya adalah false. Penting: Agar parameter agen khusus MySQL lainnya berfungsi, Anda harus menetapkan mysql_configuration.enabled ke true.
mysql_configuration.connection_parameters.username	String Tentukan akun pengguna yang digunakan agen untuk membuat kueri instance MySQL.
mysql_configuration.connection_parameters.password	String Tentukan sandi teks biasa untuk akun pengguna yang digunakan agen untuk mengkueri instance MySQL. Daripada menentukan sandi teks biasa, sebaiknya gunakan parameter secret.name dan secret.project_id. Untuk autentikasi, agen menggunakan urutan preferensi berikut: jika ditentukan, set parameter secret lebih disukai daripada parameter password. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi agen.
mysql_configuration.connection_parameters.secret.secret_name	String Opsional. Untuk memberikan sandi dengan aman bagi akun pengguna yang digunakan agen untuk mengkueri instance MySQL, tentukan nama secret Secret Manager yang berisi sandi. Untuk autentikasi, agen menggunakan urutan preferensi berikut: jika ditentukan, set parameter secret lebih disukai daripada parameter password. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi agen.
mysql_configuration.connection_parameters.secret.project_id	String Opsional. Untuk menggunakan parameter secret.secret_name guna mengautentikasi akun pengguna yang ditentukan, tentukan project ID Google Cloud tempat secret Secret Manager disimpan. Jika secret dan workload berada dalam Google Cloud project yang sama, tetapkan nilai parameter ini ke string kosong ("").
mysql_configuration.connection_parameters.host	String Tentukan nama host MySQL.
mysql_configuration.connection_parameters.port	Int Tentukan port tempat instance MySQL Anda menerima kueri.

Langkah berikutnya

• Membuat dan menjalankan evaluasi
• Pelajari praktik terbaik Workload Manager untuk MySQL