Dokumen ini menunjukkan cara menginstal, mengonfigurasi, dan memverifikasi Agen untuk Compute Workloads di instance Compute Engine yang menjalankan workload Oracle Database.
Agen mengumpulkan berbagai metrik Oracle dengan membuat kueri pada tampilan performa Oracle Database (seperti V$DATABASE, V$INSTANCE, dan V$DATAGUARD_STATS) dan tampilan kamus data (seperti DBA_DATA_FILES dan DBA_FREE_SPACE). Metrik ini kemudian dikirim ke Cloud Monitoring tempat metrik tersebut dapat divisualisasikan dan dianalisis. Lihat Metrik yang didukung.
Sebelum memulai
Sebelum menginstal Agen untuk Workload Compute guna memantau workload Oracle Database, pastikan prasyarat berikut terpenuhi:
Buat instance Compute Engine jika Anda belum memilikinya. Konfigurasi cakupan akses ke
cloud-platform.Aktifkan konektivitas ke endpoint Google Cloud API, baik melalui akses jaringan publik maupun akses jaringan pribadi.
Jika Anda ingin mengaktifkan pengumpulan metrik, maka buat secret di Secret Manager untuk menyimpan sandi database bagi pengguna database yang akan dibuat nanti dalam panduan ini.
Untuk contoh dalam panduan ini, kita asumsikan bahwa nilainya adalah
wlmagent-password.
Meninjau persyaratan sistem
Tabel berikut mencantumkan edisi Oracle yang dapat Anda gunakan dan versi sistem operasi yang didukung:
| Sistem Operasi | Versi Oracle | Edisi Oracle |
|---|---|---|
|
|
|
Memberikan peran IAM ke akun layanan
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 Oracle:
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 Oracle di instance komputasi yang tidak memiliki alamat IP eksternal, Anda harus mengaktifkan Akses Google Pribadi di subnet instance agar Agen untuk Workload Komputasi 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 Oracle, menggunakan pengelola paket.
Untuk menginstal Agen untuk Compute Workloads, selesaikan langkah-langkah berikut:
Buat file konfigurasi repositori.
sudo tee /etc/yum.repos.d/google-cloud-workload-agent.repo << EOM [google-cloud-workload-agent] name=Google Cloud Workload Agent 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
Perbarui metadata pengelola paket:
sudo yum makecache
Instal paket rpm
google-cloud-workload-agent:sudo yum install google-cloud-workload-agent
Setelah menginstal agen untuk workload Oracle, verifikasi penginstalan agen.
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.
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:
- Dari daftar Ekstensi, pilih Ekstensi Google Cloud untuk Beban Kerja Compute.
Biarkan kolom Versi kosong.
Tindakan ini mengarahkan kebijakan untuk menginstal Agent for Compute Workloads versi terbaru.
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 Oracle Anda, lihat Parameter konfigurasi.
Klik Done.
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:
- Klik Tambahkan label dan sertakan label yang mengidentifikasi VM yang diperlukan.
- 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 kebijakanROLL_OUT_SPEED: seberapa cepat Anda ingin meluncurkan kebijakan. Nilai yang didukung adalahslow_rollout(direkomendasikan) danfast_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-planatau--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-fileatau--config, tetapi tidak keduanya dalam perintah yang sama. - Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen, lihat Parameter konfigurasi.
- Sebagai alternatif, untuk memberikan konfigurasi sebagai string inline, gunakan
flag
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-labelsbeberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang diberikan (ORlogis). Jika Anda menghilangkan flag ini, kebijakan akan menargetkan semua VM dalam project.
PRIORITY: bilangan bulat dari0hingga65535yang menentukan prioritas kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah1000. 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.
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:
- Dari daftar Ekstensi, pilih Ekstensi Google Cloud untuk Beban Kerja Compute.
Biarkan kolom Versi kosong.
Tindakan ini mengarahkan kebijakan untuk menginstal Agent for Compute Workloads versi terbaru.
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 Oracle Anda, lihat Parameter konfigurasi.
Klik Done.
Opsional: Untuk membatasi peluncuran kebijakan ke VM yang diperlukan, lakukan hal berikut:
- Klik Tambahkan label dan sertakan label yang mengidentifikasi VM yang diperlukan.
- 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 Oracle 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-fileatau--config, tetapi tidak keduanya dalam perintah yang sama. - Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen untuk workload Oracle Anda, lihat Parameter konfigurasi.
- Sebagai alternatif, untuk memberikan konfigurasi sebagai string inline, gunakan
flag
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-labelsbeberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang diberikan (ORlogis). Jika Anda menghilangkan tanda ini, kebijakan akan menargetkan semua VM di zona yang ditentukan.
PRIORITY: bilangan bulat dari0hingga65535yang menentukan prioritas kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah1000.
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.
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-fileatau--config, tetapi tidak keduanya dalam perintah yang sama. - Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen, lihat Parameter konfigurasi
- Anda juga dapat memberikan konfigurasi agen sebagai string inline dengan
menggunakan flag
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-labelsbeberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang diberikan (ORlogis). 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 dari0hingga65535.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 updatedan berikan opsi--rollout-entry-uuidsebagai 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=UUIDGanti 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 adalahslow_rollout(direkomendasikan) danfast_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-planatau--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 updatedan 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=UUIDGanti 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.
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:
Buat koneksi SSH dengan instance komputasi Anda.
Periksa status paket agen:
systemctl status google-cloud-workload-agentJika 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=runParameter konfigurasi
Agen untuk Workload Komputasi mendukung parameter konfigurasi berikut untuk Oracle:
Parameter Deskripsi log_level
Untuk menetapkan level logging agen, tambahkan level log. Level log yang tersedia adalah sebagai berikut:String
DEBUGINFOWARNINGERROR
INFO.log_to_cloudBooleanUntuk mengalihkan log agen ke Cloud Logging, tentukan
true. Jumlah defaultnya adalahtrueoracle_configuration.enabledBooleanOpsional. Menentukan apakah layanan Oracle aktif. Jika disetel ke
true, atau jika tidak disetel dan workload ada, Anda dapat mengonfigurasi penemuan dan pengumpulan metrik. Jika disetel kefalse, layanan Oracle dan fungsi terkaitnya akan dinonaktifkan.Parameter turunan berikut hanya berlaku jika Anda menentukan oracle_configuration.enabled: true.oracle_configuration.oracle_discovery.enabledBooleanOpsional. Menentukan apakah Penemuan Oracle aktif.
Nilai defaultnya adalah
true.oracle_configuration.oracle_discovery.update_frequencyIntOpsional. Tentukan interval sampel, dalam detik, yang menentukan frekuensi saat Agen untuk Compute Workloads menjalankan proses penemuan. Nilai default-nya adalah 3.600 detik (1 jam).
Pastikan nilai diakhiri dengan "s" huruf kecil untuk menunjukkan detik. Contoh:
30s.oracle_configuration.oracle_metrics.enabledBooleanOpsional. Agar dapat mengaktifkan Agen untuk Workload Komputasi guna mengumpulkan metrik pemantauan Oracle, tentukan
true. Nilai defaultnya adalahfalse.Parameter turunan berikut hanya berlaku jika Anda menentukan
oracle_metrics.enabled: true.oracle_configuration.oracle_metrics.collection_frequencyIntOpsional. Tentukan interval sampel, dalam detik, yang menentukan frekuensi saat Agen untuk Compute Workloads mengkueri instance Oracle Database Anda guna mengumpulkan metrik pemantauan Oracle. Nilai default-nya adalah 60 detik.
Pastikan nilai diakhiri dengan "s" huruf kecil untuk menunjukkan detik. Contoh:
30s.oracle_configuration.oracle_metrics.query_timeoutStringOpsional. Tentukan waktu tunggu untuk setiap kueri yang diajukan ke instance Database Oracle. Nilai default-nya adalah 10 detik.
Pastikan nilai diakhiri dengan "s" huruf kecil untuk menunjukkan detik. Contoh:
30s.oracle_configuration.oracle_metrics.connection_parameters.usernameStringMenentukan akun pengguna yang digunakan untuk membuat kueri instance Oracle Database.
Pastikan pengguna ini memiliki izin yang diperlukan untuk membaca tampilan performa di Oracle Database Anda.
oracle_configuration.oracle_metrics.connection_parameters.hostStringMenentukan ID mesin lokal yang menghosting instance database Anda.
oracle_configuration.oracle_metrics.connection_parameters.portIntMenentukan port tempat instance Oracle Database Anda menerima kueri.
oracle_configuration.oracle_metrics.connection_parameters.service_nameStringMenentukan nama layanan untuk instance Oracle Database yang ingin dipantau oleh agen.
oracle_configuration.oracle_metrics.connection_parameters.secret.project_idStringMenentukan project ID Secret Manager untuk mengambil sandi bagi pengguna yang membuat kueri ke database.
oracle_configuration.oracle_metrics.connection_parameters.secret.secret_nameStringMenentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna.
Mengumpulkan dan melihat metrik Oracle
Anda dapat mengaktifkan pengumpulan metrik untuk workload Oracle Database. Lihat Metrik yang didukung.
Mengaktifkan pengumpulan metrik
Untuk mengaktifkan pengumpulan metrik Oracle menggunakan Agent for Compute Workloads, lakukan hal berikut:
Gunakan SSH untuk terhubung ke instance VM Anda.
Sebagai pengguna OS Oracle, jalankan alat
oraenvuntuk menetapkan variabel lingkungan. Kami mengasumsikan bahwa Anda telah menentukan penggunaoracledanORACLE_SIDdalam file/etc/oratab.sudo su - oracle export PATH=$PATH:/usr/local/bin . oraenv sqlplus / as sysdba
Sebagai pengguna
SYSDBAatauSYSOPER, di Oracle Database, buat pengguna untuk pemantauan dengan sandi yang cocok dengan secret yang Anda buat di Prasyarat.CREATE USER wlmagent IDENTIFIED BY password;
Sebagai pengguna
SYSDBAatauSYSOPER, berikan izin berikut kepada pengguna pemantauan untuk membuat kueri tampilan performa:SESSIONSELECT_CATALOG_ROLESYSDG
GRANT CREATE SESSION,SELECT_CATALOG_ROLE,SYSDG TO wlmagent;
Keluar dari
sqlplusdan penggunaoracle.Sebagai pengguna root, edit file konfigurasi agen menggunakan editor pilihan Anda.
sudo nano /etc/google-cloud-workload-agent/configuration.json
Dalam file konfigurasi, edit bagian
oracle_metricsuntuk melakukan update berikut:- Tetapkan parameter
enabledketrue. - Tetapkan parameter
service_nameuntuk menentukan nama layanan instance Oracle yang ingin Anda pantau oleh agen. - Tentukan nama pengguna Oracle agar agen dapat terhubung ke database Anda.
- Tetapkan parameter
hostdanportagar agen dapat terhubung ke database Anda. - Tetapkan parameter
secretagar agen mengambil sandi untuk nama pengguna:project_id: ID project yang berisi data Secret Manager.secret_name: Nama secret di Secret Manager.
Berikut adalah contoh file konfigurasi:
{ "log_level": "INFO", "common_discovery": {"collection_frequency": "3600s" }, "oracle_configuration": { "enabled": true, "oracle_metrics": { "enabled": true, "collection_frequency": "30s", "connection_parameters": [ { "host": "localhost", "port": 1521, "service_name": "orcl", "username": "wlmagent", "secret": { "project_id": "my-project", "secret_name": "wlmagent_password" } } ] } } }- Tetapkan parameter
Simpan file konfigurasi.
Mulai ulang agen agar setelan baru diterapkan.
Melihat metrik
Anda dapat melihat metrik yang dikumpulkan dan memantau performa serta status Oracle menggunakan Metrics Explorer atau dengan mengimpor dasbor kustom.
Melihat Metrik di Metrics Explorer
Untuk melihat metrik Oracle di Metrics Explorer, lakukan hal berikut:
- Di konsol Google Cloud , buka Monitoring.
- Klik Metrics Explorer.
- Di bagian Temukan jenis resource dan metrik, lakukan hal berikut:
- Untuk Jenis resource, pilih Instance VM.
- Untuk Metric, pilih metrik Oracle yang ingin Anda lihat.
Anda dapat melihat data real-time dan historis untuk metrik Oracle yang dipilih, menggunakan filter dan agregasi sesuai kebutuhan.
Mengimpor Dasbor Kustom
Untuk melihat metrik Oracle yang dikumpulkan oleh agen, Anda dapat membuat dasbor Cloud Monitoring kustom dengan mengikuti petunjuk di Membuat dan mengelola dasbor kustom.
Kami menyediakan contoh dasbor
oracle-status-overview.jsondan petunjuk cara mengimpornya. Dasbororacle-status-overview.jsonmenampilkan diagram metrik Oracle berikut:- Perincian waktu database
- Penggunaan memori database
- Sesi Aktif Rata-Rata menurut Kelas Tunggu
- I/O Disk
- Pemakaian CPU
- Traffic Jaringan
Untuk mengimpor dasbor
oracle-status-overview.json, lakukan tindakan berikut:Pastikan gcloud CLI sudah terinstal dan diupdate. Untuk mendapatkan petunjuk, lihat Menginstal gcloud CLI.
Dari repositori GitHub Agent for Compute Workloads, download dasbor
oracle-status-overview.json:$ curl -H "Accept: application/vnd.github.v3.raw" -o oracle-status-overview.json https://api.github.com/repos/GoogleCloudPlatform/workloadagent/contents/observability/dashboards/oracle-status-overview.json
Jalankan perintah berikut untuk mengimpor dasbor:
gcloud alpha monitoring dashboards create --config-from-file=oracle-status-overview.json
Setelah perintah dijalankan, dasbor kustom akan dibuat di Cloud Monitoring. Untuk mempelajari cara melihat dasbor, lihat artikel Menemukan dan melihat dasbor.
Metrik yang didukung
Semua metrik Oracle yang dikumpulkan oleh Agen untuk Workload Compute tersedia di jalur
workload.googleapis.com/oracle.Berikut adalah daftar metrik Oracle yang didukung dan jalur Cloud Monitoring yang sesuai:
-
Memori proses (PGA) yang digunakan, dalam byte.
process/pga_memory/total_used_sizeMemori proses (PGA) yang dialokasikan, dalam byte
process/pga_memory/total_allocated_size
-
Ukuran item memori bersama (SGA), dalam byte
process/sga_memory/size
-
Jumlah total penantian untuk kelas tunggu yang terdaftar
sys_wait/countTotal waktu yang dihabiskan dalam class tunggu ini, dalam detik
sys_wait/timeTotal penantian di latar depan dalam class penantian ini
sys_wait/foreground/countWaktu tunggu latar depan gabungan untuk class tunggu ini, dalam detik
sys_wait/foreground/time
-
Waktu berlalu yang dihabiskan untuk melakukan panggilan tingkat pengguna database, dalam detik
sys_time/db_timeWaktu CPU yang dihabiskan untuk panggilan tingkat pengguna database, dalam detik
sys_time/db_cpuJumlah waktu yang berlalu saat pernyataan SQL dieksekusi
sys_time/sql_execute_elapsed_timeJumlah waktu berlalu yang dihabiskan untuk mengurai pernyataan SQL
sys_time/parse_time_elapsedJumlah waktu berlalu yang dihabiskan untuk menjalankan interpreter PL/SQL
sys_time/pl_sql_execution_elapsed_timeWaktu yang berlalu yang digunakan oleh proses latar belakang database, dalam detik
sys_time/background_elapsed_time
-
Jumlah total operasi baca (kecil + besar)
iostat/read_ops_countJumlah total operasi tulis (kecil + besar)
iostat/write_ops_countTotal jumlah byte yang dibaca
iostat/read_bytes_countTotal jumlah byte yang ditulis
iostat/write_bytes_countLatensi rata-rata per operasi I/O
iostat/average_latency_seconds
-
Ukuran file data yang dialokasikan, dalam byte
data_files/total_bytesRuang file data yang digunakan, dalam byte
data_files/bytes_usedRuang kosong file data, dalam byte
data_files/available_bytesBatas perpanjangan otomatis file data, dalam byte
data_files/max_bytesPersentase file data yang digunakan
data_files/percent_used
-
Waktu beroperasi instance, dalam detik
instance/uptimeStatus instance
instance/statusMetrik ini dapat memiliki nilai berikut:
UNKNOWN0STARTED1MOUNTED2OPEN3OPEN MIGRATE4Mode terbuka
instance/db_open_modeMetrik ini dapat memiliki nilai berikut:
UNKNOWN0MOUNTED1READ WRITE2READ ONLY3READ ONLY WITH APPLY4
-
Penundaan penerapan pengulangan, dalam detik
dataguard/apply_lagPenundaan transportasi pengulangan, dalam detik
dataguard/transport_lag
Mengelola agen
Memulai ulang agen
Jika Agen untuk Compute Workloads berhenti berfungsi atau Anda memperbarui konfigurasinya, mulai ulang agen.
- Gunakan SSH untuk terhubung ke instance VM.
Jalankan perintah berikut:
sudo systemctl restart google-cloud-workload-agent
Memeriksa versi agen
Untuk memeriksa versi agen Anda, selesaikan langkah-langkah berikut:
- Gunakan SSH untuk terhubung ke instance VM.
Jalankan perintah berikut:
yum info google-cloud-workload-agent
Memeriksa update
- Gunakan SSH untuk terhubung ke instance VM.
Jalankan perintah berikut:
sudo yum check-update google-cloud-workload-agent
Memperbarui agen
Untuk memastikan Anda memiliki agen versi terbaru, periksa update secara berkala dan update agen:
- Gunakan SSH untuk terhubung ke instance VM.
Jalankan perintah berikut:
sudo yum --nogpgcheck update google-cloud-workload-agent
Melihat log agen
Log Agen untuk Workload Compute tersedia di
/var/log/google-cloud-workload-agent.log.Keberagaman log dikontrol oleh parameter
log_level. Menetapkan tingkat logDEBUGmencakup informasi tambahan untuk memecahkan masalah tertentu, tetapi menghasilkan log yang jauh lebih besar.Secara default, log untuk Agen untuk Compute Workloads dialihkan dari instance VM Anda ke Cloud Logging.
Untuk melihat log agen di Logging, ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Logs Explorer.
Buka panel Query.
Dari menu drop-down Resources, pilih Global, lalu klik Apply.
Di editor kueri, masukkan
google-cloud-workload-agent.Klik Run query.
Anda dapat melihat log yang dihasilkan oleh agen yang berjalan di semua instance VM Anda. Anda dapat memfilter log untuk instance tertentu.
Mengonfigurasi log agen di Cloud Logging
Untuk menonaktifkan pengalihan default log agen ke Cloud Logging, ikuti langkah-langkah berikut:
Gunakan SSH untuk terhubung ke instance VM Anda.
Buka file konfigurasi agen:
/etc/google-cloud-workload-agent/configuration.json
Untuk properti
log_to_cloud, perbarui nilai menjadifalse.Simpan file konfigurasi.
Mulai ulang agen agar perubahan ini diterapkan.
Pemecahan masalah
Bagian berikut memberikan informasi tentang masalah umum terkait penggunaan agen untuk workload Oracle Database, penyebab, dan penyelesaiannya.
Izin IAM tidak memadai
Masalah: Log Agen untuk Compute Workloads menampilkan error izin IAM yang tidak memadai.
googleapi: Error 403: The client is not authorized to make this request.
Penyebab: Akun layanan yang digunakan oleh agen tidak memiliki izin IAM yang diperlukan untuk mengakses API Google Cloud atau sandi untuk pengguna Oracle di Secret Manager.
Penyelesaian: Untuk mengatasi masalah ini, pastikan akun layanan VM memiliki peran dan izin IAM yang disebutkan dalam Prasyarat.
Cakupan autentikasi tidak memadai
Masalah: Log Agen untuk Compute Workloads menampilkan cakupan autentikasi yang tidak memadai.
googleapi: Error 403: Request had insufficient authentication scopes.
Penyebab: Akun layanan yang digunakan oleh agen tidak memiliki cakupan akses yang diperlukan.
Penyelesaian: Untuk mengatasi masalah ini, konfigurasi cakupan akses VM ke
cloud-platform.Metrik tidak muncul di Cloud Monitoring
Masalah: Metrik dari Agen untuk Compute Workloads tidak terlihat di Cloud Monitoring.
Penyebab:
Berikut kemungkinan penyebab masalah ini:
- Akun layanan yang digunakan oleh Agen untuk Compute Workloads tidak memiliki izin IAM yang diperlukan.
- Pengguna Oracle yang digunakan oleh agen tidak memiliki hak istimewa yang memadai untuk membuat kueri tampilan performa.
- Terjadi error dalam konfigurasi agen.
Penyelesaian:
Untuk mengatasi masalah izin yang tidak memadai untuk akun layanan, lakukan langkah-langkah berikut:
- Di konsol Google Cloud , buka halaman VM instance details dan catat akun layanan yang digunakan oleh instance yang menjalankan agen.
- Buka halaman IAM & admin dan pastikan akun layanan memiliki semua peran dan izin yang diperlukan yang disebutkan dalam Prasyarat. Berikan salah satu peran yang diperlukan yang belum diberikan ke akun layanan.
Untuk mengatasi masalah izin yang tidak memadai bagi pengguna Oracle, lakukan hal berikut:
Pastikan pengguna Oracle memiliki izin yang diperlukan berikut untuk membuat kueri tampilan performa:
SESSIONSELECT_CATALOG_ROLESYSDG
Berikan izin yang tidak ada dengan menjalankan perintah SQL berikut:
-- Grant the "wlmagent" user the required permissions GRANT CREATE SESSION,SELECT_CATALOG_ROLE,SYSDG TO USERNAME;
Untuk mengatasi masalah terkait kesalahan konfigurasi agen, lakukan langkah-langkah berikut:
- Gunakan SSH untuk terhubung ke instance VM Anda.
Tinjau log agen untuk mengidentifikasi error atau masalah yang mencegah pengumpulan metrik. Anda dapat menemukan log di
/var/log/google-cloud-workload-agent.log.Cari error izin, kesalahan konfigurasi, atau masalah konektivitas.
Mengatasi error
Mulai ulang agen dan periksa apakah pengumpulan metrik dimulai.
Gagal memuat file konfigurasi
Masalah: Jika file konfigurasi memiliki nilai yang tidak valid, Anda akan melihat error berikut.
"Failed to load configuration","pid":3524,"error":"proto: (line 19:42): unknown field "{field_name}"Penyelesaian: Untuk mengatasi masalah ini, perbarui file konfigurasi menggunakan detail di Parameter konfigurasi.
Gagal memulai pengumpulan data
Masalah: Setelah menginstal agen, jika file konfigurasi tidak diperbarui, Anda akan melihat error berikut:
"Failed to initialize guest collection","pid":2112,"error":"invalid value for "user_name" "secret_name"
Penyelesaian: Untuk mengatasi masalah ini, inisialisasi konfigurasi kredensial menggunakan Parameter konfigurasi.