Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

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.

Setelah Anda menginstal dan mengonfigurasi agen, agen akan mengumpulkan metrik dari workload MySQL dan instance komputasi yang mendasarinya, lalu mengirimkannya ke Workload Manager. Kemudian, Anda dapat menggunakan evaluasi Workload Manager untuk memindai workload MySQL Anda guna mendeteksi penyimpangan dari praktik terbaik untuk konfigurasi infrastruktur, sistem operasi, dan workload.

Sebelum memulai

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

Anda telah men-deploy workload MySQL di satu atau beberapa instance komputasi.
Anda telah meninjau region yang didukung tempat Anda dapat membuat evaluasi Workload Manager.
Administrator Anda telah memberi Anda peran IAM yang diperlukan untuk membuat dan menjalankan evaluasi Workload Manager.
Anda telah memberikan peran IAM yang diperlukan untuk agen.
Anda telah mengaktifkan akses ke Cloud API.

Peran IAM yang diperlukan untuk agen

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 ke akun layanan di project Anda:

Kumpulkan metrik dari instance komputasi: Compute Viewer (roles/compute.viewer)
Menulis data ke data warehouse Workload Manager: Workload Manager Insights Writer (roles/workloadmanager.insightWriter)
Mengirim log agen ke Cloud Logging: Penulis Log (roles/logging.logWriter)
Jika Anda menggunakan Secret Manager untuk menyimpan sandi guna terhubung dengan instance MySQL: Secret Manager Secret Accessor (roles/secretmanager.secretAccessor)

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 sebelumnya.

Mengaktifkan akses ke Cloud API

Compute Engine merekomendasikan konfigurasi instance Anda untuk mengizinkan semua cakupan akses ke semua Cloud API dan hanya menggunakan izin IAM akun layanan instance untuk mengontrol akses keGoogle Cloud resource. 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 workload MySQL pada instance komputasi yang tidak memiliki alamat IP eksternal, Anda harus mengaktifkan Akses Google Pribadi di subnet instance agar Agen untuk Workload Compute 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 menggunakan pengelola paket

Bagian ini menunjukkan cara menginstal Agen untuk Compute Workloads di instance komputasi Anda, dan mengonfigurasinya untuk terhubung dengan instance MySQL, menggunakan pengelola paket.

Untuk menginstal Agen untuk Compute Workloads, selesaikan langkah-langkah berikut:

RHEL

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

Mendownload versi terbaru agen.
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:

Buat koneksi SSH dengan instance komputasi Anda.

Di terminal Anda, 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

Buka file konfigurasi agen:

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

Tentukan nilai untuk semua parameter wajib, seperti yang dijelaskan dalam Parameter konfigurasi.
Simpan file konfigurasi
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 versi terbaru agen.
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 SLES, selesaikan langkah-langkah berikut:

Buat koneksi SSH dengan instance komputasi Anda.

Di terminal Anda, 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

Buka file konfigurasi agen:

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

Tentukan nilai untuk semua parameter wajib, seperti yang dijelaskan dalam Parameter konfigurasi.
Simpan file konfigurasi
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 versi terbaru agen.
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:

Buat koneksi SSH dengan instance komputasi Anda.

Di terminal Anda, 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

Buka file konfigurasi agen:

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

Tentukan nilai untuk semua parameter wajib, seperti yang dijelaskan dalam Parameter konfigurasi.
Simpan file konfigurasi
Mulai ulang agen agar perubahan diterapkan.

Windows

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

Mendownload versi terbaru agen.
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.

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

Buat koneksi dengan instance komputasi Anda menggunakan RDP.

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

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

Buka file konfigurasi agen:

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

Tentukan nilai untuk semua parameter wajib, seperti yang dijelaskan dalam Parameter konfigurasi.
Simpan file konfigurasi
Mulai ulang agen agar perubahan diterapkan.

Menginstal dan mengelola agen di fleet VM menggunakan VM Extension Manager

