Versi 2: Mengonfigurasi pengumpulan metrik evaluasi Workload Manager

Panduan ini menunjukkan cara mengonfigurasi Agen Google Cloud untuk SAP versi 2 guna mengumpulkan metrik evaluasi Workload Manager dari sistem SAP Anda.

Untuk mengetahui informasi tentang fitur ini, lihat Evaluasi Workload Manager menggunakan Agen Google Cloud untuk SAP.

Sebelum memulai

Menetapkan peran IAM

Agar Agen Google Cloud untuk SAP dapat mengumpulkan metrik evaluasi Workload Manager, Anda harus memastikan bahwa akun layanan yang digunakan oleh instance Compute Engine atau server Solusi Bare Metal menyertakan peran berikut:

Untuk menambahkan peran yang diperlukan ini ke akun layanan Anda, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud, buka halaman IAM.

    Buka IAM

  2. Pilih project Google Cloud Anda.

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

  4. Pilih peran yang diperlukan dari daftar peran yang tersedia:

    • Compute Viewer
    • Monitoring > Monitoring Metric Writer
    • Secret Manager > Secret Manager Secret Accessor

  5. Klik Add atau Save untuk menerapkan peran ke akun layanan.

Mengaktifkan pengumpulan metrik evaluasi Workload Manager

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

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

  2. Buka file konfigurasi agen:

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

  3. Di bagian collection_configuration, untuk parameter collect_workload_validation_metrics, tetapkan nilai true.

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

  5. Secara opsional, di bagian cloud_properties, Anda dapat memperbarui nilai parameter yang ditetapkan secara otomatis. Untuk melakukannya, tambahkan bagian cloud_properties ke file konfigurasi, lalu tentukan parameter yang diperlukan dan nilainya.

  6. Simpan file konfigurasi.

  7. Mulai ulang agen agar setelan baru diterapkan:

    sudo systemctl restart google-cloud-sap-agent

Contoh file konfigurasi

Instance Compute Engine

Contoh berikut adalah file konfigurasi lengkap Agent for SAP Google Cloud versi 2 yang berjalan di instance Compute Engine, tempat pengumpulan metrik evaluasi Workload Manager diaktifkan:

{
  "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",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Server Solusi Bare Metal

Contoh berikut adalah file konfigurasi lengkap Agent for SAP Google Cloud versi 2 yang berjalan di server Solusi Bare Metal, tempat pengumpulan metrik evaluasi Workload Manager diaktifkan:

{
  "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",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1"
    "image": "rhel-8"
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Parameter konfigurasi

Tabel berikut menjelaskan parameter konfigurasi Agen Google Cloud untuk SAP yang khusus 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 level logging agen, tetapkan nilai yang diperlukan. Level 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 Compute Engine, secara default, agen akan mendeteksi project ID secara otomatis.
cloud_properties.instance_name

String

Jika sistem SAP Anda berjalan di instance Compute Engine, tentukan nama instance komputasi tersebut. Agen secara otomatis mendeteksi nama instance komputasi saat penginstalan.

Jika sistem SAP Anda berjalan di server Solusi Bare Metal, tentukan nama server tersebut. Pada agen versi 2.5 atau sebelumnya, 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 komputasi, secara default, agen menggunakan region tempat instance komputasi di-deploy.
cloud_properties.zone

String

Saat agen berjalan di instance komputasi, secara default, agen menggunakan zona tempat instance komputasi di-deploy.
cloud_properties.image

String

Tentukan nama OS image instance.

Saat agen berjalan di instance komputasi, secara default, agen akan otomatis mendeteksi OS image yang digunakan oleh instance komputasi.
cloud_properties.numeric_project_id

String

Tentukan ID numerik project Google Cloud tempat sistem SAP berjalan.

Saat agen berjalan di instance komputasi, secara default, agen akan otomatis mendeteksi nomor project.
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 default-nya adalah 300 detik.

Jika Anda perlu mengubah frekuensi pengumpulan metrik Workload Manager, tambahkan parameter workload_validation_metrics_frequency di bagian collection_configuration dan 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

String

Tentukan sandi untuk akun pengguna yang digunakan untuk membuat kueri instance 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.sid

String

Tentukan SID instance SAP HANA Anda.
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 komputer 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 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.