Menginstal dan mengonfigurasi Agen Google Cloud untuk SAP di server Solusi Bare Metal

Agen Google Cloud untuk SAP diperlukan untuk dukungan SAP bagi sistem SAP yang berjalan di server Solusi Bare Metal.

Jika Anda menggunakan OS image RHEL atau SLES "for SAP" berikut yang disediakan Google Cloud, Agen Google Cloud untuk SAP akan dikemas dengan OS image:

RHEL: semua image "for SAP"
SLES: SLES 15 SP4 untuk SAP dan versi yang lebih baru

Untuk informasi tentang sistem operasi yang tersedia untuk menjalankan SAP pada server Solusi Bare Metal, lihat artikel berikut:

Untuk SAP HANA, lihat Sistem operasi bersertifikasi.
Untuk SAP NetWeaver, lihat Sistem operasi bersertifikasi.

Untuk menginstal dan mengonfigurasi versi 2 Agen untuk SAP Google Cloud pada instance VM Compute Engine, baca artikel Menginstal Agen Google Cloud untuk SAP pada instance VM Compute Engine.

Ringkasan penginstalan

Anda menginstal Agen Google Cloud untuk SAP menggunakan perintah pengelolaan paket sistem operasi standar: di RHEL, perintah yum; di SLES, perintah zypper. Perintah pengelolaan paket akan menyelesaikan tugas berikut:

Download Agen Google Cloud untuk SAP.
Membuat agen sebagai layanan systemd Linux, yang bernama google-cloud-sap-agent.
Mengaktifkan dan memulai layanan, google-cloud-sap-agent.

Menginstal agen

Sebaiknya instal Agent for SAP Google Cloud versi terbaru, yang mendukung lebih banyak fitur. Untuk mengetahui petunjuknya, lihat Menginstal dan mengonfigurasi Agen Google Cloud untuk SAP di server Solusi Bare Metal.

Untuk menginstal Agent for SAP Google Cloud versi 2, hubungi Cloud Customer Care.

Setelah menginstal Agen Google Cloud untuk SAP dan Agen Host SAP, validasikan penginstalan Agen Google Cloud untuk SAP, sebagaimana dijelaskan dalam Memvalidasi penginstalan agen.

Memvalidasi penginstalan agen Anda

Membuat koneksi SSH dengan server Solusi Bare Metal.

Jalankan perintah berikut:

systemctl status google-cloud-sap-agent

Jika agen berfungsi dengan baik, output akan berisi active (running). Contoh:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Jika agen tidak berjalan, mulai ulang agen.

Memverifikasi bahwa Agen Host SAP menerima metrik

Untuk memverifikasi bahwa metrik infrastruktur dikumpulkan oleh Agen Google Cloud untuk SAP dan dikirim dengan benar ke Agen Host SAP, ikuti langkah-langkah berikut:

Di sistem SAP, masukkan transaksi ST06.
Di panel ringkasan, periksa ketersediaan dan konten kolom berikut untuk penyiapan infrastruktur pemantauan SAP dan Google yang menyeluruh dan benar:
- Penyedia Cloud: Google Cloud Platform
- Akses Pemantauan yang Ditingkatkan: TRUE
- Detail Pemantauan yang Ditingkatkan: ACTIVE

Mengonfigurasi Agen Google Cloud untuk SAP di Linux

Setelah menginstal Agen Google Cloud untuk SAP, Anda dapat mengonfigurasi agen untuk mengumpulkan metrik Pemantauan Proses, metrik evaluasi Workload Manager, dan metrik pemantauan SAP HANA. Secara default, pengumpulan hanya metrik Agen Host SAP diaktifkan.

Prasyarat

Guna mengaktifkan fitur ini untuk instance agen yang berjalan di server Solusi Bare Metal, Anda harus menyelesaikan prasyarat berikut:

Buat akun layanan IAM untuk agen agar dapat mengakses resource Google Cloud, lalu berikan peran IAM yang diperlukan ke akun layanan tersebut. Lihat Menyiapkan akun layanan untuk mengetahui detailnya.
Di server Solusi Bare Metal, instal gcloud CLI. Baca artikel Menginstal gcloud CLI untuk mengetahui detailnya.
Untuk mengakses Google Cloud, izinkan gcloud CLI. Baca artikel Mengizinkan gcloud CLI untuk mengetahui detailnya.
Buat koneksi ke Google Cloud API. Lihat Mengonfigurasi Akses Google Pribadi untuk host lokal untuk mengetahui detailnya.