Bagian ini menunjukkan cara menginstal dan mengelola Agent for Compute Workloads di sejumlah VM menggunakan VM Extension Manager.

Kebijakan VM Extension Manager memungkinkan Anda melakukan tugas seperti berikut:

Penginstalan di seluruh armada: Instal Agen untuk Workload Komputasi di:
- Semua VM di project Google Cloud Anda, atau subset VM yang diidentifikasi berdasarkan label.
- Semua VM dalam zona, atau subset VM yang diidentifikasi berdasarkan label.
Pengelolaan konfigurasi: Terapkan konfigurasi kustom ke agen di semua VM yang dikelola oleh kebijakan.

Untuk mengetahui informasi selengkapnya tentang VM Extension Manager, lihat artikel Tentang VM Extension Manager.

Menyiapkan VM Extension Manager

Untuk menyiapkan VM Extension Manager, selesaikan langkah-langkah berikut:

Dalam dokumentasi Pengelola Ekstensi VM, tinjau bagian Sebelum memulai.
Siapkan peran IAM yang diperlukan untuk membuat dan mengelola kebijakan VM Extension Manager. Untuk informasi selengkapnya, lihat referensi berikut:

Menginstal dan mengonfigurasi agen di fleet VM

Untuk menginstal Agen untuk Compute Workloads versi terbaru di fleet VM Anda dengan menggunakan kebijakan Pengelola Ekstensi VM, lihat bagian yang sesuai:

Menginstal dan mengonfigurasi agen di VM dalam Google Cloud project Anda
Menginstal dan mengonfigurasi agen di VM dalam zona tertentu

Menginstal dan mengonfigurasi agen di VM dalam Google Cloud project

Untuk menginstal agen di semua VM dalam Google Cloud project, atau subset VM yang diidentifikasi oleh label, dengan menggunakan kebijakan VM Extension Manager, selesaikan langkah-langkah berikut:

Konsol

Di konsol Google Cloud , buka halaman VM extension policies.

Buka kebijakan ekstensi VM
Klik Create extension policy.
Di kolom Name, masukkan nama untuk kebijakan.
Opsional: Di kolom Description, masukkan deskripsi untuk kebijakan.
Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000.
Di bagian Cakupan, pilih Peluncuran global.
Di bagian Kelola ekstensi, klik Tambahkan ekstensi, lalu lakukan hal berikut:
1. Dari daftar Ekstensi, pilih Ekstensi Google Cloud untuk Beban Kerja Compute.
2. Biarkan kolom Versi kosong.
  
  Tindakan ini mengarahkan kebijakan untuk menginstal Agent for Compute Workloads versi terbaru.
3. Di kolom Configuration file content, masukkan konfigurasi yang ingin Anda terapkan ke agen.
  
  Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen untuk workload MySQL Anda, lihat Parameter konfigurasi.
  
  Catatan: Jika Anda menerapkan kebijakan VM Extension Manager ke VM yang sudah menjalankan Agent for Compute Workloads, kebijakan tersebut akan menggantikan versi dan konfigurasi agen yang ada dengan versi dan konfigurasi yang telah Anda tetapkan dalam kebijakan.
  
  Konfigurasi agen yang ada ditulis ke file BAK di direktori /etc/google-cloud-workload-agent/ pada VM masing-masing.
4. Klik Done.
5. Di kolom Peluncuran, pilih opsi rencana peluncuran yang ingin Anda gunakan: Peluncuran lambat (direkomendasikan) atau Peluncuran cepat.
  
  Untuk mengetahui informasi tentang rencana peluncuran, lihat Tentang rencana peluncuran.
Opsional: Untuk membatasi peluncuran kebijakan ke VM yang diperlukan, lakukan hal berikut:
1. Klik Tambahkan label dan sertakan label yang mengidentifikasi VM yang diperlukan.
2. Klik Done.
Klik Create.

gcloud

