Versi 2: Mengonfigurasi kumpulan metrik evaluasi Workload Manager

Panduan ini menunjukkan cara mengonfigurasi versi 2 Agent for SAP Google Cloud untuk 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.

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)
Monitoring Metric Writer (roles/monitoring.metricWriter)
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
- Monitoring > Monitoring Metric Writer
- Secret Manager > Secret Manager Secret Accessor
Klik Add atau Save untuk menerapkan peran ke akun layanan.

Mengaktifkan kumpulan metrik evaluasi Workload Manager

Untuk mengaktifkan pengumpulan metrik evaluasi Workload Manager menggunakan Agent for SAP dari Google Cloud, ikuti langkah-langkah berikut:

Buat koneksi SSH dengan instance VM Compute Engine atau server Solusi Bare Metal.

Buka file konfigurasi agen:

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

Di bagian collection_configuration, untuk parameter collect_workload_validation_metrics, tetapkan nilai true.
Untuk mengaktifkan pengumpulan metrik workload.googleapis.com/sap/validation/hanasecurity yang mengaktifkan aturan evaluasi keamanan di Workload Manager, tambahkan bagian workload_validation_db_metrics_config setelah collect_workload_validation_metrics, lalu tentukan parameter berikut:
- hana_db_user: menentukan akun pengguna yang digunakan untuk membuat kueri instance SAP HANA.
- hana_db_password_secret_name: menentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna.
- hostname: menentukan ID untuk komputer, baik lokal atau 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`.
`sap_system_discovery`	`Boolean` Untuk mengaktifkan penemuan sistem SAP, tentukan `true`. Default-nya 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. Pada agen versi 2.5 atau yang lebih lama, tentukan nama server Solusi Bare Metal untuk properti `instance_id`.
`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.
`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_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.