Panduan ini menunjukkan cara mengonfigurasi Agen untuk SAP Google Cloud guna mengumpulkan metrik evaluasi Workload Manager dari sistem SAP.
Untuk mengetahui informasi tentang fitur ini, baca Evaluasi Workload Manager menggunakan Agent for SAP dari Google Cloud.
Sebelum memulai
- Validasi penginstalan Agen Google Cloud untuk SAP. Untuk mengetahui petunjuknya, lihat panduan penginstalan untuk skenario Anda.
- Jika Anda telah menginstal agen di server Solusi Bare Metal, pastikan Anda telah menyelesaikan prasyarat yang diperlukan dan menyiapkan akun layanan. Untuk mengetahui petunjuknya, lihat Mengonfigurasi Agen Google Cloud untuk SAP di Linux.
- Pastikan Workload Manager API diaktifkan untuk project Anda. Untuk mengetahui petunjuknya, lihat Mengaktifkan Workload Manager API.
Menetapkan peran IAM
Agar Agen Google Cloud untuk SAP dapat mengumpulkan metrik evaluasi Pengelola Workload, Anda harus memastikan bahwa akun layanan yang digunakan oleh instance VM Compute Engine atau server Solusi Bare Metal mencakup peran berikut:
- Compute Viewer (
roles/compute.viewer
) - Penulis Insight Pengelola Workload (
roles/workloadmanager.insightWriter
) - Aksesor Rahasia Secret Manager (
roles/secretmanager.secretAccessor
), jika Anda menggunakan Secret Manager untuk menyimpan sandi database SAP HANA.
Untuk menambahkan peran yang diperlukan ini ke akun layanan Anda, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman IAM.
Pilih project Google Cloud Anda.
Identifikasi akun layanan tempat Anda ingin menambahkan peran.
- Jika akun layanan belum ada dalam daftar akun utama, akun layanan tidak memiliki peran yang ditetapkan pada akun tersebut. Klik Add, lalu masukkan alamat email akun layanan.
- Jika akun layanan sudah ada di daftar utama, berarti akun tersebut sudah memiliki peran. Klik tombol Edit untuk akun layanan yang ingin diedit.
Pilih peran yang diperlukan dari daftar peran yang tersedia:
- Viewer Komputasi
- Workload Manager > Workload Manager Insights Writer
- Secret Manager > Secret Manager Secret Accessor
Klik Add atau Save untuk menerapkan peran ke akun layanan.
Memverifikasi versi agen
Google Cloud merekomendasikan agar Anda menginstal versi terbaru Agen untuk SAP guna mengevaluasi beban kerja SAP secara akurat karena rilis berkala Agent for SAP mungkin menambah atau mengubah metrik yang digunakan untuk evaluasi.
Untuk memastikan Anda memiliki Agen Google Cloud untuk SAP versi terbaru, Anda harus memeriksa update secara berkala dan mengupdate agen.
Menginstal update
Pilih sistem operasi Anda, lalu ikuti langkah-langkahnya:
RHEL
Buat koneksi SSH dengan VM host Anda.
Update agen dengan menjalankan perintah berikut:
sudo yum update google-cloud-sap-agent
SLES
Buat koneksi SSH dengan VM host Anda.
Update agen dengan menjalankan perintah berikut:
sudo zypper update google-cloud-sap-agent
Mengaktifkan kumpulan metrik evaluasi Workload Manager
Mulai versi 3.2, penginstalan baru Agent for SAP dari Google Cloud diaktifkan secara default untuk mengumpulkan metrik evaluasi Workload Manager. Jika mengupdate ke versi 3.2 dari versi sebelumnya, Anda juga dapat mengaktifkan fitur tersebut secara eksplisit. Caranya, ikuti langkah-langkah berikut:
Buat koneksi SSH dengan instance VM Compute Engine atau server Solusi Bare Metal.
Aktifkan fitur dengan menjalankan perintah berikut:
google_cloud_sap_agent configure -feature=workload_validation -enable
Untuk mengaktifkan pengumpulan metrik "SAP HANA Insights" dan "Praktik Terbaik Keamanan SAP HANA":
Buka file konfigurasi agen:
/etc/google-cloud-sap-agent/configuration.json
Atau, Anda juga dapat menjalankan konfigurasi ini dengan menjalankan perintah. Untuk mengetahui informasi selengkapnya, lihat Perintah konfigurasi untuk Agen Google Cloud untuk SAP.
Tambahkan bagian
workload_validation_db_metrics_config
setelahcollect_workload_validation_metrics
, lalu tentukan parameter berikut:hana_db_user
: menentukan akun pengguna database SAP HANA yang digunakan untuk mengkueri instance SAP HANA.hana_db_password_secret_name
: menentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna.hostname
: menentukan ID untuk mesin, baik lokal maupun jarak jauh, yang menghosting instance SAP HANA Anda.port
: menentukan port tempat instance SAP HANA Anda menerima kueri.
Untuk mengetahui informasi tentang parameter ini, lihat Parameter konfigurasi.
Secara opsional, di bagian
cloud_properties
, Anda dapat memperbarui parameter value yang ditetapkan secara otomatis. Untuk melakukannya, tambahkan bagiancloud_properties
ke file konfigurasi Anda, lalu tentukan parameter yang diperlukan dan nilainya.Simpan file konfigurasi.
Mulai ulang agen agar setelan baru diterapkan:
sudo systemctl restart google-cloud-sap-agent
Contoh file konfigurasi
Instance VM Compute Engine
Contoh berikut adalah file konfigurasi lengkap dari Agen untuk SAP Google Cloud yang berjalan di instance VM Compute Engine, yang mengaktifkan pengumpulan metrik evaluasi Workload Manager:{ "provide_sap_host_agent_metrics": true, "bare_metal": false, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": true, "workload_validation_db_metrics_frequency": 3600, "workload_validation_db_metrics_config": { "hana_db_user":"system", "hana_db_password_secret_name": "instance-id-hana-db-password-secret", "hostname": "localhost", "port": "30015" }, "collect_process_metrics": false }, "cloud_properties": { "project_id": "my-project", "instance_name": "vm-instance-1", "image": "rhel-8" }, "discovery_configuration": { "enable_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Server Solusi Bare Metal
Contoh berikut adalah file konfigurasi lengkap dari Agen untuk SAP Google Cloud yang berjalan di server Solusi Bare Metal, yang mengaktifkan pengumpulan metrik evaluasi Workload Manager:{ "provide_sap_host_agent_metrics": true, "bare_metal": true, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": true, "workload_validation_db_metrics_frequency": 3600, "workload_validation_db_metrics_config": { "hana_db_user":"system", "hana_db_password_secret_name": "instance-id-hana-db-password-secret", "hostname": "localhost", "port": "30015" }, "collect_process_metrics": false }, "cloud_properties": { "project_id": "my-project", "instance_name": "bms-machine-1"
"region": "us-central1", "image": "rhel-8" }, "discovery_configuration": { "enable_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Parameter konfigurasi
Tabel berikut menjelaskan parameter konfigurasi Agent for SAP Google Cloud yang spesifik untuk pengumpulan metrik evaluasi Workload Manager.
Parameter | |
---|---|
provide_sap_host_agent_metrics |
Untuk mengaktifkan pengumpulan metrik yang diperlukan oleh
Agen Host SAP, tentukan |
bare_metal |
Saat agen diinstal di server Solusi Bare Metal, tentukan
|
log_level |
Untuk menetapkan tingkat logging agen, tetapkan nilai yang diperlukan. Tingkat log yang tersedia adalah sebagai berikut:
Default-nya adalah |
log_to_cloud |
Untuk mengalihkan log agen ke
Cloud Logging, tentukan
|
cloud_properties.project_id |
Jika sistem SAP Anda berjalan pada server Solusi Bare Metal,
tentukan project ID dari project Google Cloud yang Anda
gunakan dengan Solusi Bare Metal. |
cloud_properties.instance_name
|
Jika sistem SAP Anda berjalan pada instance VM Compute Engine, tentukan nama instance VM tersebut. Agen secara otomatis mendeteksi nama instance VM saat penginstalan. Jika sistem SAP Anda berjalan di server Solusi Bare Metal, tentukan nama server tersebut. |
cloud_properties.region |
Jika sistem SAP Anda berjalan di server Solusi Bare Metal,
tentukan region server Solusi Bare Metal. |
cloud_properties.zone |
Ketika agen berjalan di instance VM, secara default, agen menggunakan zona instance VM tempat agen diinstal. |
cloud_properties.image |
Tentukan nama OS image instance. |
cloud_properties.numeric_project_id |
Tentukan ID numerik project Google Cloud tempat sistem SAP
berjalan. |
discovery_configuration.enable_workload_discovery |
Agar agen dapat mengumpulkan nama dan versi produk SAP
yang berjalan di host, tentukan Untuk informasi selengkapnya, lihat codebase agen di repositori GitHub |
discovery_configuration.enable_discovery |
Untuk mengirimkan informasi yang dikumpulkan agen tentang produk SAP yang berjalan di host ke Cloud Logging, tentukan Jika Anda menentukan nilai |
collection_configuration.collect_workload_validation_metrics |
Untuk mengaktifkan pengumpulan metrik evaluasi Workload Manager, tentukan |
collection_configuration.workload_validation_metrics_frequency |
Frekuensi pengumpulan metrik evaluasi Workload Manager dalam hitungan detik. Nilai defaultnya adalah Jika Anda perlu mengubah frekuensi pengumpulan metrik Workload Manager, tambahkan parameter |
collection_configuration.workload_validation_collection_definition.fetch_latest_config |
Opsional. Nilai defaultnya adalah |
collection_configuration.workload_validation_db_metrics_config.hana_db_user |
Tentukan akun pengguna yang digunakan untuk membuat kueri instance SAP HANA. Akun pengguna harus memiliki izin baca ke database SAP HANA. |
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name |
Tentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna. |
collection_configuration.workload_validation_db_metrics_config.hostname |
Tentukan ID untuk mesin, baik lokal maupun jarak jauh, yang menghosting instance SAP HANA Anda. Berikut ini adalah nilai yang didukung:
|
collection_configuration.workload_validation_db_metrics_config.port |
Tentukan port tempat instance SAP HANA Anda menerima kueri. Untuk
instance database tenant pertama atau satu-satunya, port-nya adalah
|
collection_configuration.workload_validation_db_metrics_frequency |
Frekuensi pengumpulan metrik database SAP HANA, dalam hitungan detik, untuk evaluasi Workload Manager.
Defaultnya adalah |