Di terminal atau Cloud Shell, jalankan perintah gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-predefined-plan=ROLL_OUT_SPEED \
    [--description="<var>DESCRIPTION</var>" \]
    [--inclusion-labels=KEY1=VALUE1,KEY2=VALUE2 \]
    [--config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \]
    [--priority=PRIORITY]

Ganti kode berikut:

POLICY_NAME: nama unik untuk kebijakan ekstensi VM.
PROJECT_ID: project ID dari projectGoogle Cloud tempat Anda membuat kebijakan
ROLL_OUT_SPEED: seberapa cepat Anda ingin meluncurkan kebijakan. Nilai yang didukung adalah slow_rollout (direkomendasikan) dan fast_rollout. Untuk mengetahui informasi selengkapnya, lihat Tentang rencana peluncuran.
Atau, Anda dapat menggunakan rencana peluncuran kustom dengan menentukan opsi --rollout-custom-plan. Untuk mengetahui informasi selengkapnya, lihat Tentang rencana peluncuran.
Anda dapat menggunakan --rollout-predefined-plan atau --rollout-custom-plan, tetapi tidak keduanya dalam perintah yang sama.
DESCRIPTION: deskripsi opsional untuk kebijakan.
CONFIG_FILE_PATH: jalur lokal ke file JSON yang berisi konfigurasi untuk Agent for Compute Workloads.
- Sebagai alternatif, untuk memberikan konfigurasi sebagai string inline, gunakan flag --config, bukan --config-from-file. Contohnya, --config=google-cloud-workload-extension="CONFIG".
- Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.
- Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen, lihat Parameter konfigurasi.
Catatan: Jika Anda menerapkan kebijakan VM Extension Manager ke VM yang sudah menjalankan Agent for Compute Workloads, kebijakan tersebut akan menggantikan versi dan konfigurasi agen yang ada dengan yang telah Anda tetapkan dalam kebijakan.

Konfigurasi agen yang ada ditulis ke file BAK di direktori /etc/google-cloud-workload-agent/ pada VM masing-masing.
KEY_1=VALUE_1: daftar pasangan nilai kunci yang dipisahkan koma yang menentukan label yang digunakan kebijakan untuk menargetkan VM.
- Agar VM menjadi target kebijakan Anda, VM harus memiliki semua label yang ditentukan.
- Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang diberikan (OR logis). Jika Anda menghilangkan flag ini, kebijakan akan menargetkan semua VM dalam project.
PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Untuk mengetahui informasi selengkapnya, lihat Prioritas kebijakan dan resolusi konflik.

Menginstal dan mengonfigurasi agen di VM dalam zona tertentu

Untuk menginstal dan mengonfigurasi Agent for Compute Workloads versi terbaru di armada VM Anda dalam zona tertentu menggunakan kebijakan VM Extension Manager, selesaikan langkah-langkah berikut:

Konsol

Di konsol Google Cloud , buka halaman VM extension policies.

Buka kebijakan ekstensi VM
Klik Create extension policy.
Di kolom Name, masukkan nama untuk kebijakan.
Opsional: Di kolom Description, masukkan deskripsi untuk kebijakan.
Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000.
Dengan menggunakan daftar Region dan Zone, pilih zona tempat Anda ingin menerapkan kebijakan ini.
Di bagian Kelola ekstensi, klik Tambahkan ekstensi, lalu lakukan hal berikut:
1. Dari daftar Ekstensi, pilih Ekstensi Google Cloud untuk Beban Kerja Compute.
2. Biarkan kolom Versi kosong.
  
  Tindakan ini mengarahkan kebijakan untuk menginstal Agent for Compute Workloads versi terbaru.
3. Di kolom Configuration file content, masukkan konfigurasi yang ingin Anda terapkan ke agen.
  
  Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen untuk workload MySQL Anda, lihat Parameter konfigurasi.
  
  Catatan: Jika Anda menerapkan kebijakan VM Extension Manager ke VM yang sudah menjalankan Agent for Compute Workloads, kebijakan tersebut akan menggantikan versi dan konfigurasi agen yang ada dengan versi dan konfigurasi yang telah Anda tetapkan dalam kebijakan.
  
  Konfigurasi agen yang ada ditulis ke file BAK di direktori /etc/google-cloud-workload-agent/ pada VM masing-masing.
