Panduan ini menunjukkan cara mengonfigurasi Agen Google Clouduntuk SAP guna mengumpulkan metrik evaluasi Workload Manager dari sistem SAP Anda.
Untuk mengetahui informasi tentang fitur ini, lihat Evaluasi Workload Manager menggunakan Agen Google Clouduntuk SAP.
Sebelum memulai
- Validasi penginstalan Agen Google Clouduntuk 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 Clouduntuk SAP di Linux.
Pastikan Workload Manager API diaktifkan untuk projectGoogle Cloud Anda.
Peran IAM yang diperlukan
Untuk memastikan bahwa akun layanan memiliki izin yang diperlukan agar Agen Google Clouduntuk SAP dapat mengumpulkan metrik evaluasi Workload Manager, minta administrator untuk memberikan akun layanan peran IAM berikut di project Anda:
-
Compute Viewer (
roles/compute.viewer
): untuk mengumpulkan metrik evaluasi Workload Manager dari instance Compute Engine yang menghosting sistem SAP Anda. -
Workload Manager Insights Writer (
roles/workloadmanager.insightWriter
): untuk menulis metrik yang dikumpulkan ke data warehouse Workload Manager. -
(Opsional) Secret Manager Secret Accessor (
roles/secretmanager.secretAccessor
): jika Anda menggunakan Secret Manager untuk menyimpan sandi guna terhubung ke database SAP HANA.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk mengizinkan Agen Google Clouduntuk SAP mengumpulkan metrik evaluasi Pengelola Beban Kerja. Untuk melihat izin yang pasti diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan agar Agen Google Clouduntuk SAP dapat mengumpulkan metrik evaluasi Workload Manager:
-
Untuk mengumpulkan metrik evaluasi Workload Manager dari instance Compute Engine host dan menulisnya ke data warehouse Workload Manager:
-
monitoring.timeSeries.create
-
compute.zoneOperations.list
-
compute.disks.list
-
compute.nodeGroups.get
-
workloadmanager.insights.write
-
-
Jika Anda menggunakan Secret Manager untuk menyimpan sandi guna terhubung ke database SAP HANA, untuk mengakses secret:
secretmanager.versions.access
Administrator Anda mungkin juga dapat memberikan izin ini kepada akun layanan dengan peran khusus atau peran bawaan lainnya.
Peran SAP HANA yang diperlukan
Agar agen dapat mengumpulkan metrik dari database SAP HANA, pastikan pengguna SAP HANA
yang Anda tentukan dalam file konfigurasi agen memiliki peran MONITORING
.
Untuk informasi tentang peran ini, lihat dokumen SAP Peran Database Standar.
Memverifikasi versi agen
Google Cloud menyarankan agar Anda menginstal Agent for SAP versi terbaru untuk evaluasi yang akurat terhadap workload SAP karena rilis berkala Agent for SAP dapat menambahkan atau mengubah metrik yang digunakan untuk evaluasi.
Untuk memastikan Anda memiliki Agen Google Clouduntuk 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 instance Anda.
- Update instance agen Anda:
- (Direkomendasikan) Untuk mengupdate ke versi 3.7 (terbaru) agen:
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, seperti3.1-606637668
. Untuk informasi tentang versi agen yang dapat Anda instal, lihat Mencantumkan semua versi agen yang tersedia.
- (Direkomendasikan) Untuk mengupdate ke versi 3.7 (terbaru) agen:
SLES
- Buat koneksi SSH dengan instance Anda.
- Update instance agen Anda:
- (Direkomendasikan) Untuk mengupdate ke versi 3.7 (terbaru) agen:
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, seperti3.1-606637668
. Untuk informasi tentang versi agen yang dapat Anda instal, lihat Mencantumkan semua versi agen yang tersedia.
- (Direkomendasikan) Untuk mengupdate ke versi 3.7 (terbaru) agen:
Mengaktifkan pengumpulan metrik evaluasi Workload Manager
Mulai versi 3.2, penginstalan baru Agent for SAP Google Clouddiaktifkan 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, selesaikan langkah-langkah berikut:
Buat koneksi SSH dengan instance Compute Engine atau server Solusi Bare Metal.
Agar agen dapat mengumpulkan metrik evaluasi Workload Manager:
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable
Untuk mengaktifkan pengumpulan metrik "SAP HANA Insights" dan "SAP HANA Security Best Practices":
Buka file konfigurasi agen:
/etc/google-cloud-sap-agent/configuration.json
Atau, Anda juga dapat melakukan konfigurasi ini dengan menjalankan perintah. Untuk informasi selengkapnya, lihat Perintah konfigurasi untuk Agen Google Clouduntuk SAP.
Tambahkan bagian
workload_validation_db_metrics_config
setelahcollect_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 database tempat instance SAP HANA Anda menerima kueri. Misalnya, masukkan30015
jika database tenant Anda memproses di port30015
.sid
: menentukan SID instance SAP HANA Andahana_db_password_secret_name
: menentukan nama secret di Secret Manager yang menyimpan sandi akun penggunaSebagai alternatif secret, Anda dapat menggunakan parameter konfigurasi
hdbuserstore_key
.hdbuserstore_key
: tentukan kuncihdbuserstore
yang mengautentikasi pengguna yang Anda tentukan untukhana_db_user
Jika menentukan
hdbuserstore_key
, Anda akan melewati penentuan parameterhostname
danport
.
Untuk mengetahui informasi tentang parameter ini, lihat Parameter konfigurasi.
Secara opsional, di bagian
cloud_properties
, Anda dapat memperbarui nilai parameter yang ditetapkan secara otomatis. Untuk melakukannya, tambahkan bagiancloud_properties
ke file konfigurasi, 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 Compute Engine
Contoh berikut adalah file konfigurasi lengkap dari Agent for SAPGoogle Cloudyang 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 Agent for SAPGoogle Cloudyang 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 Agent for SAPGoogle Cloudyang khusus untuk pengumpulan metrik evaluasi Workload Manager.
Parameter | |
---|---|
provide_sap_host_agent_metrics |
Untuk mengaktifkan pengumpulan metrik yang diperlukan oleh
Agen Host SAP, tentukan |
bare_metal |
Saat agen diinstal di server Solusi Bare Metal, tentukan
|
log_level |
Untuk menetapkan level logging agen, tetapkan nilai yang diperlukan. Level log yang tersedia adalah sebagai berikut:
Default-nya adalah |
log_to_cloud |
Untuk mengalihkan log agen ke
Cloud Logging, tentukan
|
cloud_properties.project_id |
Jika sistem SAP Anda berjalan di server Solusi Bare Metal, tentukan project ID dari Google Cloud project yang Anda
gunakan dengan Solusi Bare Metal. |
cloud_properties.instance_name
|
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. |
cloud_properties.region |
Jika sistem SAP Anda berjalan di server Solusi Bare Metal,
tentukan region server Solusi Bare Metal. |
cloud_properties.zone |
Saat agen berjalan di instance komputasi, secara default, agen menggunakan zona tempat instance komputasi di-deploy. |
cloud_properties.image |
Tentukan nama OS image instance. |
cloud_properties.numeric_project_id |
Tentukan ID numerik project Google Cloud tempat sistem SAP
berjalan. |
discovery_configuration.enable_workload_discovery |
Agar agen dapat mengumpulkan nama dan versi produk SAP
yang berjalan di host, tentukan Untuk mengetahui informasi selengkapnya, lihat codebase agen di repositori GitHub |
discovery_configuration.enable_discovery |
Untuk mengirim informasi yang dikumpulkan agen tentang produk SAP yang berjalan di host ke Cloud Logging, tentukan Jika Anda menentukan nilai |
collection_configuration.collect_workload_validation_metrics |
Untuk mengaktifkan pengumpulan metrik evaluasi Workload Manager, tentukan |
collection_configuration.workload_validation_metrics_frequency |
Frekuensi pengumpulan metrik evaluasi Workload Manager
dalam hitungan detik. Nilai default-nya adalah Jika Anda perlu mengubah frekuensi pengumpulan
metrik Workload Manager, tambahkan parameter
|
collection_configuration.workload_validation_collection_definition.fetch_latest_config |
Opsional. Nilai defaultnya adalah |
collection_configuration.workload_validation_db_metrics_config.hana_db_user |
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 |
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
|
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name |
Tentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna. Atau, Anda dapat menentukan parameter konfigurasi Untuk autentikasi SAP HANA, agen menggunakan urutan
preferensi berikut: jika ditentukan, parameter konfigurasi
|
collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key
|
Untuk terhubung dengan aman ke sistem SAP HANA, tentukan kunci
Secure user store ( Untuk menggunakan kunci
Parameter konfigurasi ini didukung mulai agen versi 3.3. Jika menentukan Untuk autentikasi SAP HANA, agen menggunakan urutan
preferensi berikut: jika ditentukan, parameter konfigurasi
|
collection_configuration.workload_validation_db_metrics_config.sid |
Tentukan SID instance SAP HANA Anda. |
collection_configuration.workload_validation_db_metrics_config.hostname |
Tentukan ID untuk mesin, baik lokal maupun jarak jauh, yang menghosting instance SAP HANA Anda. Berikut ini adalah nilai yang didukung:
|
collection_configuration.workload_validation_db_metrics_config.port |
Tentukan port tempat instance SAP HANA Anda menerima kueri. Untuk
instance database tenant pertama atau satu-satunya, port-nya adalah
|
collection_configuration.workload_validation_db_metrics_frequency |
Frekuensi pengumpulan metrik database SAP HANA, dalam detik,
untuk evaluasi Workload Manager.
Defaultnya adalah |
Memvalidasi penyiapan untuk pengumpulan metrik evaluasi Workload Manager
Anda dapat memvalidasi apakah Anda memiliki penyiapan Google Cloud yang benar untuk
pengumpulan metrik evaluasi Workload Manager dengan menjalankan
perintah status
agen. Perintah ini didukung mulai agen
versi 3.7.
Untuk memvalidasi penyiapan Google Cloud , selesaikan langkah-langkah berikut:
- Buat koneksi SSH dengan instance Compute Engine Anda.
- Jalankan perintah berikut:
sudo /usr/bin/google_cloud_sap_agent status
Jika Google Cloud penyiapan untuk pengumpulan metrik evaluasi Workload Manager sudah benar, output akan menyertakan hal berikut. Konfigurasi Anda mungkin memiliki nilai selain nilai
default
.Agent Status: ... Systemd Service Enabled: True Systemd Service Running: True Cloud API Full Scopes: True Configuration File: /etc/google-cloud-sap-agent/configuration.json Configuration Valid: True ... ---------------------------------------------------------------------------- System Discovery: Enabled Status: Fully Functional IAM Permissions: All granted Configuration: enable_discovery: true (default) enable_workload_discovery: true (default) sap_instances_update_frequency: 60 (default) system_discovery_update_frequency: 14400 (default) ---------------------------------------------------------------------------- Workload Manager Evaluation: Enabled Status: Fully Functional IAM Permissions: All granted Configuration: collect_workload_validation_metrics: true (default) config_target_environment: PRODUCTION (default) fetch_latest_config: true (default) workload_validation_db_metrics_frequency: 3600 (default) workload_validation_metrics_frequency: 300 (default) ...
- Jika output Anda menunjukkan bahwa beberapa penyiapan tidak ada, tinjau
informasi yang diberikan di bagian sebelumnya, lakukan tindakan yang diperlukan,
lalu jalankan kembali perintah
status
untuk memvalidasi ulang penyiapan.
Melihat metrik yang dikumpulkan
Untuk melihat metrik evaluasi Workload Manager yang dikumpulkan agen, Anda dapat melakukan hal berikut:
Lihat file log agen:
Tetapkan level log agen ke
DEBUG
:sudo /usr/bin/google_cloud_sap_agent configure -loglevel=debug
Setelah agen dimulai ulang untuk menerapkan level log baru, lihat file log agen:
/var/log/google-cloud-sap-agent.log
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.