Mengonfigurasi pengumpulan metrik evaluasi Workload Manager

Panduan ini menunjukkan cara mengonfigurasi Agen Google Cloud untuk SAP 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
    • Workload Manager > Workload Manager Insights Writer
    • Secret Manager > Secret Manager Secret Accessor

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

Memverifikasi versi agen

Google Cloud merekomendasikan agar Anda menginstal Agen untuk SAP versi terbaru untuk evaluasi yang akurat terhadap workload SAP karena rilis berkala Agen untuk SAP dapat menambahkan 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

  1. Buat koneksi SSH dengan instance Anda.
  2. Perbarui instance agen Anda:
    • (Direkomendasikan) Untuk mengupdate ke agen versi 3.6 (terbaru): 
      sudo yum --nogpgcheck update google-cloud-sap-agent
    • Untuk mengupdate ke versi agen tertentu: 
      sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Ganti VERSION_NUMBER dengan nomor versi agen yang ingin Anda instal, seperti 3.1-606637668. Untuk informasi tentang versi agen yang dapat Anda instal, lihat Mencantumkan semua versi agen yang tersedia.

SLES

  1. Buat koneksi SSH dengan instance Anda.
  2. Perbarui instance agen Anda:
    • (Direkomendasikan) Untuk mengupdate ke agen versi 3.6 (terbaru): 
      sudo zypper --no-gpg-checks update google-cloud-sap-agent
    • Untuk mengupdate ke versi agen tertentu: 
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Ganti VERSION_NUMBER dengan nomor versi agen yang ingin Anda instal, seperti 3.1-606637668. Untuk informasi tentang versi agen yang dapat Anda instal, lihat Mencantumkan semua versi agen yang tersedia.

Mengaktifkan pengumpulan metrik evaluasi Workload Manager