4. Klik Done.
Opsional: Untuk membatasi peluncuran kebijakan ke VM yang diperlukan, lakukan hal berikut:
1. Klik Tambahkan label dan sertakan label yang mengidentifikasi VM yang diperlukan.
2. Klik Done.
Klik Create.

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]

Ganti kode berikut:

POLICY_NAME: nama untuk kebijakan ekstensi VM.

Perintah akan gagal jika kebijakan dengan nama yang ditentukan sudah ada di zona.
ZONE: zona tempat Anda ingin menerapkan kebijakan ini.
CONFIG_FILE_PATH: jalur lokal ke file JSON yang berisi konfigurasi agar Agent for Compute Workloads dapat terhubung dengan beban kerja MySQL Anda.
- Sebagai alternatif, untuk memberikan konfigurasi sebagai string inline, gunakan flag --config, bukan --config-from-file. Contohnya, --config=google-cloud-workload-extension="CONFIG". Google Cloud merekomendasikan agar Anda menggunakan --config-from-file.
- Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.
- Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen untuk workload MySQL Anda, lihat Parameter konfigurasi.
Catatan: Jika Anda menerapkan kebijakan VM Extension Manager ke VM yang sudah menjalankan Agent for Compute Workloads, kebijakan tersebut akan menggantikan versi dan konfigurasi agen yang ada dengan yang telah Anda tetapkan dalam kebijakan.

Konfigurasi agen yang ada ditulis ke file BAK di direktori /etc/google-cloud-workload-agent/ pada VM masing-masing.
DESCRIPTION: deskripsi opsional untuk kebijakan.
KEY_1=VALUE_1: daftar pasangan nilai kunci yang dipisahkan koma yang menentukan label yang digunakan kebijakan untuk menargetkan VM.
- Agar VM menjadi target kebijakan Anda, VM harus memiliki semua label yang ditentukan.
- Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang diberikan (OR logis). Jika Anda menghilangkan tanda ini, kebijakan akan menargetkan semua VM di zona yang ditentukan.
PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000.

Contoh:

Perintah berikut membuat kebijakan bernama test-agent-policy di projectGoogle Cloud bernama test-project, yang menginstal versi terbaru Agent for Compute Workloads di semua VM yang di-deploy di zona us-centrail-f. Konfigurasi yang ditentukan dalam agent-config.json diterapkan ke agen.

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"

Mengelola agen di fleet VM

Untuk mengubah cara kebijakan VM Extension Manager mengelola Agent for Compute Workloads, perbarui kebijakan. Saat Anda memperbarui kebijakan, VM Extension Manager akan meluncurkan perubahan ke semua VM yang berlaku, biasanya dalam waktu satu menit. Jika Anda mengubah label penyertaan, maka Agent for Compute Workloads mungkin diinstal di VM baru atau diuninstal dari VM yang ada berdasarkan apakah VM cocok dengan label yang diperbarui.

Bagian berikut menunjukkan cara mengelola Agen untuk Beban Kerja Compute untuk melakukan hal berikut:

Mengubah konfigurasi agen di fleet VM
Memperbarui kebijakan global untuk menyertakan zona baru
Memperbarui kebijakan global untuk mengecualikan zona

Mengubah konfigurasi agen di fleet VM

Untuk mengubah konfigurasi instance Agent for Compute Workloads yang telah Anda instal di fleet VM menggunakan kebijakan VM Extension Manager, Anda harus mengedit kebijakan tersebut.

Untuk mengubah konfigurasi agen di fleet VM Anda, selesaikan langkah-langkah berikut:

Konsol

Di konsol Google Cloud , buka halaman VM extension policies.