Menyiapkan akun layanan

Agar agen dapat mengakses resource Google Cloud dari lingkungan Solusi Bare Metal, Anda harus menyiapkan akun layanan IAM.

Setidaknya, akun layanan yang digunakan agen harus menyertakan peran Monitoring Metric Writer (roles/monitoring.metricWriter).

Untuk membuat akun layanan, ikuti langkah-langkah berikut:

Buat akun layanan:
1. Di konsol Google Cloud, buka halaman Buat akun layanan.
  Buka Create service account
2. Pilih project Anda.
3. Di kolom Nama akun layanan, masukkan nama. Konsol Google Cloud akan mengisi kolom ID akun layanan berdasarkan nama ini.
  
  Di kolom Deskripsi akun layanan, masukkan sebuah deskripsi. Sebagai contoh, Service account for quickstart.
4. Klik Buat dan lanjutkan.
5. Berikan peran Monitoring > Monitoring Metric Writer ke akun layanan.
  
  Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih Monitoring > Monitoring Metric Writer.
  
  Catatan: Kolom Peran memengaruhi resource mana yang dapat diakses oleh akun layanan di project Anda. Anda dapat mencabut peran ini atau memberikan peran tambahan di lain waktu. Dalam lingkungan produksi, jangan berikan peran Owner, Editor, atau Viewer. Sebagai gantinya, berikan peran standar atau peran khusus yang memenuhi kebutuhan Anda.
6. Klik Lanjutkan.
7. Klik Selesai untuk menyelesaikan pembuatan akun layanan.
  
  Jangan tutup jendela browser Anda. Anda akan menggunakannya pada langkah berikutnya.
Membuat kunci akun layanan:
1. Di konsol Google Cloud, klik alamat email untuk akun layanan yang telah dibuat.
2. Klik Kunci.
3. Klik Tambahkan kunci, lalu klik Buat kunci baru.
4. Klik Create. File kunci JSON akan didownload ke komputer Anda.
5. Klik Close.

Setelah membuat akun layanan, pastikan untuk mengupload file kunci JSON-nya ke lokasi aman di server Solusi Bare Metal yang dapat diakses oleh agen.

Aktifkan fitur

Setelah menyiapkan akun layanan untuk Solusi Bare Metal dan memberikan peran yang diperlukan, Anda dapat mengaktifkan fitur lain dari Agen Google Cloud untuk SAP dengan melakukan konfigurasi berikut:

File konfigurasi default

Cuplikan berikut adalah contoh konfigurasi default versi 2 Agent for SAP dari Google Cloud:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": ,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Parameter konfigurasi

