Mengonfigurasi kumpulan metrik evaluasi Workload Manager

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.

Buka 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":
1. 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.
2. Tambahkan bagian workload_validation_db_metrics_config setelah collect_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 bagian cloud_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`	`Boolean` Untuk mengaktifkan pengumpulan metrik yang diperlukan oleh Agen Host SAP, tentukan `true`. Default-nya adalah `true`. Jangan tetapkan `provide_sap_host_agent_metrics` ke `false` kecuali jika Anda diarahkan oleh Cloud Customer Care atau Dukungan SAP.
`bare_metal`	`Boolean` Saat agen diinstal di server Solusi Bare Metal, tentukan `true`. Default-nya adalah `false`.
`log_level`	`String` Untuk menetapkan tingkat logging agen, tetapkan nilai yang diperlukan. Tingkat log yang tersedia adalah sebagai berikut: `DEBUG` `INFO` `WARNING` `ERROR` Default-nya 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`. Defaultnya adalah `true`.
`cloud_properties.project_id`	`String` Jika sistem SAP Anda berjalan pada server Solusi Bare Metal, tentukan project ID dari project Google Cloud yang Anda gunakan dengan Solusi Bare Metal. Saat agen berjalan di instance VM, secara default, agen akan mendeteksi project ID secara otomatis.
`cloud_properties.instance_name`	`String` 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`	`String` Jika sistem SAP Anda berjalan di server Solusi Bare Metal, tentukan region server Solusi Bare Metal. Ketika agen berjalan di instance VM, secara default, agen menggunakan region instance VM tempat agen diinstal.
`cloud_properties.zone`	`String` Ketika agen berjalan di instance VM, secara default, agen menggunakan zona instance VM tempat agen diinstal.
`cloud_properties.image`	`String` Tentukan nama OS image instance. Saat agen berjalan di instance VM, secara default, agen mendeteksi OS image dari instance VM tempat agen diinstal.
`cloud_properties.numeric_project_id`	`String` Tentukan ID numerik project Google Cloud tempat sistem SAP berjalan. Saat agen berjalan di instance VM, secara default, agen mendeteksi project ID numerik secara otomatis.
`discovery_configuration.enable_workload_discovery`	`Boolean` Agar agen dapat mengumpulkan nama dan versi produk SAP yang berjalan di host, tentukan `true`. Nilai defaultnya adalah `true`. Untuk informasi selengkapnya, lihat codebase agen di repositori GitHub `google-cloud-sap-agent` di bagian GoogleCloudPlatform/sapagent.
`discovery_configuration.enable_discovery`	`Boolean` Untuk mengirimkan informasi yang dikumpulkan agen tentang produk SAP yang berjalan di host ke Cloud Logging, tentukan `true`. Nilai defaultnya adalah `true`. Jika Anda menentukan nilai `false`, agen akan menyimpan informasi yang dikumpulkan di host dan tidak mengirimkannya ke Cloud Logging.
`collection_configuration.collect_workload_validation_metrics`	`Boolean` Untuk mengaktifkan pengumpulan metrik evaluasi Workload Manager, tentukan `true`. Mulai versi 3.2, nilai defaultnya adalah `true`. Parameter ini hanya berlaku untuk Linux.
`collection_configuration.workload_validation_metrics_frequency`	`Int` Frekuensi pengumpulan metrik evaluasi Workload Manager dalam hitungan detik. Nilai defaultnya adalah `300` detik. Sebaiknya jangan ubah frekuensi pengumpulan default karena dapat memengaruhi seluruh fitur itu sendiri. Jika Anda perlu mengubah frekuensi pengumpulan metrik Workload Manager, tambahkan parameter `workload_validation_metrics_frequency` di bagian `collection_configuration`, lalu berikan nilai yang diperlukan.
`collection_configuration.workload_validation_collection_definition.fetch_latest_config`	`Boolean` Opsional. Nilai defaultnya adalah `true`, yang memungkinkan agen mengumpulkan rangkaian metrik evaluasi Workload Manager terbaru tanpa mengharuskan Anda memperbarui agen. Jika ingin menonaktifkan perilaku ini, tentukan parameter ini dalam file konfigurasi Anda dan tetapkan nilainya ke `false`.
`collection_configuration.workload_validation_db_metrics_config.hana_db_user`	`String` 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`	`String` Tentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna.
`collection_configuration.workload_validation_db_metrics_config.hostname`	`String` Tentukan ID untuk mesin, baik lokal maupun jarak jauh, yang menghosting instance SAP HANA Anda. Berikut ini adalah nilai yang didukung: Jika host adalah komputer lokal, tentukan string `localhost` atau alamat IP loopback localhost, seperti `127.0.0.1`. Jika host adalah mesin jarak jauh, tentukan alamat IP internal atau eksternalnya.
`collection_configuration.workload_validation_db_metrics_config.port`	`String` Tentukan port tempat instance SAP HANA Anda menerima kueri. Untuk instance database tenant pertama atau satu-satunya, port-nya adalah `3NN15`, dengan `NN` sebagai nomor instance dari instance SAP HANA.
`collection_configuration.workload_validation_db_metrics_frequency`	`Int` Frekuensi pengumpulan metrik database SAP HANA, dalam hitungan detik, untuk evaluasi Workload Manager. Defaultnya adalah `3600` detik. Meskipun Anda dapat memperbarui frekuensi pengumpulan metrik database SAP HANA, sebaiknya gunakan nilai default. Jika Anda perlu mengubah nilai default, tambahkan parameter `workload_validation_db_metrics_frequency` di bagian `collection_configuration` dan berikan nilai yang diperlukan. Pastikan Anda tidak menetapkan frekuensi pengumpulan yang lebih besar dari `3600` detik.