Buka kebijakan ekstensi VM
Klik kebijakan yang ingin Anda ubah.
Di halaman Extension policy details, klik Edit.
Di bagian Manage extensions, aktifkan Google Cloud's Extension for Compute Workloads.
Di kolom Configuration file content, masukkan konfigurasi yang ingin Anda terapkan ke agen.

Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen, lihat Parameter konfigurasi
Klik Done.
Klik Save.

gcloud

Untuk mengubah konfigurasi Agen untuk Compute Workloads di fleet VM Anda, jalankan perintah gcloud compute zone-vm-extension-policies update. Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan bertindak sebagai pengganti lengkap. Kolom opsional yang Anda hilangkan akan dikembalikan ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk mengubah konfigurasi agen:

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

Ganti kode berikut:

POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda ubah.
ZONE: Google Cloud zona tempat kebijakan berlaku.
CONFIG_FILE_PATH: jalur lokal ke file JSON yang berisi konfigurasi untuk Agent for Compute Workloads.
- Anda juga dapat memberikan konfigurasi agen sebagai string inline dengan menggunakan flag --config, bukan --config-from-file. Contohnya, --config=google-cloud-workload-extension="CONFIG". Google Cloud merekomendasikan agar Anda menggunakan --config-from-file.
- Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.
- Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen, lihat Parameter konfigurasi
KEY_1=VALUE_1: daftar pasangan nilai kunci yang dipisahkan koma yang menentukan label yang digunakan kebijakan untuk menargetkan VM.
- Agar VM menjadi target kebijakan Anda, VM harus memiliki semua label yang ditentukan.
- Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang diberikan (OR logis). Jika Anda menghilangkan tanda ini, kebijakan akan menargetkan semua VM di zona yang ditentukan.
PRIORITY_NUMBER: prioritas yang ingin Anda tetapkan untuk kebijakan Anda. Anda dapat menentukan bilangan bulat dari 0 hingga 65535.
DESCRIPTION: deskripsi kebijakan ekstensi VM.

Memperbarui kebijakan global untuk menyertakan zona baru

Saat Anda membuat VM di zona baru setelah membuat dan meluncurkan kebijakan global, VM Extension Manager tidak otomatis menerapkan kebijakan ke VM di zona baru. Untuk menyertakan VM di zona baru, Anda harus memulai ulang peluncuran kebijakan global.

Untuk memulai ulang peluncuran kebijakan global, selesaikan langkah-langkah berikut:

Di terminal atau Cloud Shell, jalankan perintah gcloud compute global-vm-extension-policies update dan berikan opsi --rollout-entry-uuid sebagai berikut:
```
gcloud compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-predefined-plan=ROLL_OUT_SPEED \
    --config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \
    --rollout-retry-uuid=UUID
```
Ganti kode berikut:
- UUID: ID unik universal (UUID) yang mengidentifikasi permintaan percobaan ulang. Anda dapat menggunakan generator UUID apa pun untuk membuatnya. Untuk mengetahui informasi selengkapnya, lihat Coba lagi peluncuran.
- ROLL_OUT_SPEED: seberapa cepat Anda ingin meluncurkan kebijakan. Nilai yang didukung adalah slow_rollout (direkomendasikan) dan fast_rollout. Untuk mengetahui informasi selengkapnya, lihat Tentang rencana peluncuran.
- Atau, Anda dapat menggunakan rencana peluncuran kustom dengan menentukan opsi --rollout-custom-plan. Untuk mengetahui informasi selengkapnya, lihat Tentang rencana peluncuran.
- Anda dapat menggunakan --rollout-predefined-plan atau --rollout-custom-plan, tetapi tidak keduanya dalam perintah yang sama.

Memperbarui kebijakan global untuk mengecualikan zona

Untuk memperbarui kebijakan global guna mengecualikan zona, selesaikan langkah-langkah berikut:

Di terminal atau Cloud Shell, jalankan perintah gcloud compute global-vm-extension-policies update dan berikan rencana peluncuran kustom yang menentukan zona tempat kebijakan akan diterapkan:
```
gcloud compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
    --rollout-retry-uuid=UUID
```
Ganti kode berikut:
- NEW_CUSTOM_PLAN_NAME: nama rencana peluncuran kustom baru yang mengidentifikasi zona tempat kebijakan akan diterapkan. Untuk mengetahui informasi tentang cara membuat rencana peluncuran kustom, lihat Tentang rencana peluncuran.
- UUID: ID unik universal (UUID) yang mengidentifikasi permintaan percobaan ulang. Anda dapat menggunakan generator UUID apa pun untuk membuatnya. Untuk mengetahui informasi selengkapnya, lihat Coba lagi peluncuran.

Meng-uninstal agen dari fleet VM

Untuk meng-uninstal Agent for Compute Workloads dari fleet VM, Anda harus menghapus kebijakan VM Extension Manager yang mengelola fleet VM.

Saat menghapus kebijakan, jika kebijakan lain yang aktif dan berprioritas lebih rendah berlaku untuk VM dan mendeklarasikan Agen untuk Beban Kerja Compute, maka agen akan tetap diinstal di VM tersebut berdasarkan kebijakan berprioritas lebih rendah.

VM Extension Manager menghapus agen dari semua VM yang dapat diakses dalam waktu satu menit setelah penghapusan kebijakan. Jika VM tidak dapat diakses karena agen tamu dihapus atau VM dihapus, Pengelola Ekstensi VM akan melewati penghapusan Agen untuk Compute Workloads. Jika VM tersebut tersedia kembali, maka VM Extension Manager akan menghapus Agen untuk Compute Workloads pada saat itu.

Untuk meng-uninstal Agen untuk Compute Workloads dari fleet VM Anda, selesaikan langkah-langkah berikut:

Konsol

Di konsol Google Cloud , buka halaman VM extension policies.

Buka kebijakan ekstensi VM
Klik kebijakan yang mengelola Agen untuk Compute Workloads di fleet VM Anda.
Di halaman Detail kebijakan ekstensi, klik Hapus dan konfirmasi penghapusan.

gcloud

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Ganti kode berikut:

POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda hapus.
PROJECT_ID: ID Google Cloud project tempat kebijakan berada.
ZONE: Google Cloud zona tempat kebijakan berada.

Memverifikasi penginstalan agen

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

RHEL

Buat koneksi SSH dengan instance komputasi Anda.

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

Buat koneksi SSH dengan instance komputasi Anda.

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

Buat koneksi SSH dengan instance komputasi Anda.

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

Buat koneksi dengan instance komputasi Anda menggunakan RDP.

Untuk mengetahui informasi tentang cara melakukannya, lihat Terhubung ke VM Windows menggunakan RDP.
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 kondisi 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 project Google Cloud 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.

Menyiapkan agen untuk workload MySQL Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Peran IAM yang diperlukan untuk agen

Mengaktifkan akses ke Cloud API

Menginstal dan mengonfigurasi agen menggunakan pengelola paket

RHEL

SLES

Debian

Windows

Menginstal dan mengelola agen di fleet VM menggunakan VM Extension Manager

Menyiapkan VM Extension Manager

Menginstal dan mengonfigurasi agen di fleet VM

Menginstal dan mengonfigurasi agen di VM dalam Google Cloud project

Konsol

gcloud

Menginstal dan mengonfigurasi agen di VM dalam zona tertentu

Konsol

gcloud

Mengelola agen di fleet VM

Mengubah konfigurasi agen di fleet VM

Konsol

gcloud

Memperbarui kebijakan global untuk menyertakan zona baru

Memperbarui kebijakan global untuk mengecualikan zona

Meng-uninstal agen dari fleet VM

Konsol

gcloud

Memverifikasi penginstalan agen

RHEL

SLES

Debian

Windows

Contoh file konfigurasi

Parameter konfigurasi

Langkah berikutnya

Menyiapkan agen untuk workload MySQL