Tabel berikut menjelaskan parameter konfigurasi versi 2 Agent for SAP dari Google Cloud.

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` Tentukan nama server Solusi Bare Metal tempat Anda menginstal agen. 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_process_metrics`	`Boolean` Untuk mengaktifkan pengumpulan metrik Process Monitoring, tentukan `true`. Default-nya adalah `false`. Parameter ini hanya berlaku untuk Linux. Jika mengaktifkan pengumpulan metrik Proses untuk SAP HANA, Anda perlu menyiapkan parameter tambahan yang tercantum di bagian `hana_metrics_config`.
`collection_configuration.process_metrics_frequency`	`Int` Dari versi 2.6, parameter ini menentukan frekuensi pengumpulan metrik Process Monitoring yang berubah dengan cepat, dalam hitungan detik. Metrik Pemantauan Proses yang cepat berubah adalah: `sap/hana/availability`, `sap/hana/ha/availability`, dan `sap/nw/availability`. Nilai default untuk parameter ini adalah `5` detik. Sebaiknya gunakan nilai default ini. Semua metrik Process Monitoring lainnya (berubah lambat) dikumpulkan pada frekuensi default 30 detik. Untuk mengubah frekuensi pengumpulan metrik Pemantauan Proses yang lambat, gunakan parameter `slow_process_metrics_frequency`.
`collection_configuration.slow_process_metrics_frequency`	`Int` Tentukan frekuensi pengumpulan metrik Pemantauan Proses yang lambat, dalam hitungan detik. Nilai default untuk parameter ini adalah `30` detik.
`collection_configuration.process_metrics_to_skip`	`Array` Tentukan metrik Process Monitoring yang Anda tidak ingin dikumpulkan oleh agen. Parameter ini menerima nilai yang dipisahkan koma dari nama metrik Process Monitoring. Contoh: `"process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"]`.
`collection_configuration.hana_metrics_config.hana_db_user`	`String` Tentukan akun pengguna database yang digunakan agen untuk membuat kueri SAP HANA. Default-nya adalah `SYSTEM`.
`collection_configuration.hana_metrics_config.hana_db_password`	`String` Tentukan sandi teks biasa untuk akun pengguna database yang digunakan agen untuk mengkueri SAP HANA. Daripada menggunakan sandi teks biasa, sebaiknya gunakan secret di Secret Manager dengan menentukan nama secret di `hana_db_password_secret_name`. Jangan tentukan sandi jika Anda menggunakan Secret Manager untuk menyimpan kredensial pengguna database. Jika `hana_db_password` dan `hana_db_password_secret_name` ditentukan dalam konfigurasi, error akan dipicu dan agen tidak dapat terhubung ke database.
`collection_configuration.hana_metrics_config.hana_db_password_secret_name`	`String` Untuk memberikan sandi dengan aman bagi akun pengguna database yang digunakan agen untuk mengkueri SAP HANA, tentukan nama secret yang berisi kredensial keamanan untuk akun pengguna database. Metrik terkait SAP HANA dikumpulkan hanya jika `hana_db_password_secret_name` atau `hana_db_password` ditetapkan. Penting: Secret dan instance VM host harus ada di project Google Cloud yang sama.
`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.
`hana_monitoring_configuration.enabled`	`Boolean` Opsional. Agar dapat mengaktifkan Agen Google Cloud untuk SAP untuk mengumpulkan metrik pemantauan SAP HANA, tentukan `true`. Nilai defaultnya adalah `false`. Parameter turunan berikut hanya berlaku jika Anda menentukan `hana_monitoring_configuration.enabled: true`.
`hana_monitoring_configuration.sample_interval_sec`	`Int` Opsional. Tentukan interval sampel, dalam detik, yang menentukan frekuensi saat Agen Google Cloud untuk SAP mengkueri instance SAP HANA Anda guna mengumpulkan metrik pemantauan SAP HANA. Nilai default-nya adalah 300 detik. Untuk setiap kueri yang ditentukan dalam file konfigurasi Agent for SAP Google Cloud, Anda dapat menimpa interval sampel global dengan menentukan interval yang diperlukan ke parameter `sample_interval_sec`. Interval sampel harus 5 detik atau lebih lama.
`hana_monitoring_configuration.query_timeout_sec`	`Int` Opsional. Tentukan waktu tunggu untuk setiap kueri yang diajukan ke instance SAP HANA. Nilai default-nya adalah 300 detik.
`hana_monitoring_configuration.execution_threads`	`Int` Opsional. Tentukan jumlah thread yang digunakan untuk mengirim kueri ke instance SAP HANA. Setiap kueri berjalan di threadnya sendiri. Nilai defaultnya adalah 10.
`hana_monitoring_configuration.hana_instances.name`	`String` Tentukan ID nama untuk instance SAP HANA Anda.
`hana_monitoring_configuration.hana_instances.sid`	`String` Tentukan SID instance SAP HANA Anda. String ini ditambahkan sebagai label ke semua metrik yang dihasilkan dari mengkueri instance SAP HANA Anda.
`hana_monitoring_configuration.hana_instances.host`	`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.
`hana_monitoring_configuration.hana_instances.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.
`hana_monitoring_configuration.hana_instances.user`	`String` Tentukan akun pengguna yang digunakan untuk membuat kueri instance SAP HANA.
`hana_monitoring_configuration.hana_instances.password`	`String` Opsional. Tentukan sandi, sebagai teks biasa, yang mengautentikasi akun pengguna untuk mengkueri instance SAP HANA. Untuk mengaktifkan autentikasi, Anda harus menentukan salah satu hal berikut: Sandi teks biasa untuk parameter `password`. (Direkomendasikan) Jika menggunakan Secret Manager untuk menyimpan sandi sebagai rahasia, Anda harus menetapkan nama secret yang sesuai dengan parameter `secret_name`. Jika Anda menggunakan kedua parameter tersebut, parameter `password` akan digunakan.
`hana_monitoring_configuration.hana_instances.secret_name`	`String` Opsional. Tentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna.
`hana_monitoring_configuration.hana_instances.enable_ssl`	`Boolean` Opsional. Menentukan apakah SSL diaktifkan atau tidak di instance SAP HANA. Nilai defaultnya adalah `false`.
`hana_monitoring_configuration.hana_instances.host_name_in_certificate`	`String` Jika menentukan `enable_ssl: true` untuk instance SAP HANA, Anda harus menentukan nama host yang ditetapkan di sertifikat SSL.
`hana_monitoring_configuration.hana_instances.tls_root_ca_file`	`String` Jika Anda menentukan `enable_ssl: true` untuk instance SAP HANA, Anda harus menentukan jalur untuk sertifikat keamanan Anda.
`hana_monitoring_configuration.queries.enabled`	`Boolean` Opsional. Agar dapat mengaktifkan kueri SQL untuk semua instance SAP HANA, tentukan nilai `true` untuk parameter `enabled` untuk kueri SQL tersebut.
`hana_monitoring_configuration.queries.name`	`String` Jika telah menentukan kueri kustom di file konfigurasi, Anda harus menentukan nama unik untuk setiap kueri kustom. Nama kueri harus unik karena digunakan untuk membuat URL default metrik di Monitoring.
`hana_monitoring_configuration.queries.sql`	`String` Tentukan pernyataan SQL yang dikeluarkan agen ke instance SAP HANA Anda. Pernyataan SQL harus sesuai dengan sintaksis SQL yang ditentukan oleh SAP dalam Referensi SQL dan Tampilan Sistem SAP HANA.
`hana_monitoring_configuration.queries.sample_interval_sec`	`Int` Opsional. Tentukan interval sampel untuk kueri SQL. Ini akan mengganti interval sampel global. Nilainya harus 5 detik atau lebih lama.
`hana_monitoring_configuration.queries.columns.name`	`String` Tentukan nama yang secara unik mengidentifikasi setiap kolom. Nama kolom harus unik karena digunakan untuk membuat URL default metrik di Monitoring.
`hana_monitoring_configuration.queries.columns.metric_type`	`String` Untuk penanganan oleh Monitoring, tentukan salah satu jenis metrik berikut: `METRIC_LABEL`, `METRIC_GAUGE`, atau `METRIC_CUMULATIVE`. Metrik jenis `METRIC_LABEL` ditambahkan sebagai label ke semua metrik `METRIC_GAUGE` dan `METRIC_CUMULATIVE` yang dikirim ke Monitoring.
`hana_monitoring_configuration.queries.columns.value_type`	`String` Untuk penanganan oleh Monitoring, tentukan jenis data yang didukung oleh jenis metrik. Jenis data yang didukung adalah sebagai berikut: `VALUE_BOOL`, `VALUE_INT64`, `VALUE_STRING`, atau `VALUE_DOUBLE`. Untuk mengetahui informasi selengkapnya, lihat Kombinasi yang didukung.
`hana_monitoring_configuration.queries.columns.name_override`	`String` Opsional. Untuk menangani melalui Monitoring, tentukan jalur yang ingin ditampilkan di URL metrik, bukan nama kueri dan kolom. Contoh: URL default metrik: `workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME` URL metrik yang menggunakan jalur kustom: `workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH`

Pemecahan masalah

Untuk mengetahui informasi tentang cara mendiagnosis dan menyelesaikan masalah yang mungkin Anda alami saat menginstal dan mengonfigurasi Agen Google Cloud untuk SAP, lihat Panduan pemecahan masalah Agen Google Cloud untuk SAP.

Mendapatkan dukungan

Jika Anda memerlukan bantuan untuk menyelesaikan masalah dengan Agen Google Cloud untuk SAP, kumpulkan semua informasi diagnostik yang tersedia dan hubungi Cloud Customer Care. Untuk mengetahui informasi tentang cara menghubungi Layanan Pelanggan, lihat Mendapatkan bantuan untuk SAP di Google Cloud.