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

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:

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:

    • Viewer Komputasi
    • Monitoring > Monitoring Metric Writer
    • Secret Manager > Secret Manager Secret Accessor
  5. 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:

  1. Buat koneksi SSH dengan instance VM 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 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.

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

  6. Simpan file konfigurasi.

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

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.