Mulai versi 3.2, penginstalan baru Agen Google Cloud untuk SAP diaktifkan secara default untuk mengumpulkan metrik evaluasi Workload Manager. Jika mengupdate ke versi 3.2 dari versi sebelumnya, Anda juga dapat mengaktifkan fitur ini secara eksplisit. Caranya, ikuti langkah-langkah berikut:

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

  2. Agar agen dapat mengumpulkan metrik evaluasi Workload Manager: 

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable

  3. Untuk mengaktifkan pengumpulan metrik "SAP HANA Insights" dan "SAP HANA Security Best Practices":

    1. Buka file konfigurasi agen:

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

      Atau, Anda juga dapat melakukan 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 membuat kueri instance SAP HANA.
      • 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.
      • sid: menentukan SID instance SAP HANA Anda

      • hana_db_password_secret_name: menentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna

        Sebagai alternatif secret, Anda dapat menggunakan parameter konfigurasi hdbuserstore_key.

      • hdbuserstore_key: tentukan kunci hdbuserstore yang mengautentikasi pengguna yang Anda tentukan untuk hana_db_user

        Jika menentukan hdbuserstore_key, Anda akan melewati penentuan parameter hostname dan port.

      Untuk mengetahui informasi tentang parameter ini, lihat Parameter konfigurasi.

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

  5. Simpan file konfigurasi.

  6. 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 dari Agen Google Cloud untuk SAP yang berjalan di instance Compute Engine, tempat pengumpulan metrik evaluasi Workload Manager diaktifkan.

Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter hana_db_password, yang lebih disukai daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.

  • Contoh berikut menggunakan kunci Penyimpanan pengguna yang aman (hdbuserstore) untuk autentikasi SAP HANA: 
    {
  "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",
      "hdbuserstore_key": "user_store_key"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • Contoh berikut menggunakan nama pengguna dan secret Secret Manager untuk autentikasi SAP HANA: 
    {
  "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
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • Contoh berikut menggunakan nama pengguna dan sandi untuk autentikasi SAP HANA. Sebaiknya gunakan secret Secret Manager atau kunci Penyimpanan pengguna yang aman (hdbuserstore) untuk autentikasi SAP HANA. 
    {
  "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": "TempPa55word",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Server Solusi Bare Metal

Contoh berikut adalah file konfigurasi lengkap dari Agen Google Cloud untuk SAP yang berjalan di instance Compute Engineserver Solusi Bare Metal, tempat pengumpulan metrik evaluasi Workload Manager diaktifkan.

Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter hana_db_password, yang lebih disukai daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.

  • Contoh berikut menggunakan kunci Penyimpanan pengguna yang aman (hdbuserstore) untuk autentikasi SAP HANA: 
    {
  "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",
      "hdbuserstore_key": "user_store_key"
    },
    "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,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • Contoh berikut menggunakan nama pengguna dan secret Secret Manager untuk autentikasi SAP HANA: 
    {
  "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
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1"
    "image": "rhel-8"
  },
      "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • Contoh berikut menggunakan nama pengguna dan sandi untuk autentikasi SAP HANA. Sebaiknya gunakan secret Secret Manager atau kunci Penyimpanan pengguna yang aman (hdbuserstore) untuk autentikasi SAP HANA. 
    {
  "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": "TempPa55word",
      "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,
    "enable_workload_discovery": true
  },
  "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.
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 pada 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.
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.
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 mengetahui informasi selengkapnya, lihat codebase agen di repositori GitHub google-cloud-sap-agent di bagian GoogleCloudPlatform/sapagent.

discovery_configuration.enable_discovery

Boolean

Untuk mengirim 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 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_collection_definition.fetch_latest_config

Boolean

Opsional. Nilai defaultnya adalah true, yang memungkinkan agen mengumpulkan kumpulan metrik evaluasi Workload Manager terbaru tanpa mengharuskan Anda mengupdate agen. Jika Anda ingin menonaktifkan perilaku ini, tentukan parameter ini dalam file konfigurasi 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

String

Tentukan sandi untuk akun pengguna yang digunakan untuk membuat kueri instance SAP HANA.

Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter hana_db_password, yang lebih disukai daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.

collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name

String

Tentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna.

Atau, Anda dapat menentukan parameter konfigurasi hdbuserstore_key untuk mengautentikasi pengguna SAP HANA yang ditentukan.

Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter hana_db_password, yang lebih disukai daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.

collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key

String

Untuk terhubung dengan aman ke sistem SAP HANA, tentukan kunci Secure user store (hdbuserstore) yang telah Anda buat untuk sistem tersebut.

Untuk menggunakan kunci hdbuserstore untuk autentikasi, pastikan hal berikut:

  • Alat SAP hdbsql dan hdbuserstore diinstal di instance compute yang menghosting agen.
  • Kunci hdbuserstore sesuai dengan satu instance SAP HANA tertentu. Anda tidak dapat menggunakan kunci yang berisi nama host beberapa instance SAP HANA.
  • Pengguna SIDadm dapat membuat kueri database SAP HANA menggunakan kunci ini. Di sini, SID mengacu pada nilai yang telah Anda tentukan untuk parameter sid. Anda dapat memverifikasinya dengan menjalankan perintah berikut sebagai pengguna SIDadm: 
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Parameter konfigurasi ini didukung mulai agen versi 3.3.

Jika menentukan hdbuserstore_key, Anda dapat melewati penentuan parameter hostname dan port.

Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter hana_db_password, yang lebih disukai daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.

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.

Melihat metrik yang dikumpulkan

Untuk melihat metrik evaluasi Workload Manager yang dikumpulkan agen, Anda dapat melakukan hal berikut:

  • Lihat file log agen:

    1. Tetapkan level log agen ke DEBUG:

      sudo /usr/bin/google_cloud_sap_agent configure -loglevel=debug

    2. Setelah agen dimulai ulang untuk menerapkan level log baru, lihat file log agen:

      /var/log/google-cloud-sap-agent.log

    3. Dalam file log, cari entri yang berisi hal berikut:

      workload.googleapis.com/sap/validation/

      Berikut adalah contoh yang menunjukkan metrik evaluasi Workload Manager dalam file log agen:

      {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
      "metric":"workload.googleapis.com/sap/validation/system","value":1}
{"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
      "key":"instance_name","value":"n1-hana-sles15"}
{"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
      "key":"os","value":"sles-15-SP4"}
...
{"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
      "metric":"workload.googleapis.com/sap/validation/corosync","value":0}
...

  • Jika instance agen Anda dikonfigurasi untuk mengirim log ke Cloud Logging, Anda dapat melihat log agen di Cloud Logging.

  • Buat dan jalankan evaluasi untuk workload SAP Anda di Workload Manager. Untuk informasi selengkapnya, lihat Membuat dan menjalankan evaluasi.

    Untuk mengetahui informasi tentang praktik terbaik yang didukung Workload Manager untuk mengevaluasi workload SAP yang berjalan di Google Cloud, lihat Praktik terbaik Workload Manager untuk SAP.