Halaman ini diterjemahkan oleh Cloud Translation API.

Versi 1: 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 Agen Google Cloud untuk SAP versi 1 di instance Compute Engine, lihat Menginstal Agen Google Cloud untuk SAP di instance 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:

Mendownload 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 Agen Google Cloud untuk SAP versi terbaru, yang mendukung lebih banyak fitur. Untuk mendapatkan petunjuk, lihat Menginstal dan mengonfigurasi Agen Google Cloud untuk SAP di server Solusi Bare Metal.

Untuk menginstal Agen Google Cloud untuk SAP versi 1, hubungi Layanan Pelanggan Cloud.

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

Buat koneksi SSH dengan server Solusi Bare Metal Anda.

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 mengaktifkan pengumpulan metrik Process Monitoring dan metrik evaluasi Workload Manager. Secara default, hanya pengumpulan metrik Agen Host SAP yang diaktifkan.

Metrik evaluasi Workload Manager dan pengumpulan metrik Process Monitoring hanya didukung di Linux.

Jika mengaktifkan kumpulan metrik evaluasi Workload Manager dan Process Monitoring, Anda harus menyelesaikan prasyarat berikut:

Buat akun layanan IAM untuk agen guna mengakses resource Google Cloud. Memberikan peran IAM yang diperlukan ke akun layanan. Lihat Menyiapkan akun layanan untuk mengetahui detailnya.
Instal gcloud CLI di server Solusi Bare Metal 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 artikel 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.

Upload file kunci JSON ke lokasi yang aman di server Solusi Bare Metal yang dapat diakses oleh agen.

Mengaktifkan pengumpulan metrik Process Monitoring dan metrik evaluasi Workload Manager

Untuk mengaktifkan pengumpulan metrik Process Monitoring dan metrik evaluasi Workload Manager, ikuti langkah-langkah berikut:

Bangun koneksi SSH dengan server Solusi Bare Metal Anda.

Buka file konfigurasi berikut:

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

Di bagian collection_configuration, tetapkan parameter berikut ke true:
- collect_process_metrics: memungkinkan agen mengumpulkan metrik Process Monitoring. Untuk pengumpulan metrik database SAP HANA, untuk mengakses dan mengkueri database SAP HANA, Anda perlu menyiapkan parameter tambahan di bagian hana_metrics_config.
- collect_workload_validation_metrics: memungkinkan agen mengumpulkan metrik evaluasi Workload Manager.
Untuk mengetahui informasi selengkapnya tentang parameter, lihat tabel berikut.
Simpan file konfigurasi.
Mulai ulang agen agar setelan baru diterapkan.
```
sudo systemctl restart google-cloud-sap-agent
```

Parameter konfigurasi

Tabel berikut menjelaskan parameter konfigurasi Agen Google Cloud untuk SAP versi 1.

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_id`	`String` Tentukan nama server Solusi Bare Metal tempat Anda menginstal agen.
`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_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 Process untuk SAP HANA, Anda harus menyiapkan parameter tambahan yang tercantum di bagian `hana_metrics_config`.
`collection_configuration.process_metrics_frequency`	`Int` Tentukan frekuensi pengumpulan metrik Process Monitoring, dalam hitungan detik. Nilai default untuk parameter ini adalah `5` detik. Meskipun Anda dapat memperbarui frekuensi pengumpulan metrik Process Monitoring, sebaiknya gunakan nilai default. Jika Anda perlu mengubah nilai default, tambahkan parameter `process_metrics_frequency` di bagian `collection_configuration` dan berikan nilai yang diperlukan.
`collection_configuration.hana_metrics_config.hana_db_user`	`String` Tentukan akun pengguna database yang digunakan agen untuk mengkueri 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 menentukan sandi teks biasa, sebaiknya gunakan salah satu opsi berikut: `hana_db_password_secret_name`, yang Anda tentukan secret-nya yang disimpan di Secret Manager.
`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. Penting: Secret dan instance Compute Engine host harus ada di project Google Cloud yang sama. Agen mengumpulkan metrik terkait SAP HANA hanya jika Anda menentukan `hana_db_password_secret_name` atau `hana_db_password`.
`collection_configuration.hana_metrics_config.sid`	`String` Tentukan SID instance SAP HANA Anda.
`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. 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` 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.

Konfigurasi default

{
  "provide_sap_host_agent_metrics": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false
  }
}

Contoh konfigurasi

Untuk menginstal agen di server Solusi Bare Metal, Anda perlu menambahkan parameter yang diperlukan ke file konfigurasi. Contoh berikut menunjukkan file konfigurasi lengkap untuk menginstal agen di server Solusi Bare Metal.

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": true,
    "hana_metrics_config": {
      "hana_db_user": "user",
      "hana_db_password_secret_name": "secret-name"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_id": "bms-machine-1",
    "image": "rhel-8",
    "region": "us-central1"
  }
}

Melihat metrik yang dikumpulkan

Untuk memvisualisasikan metrik Process Monitoring yang dikumpulkan agen, Anda dapat menggunakan dasbor kustom berikut yang disediakan Google Cloud:

Ringkasan Agent untuk SAP - HANA: Dasbor ini menyediakan diagram yang menampilkan ringkasan status untuk metrik berikut: Ketersediaan SAP HANA, Ketersediaan SAP HANA HA, Replikasi SAP HANA HA, Status Layanan SAP HANA, Cluster HA - Status Node, dan Cluster HA - Status Resource untuk Instance SAP.

File JSON untuk dasbor ini adalah sap-agent-status-overview.json.
Agent untuk SAP - HANA Raw Metrics: Dasbor ini menyediakan diagram yang menampilkan nilai metrik mentah untuk metrik berikut: Ketersediaan SAP HANA, Ketersediaan SAP HANA HA, Replikasi SAP HANA HA, Status Layanan SAP HANA, Cluster HA - Status Node, dan Cluster HA - Status Resource untuk Instance SAP.

File JSON untuk dasbor ini adalah sap-agent-raw-metrics.json.

Menginstal dasbor

Untuk menginstal dasbor kustom, selesaikan langkah-langkah berikut:

Konsol Google Cloud

Di konsol Google Cloud, buka halaman Monitoring:

Buka Monitoring
Di panel navigasi Monitoring, klik Dasbor.
Klik tab Sample library.
Untuk memfilter dasbor kustom khusus agen, di kolom Filter, ketik Agent for SAP.
(Opsional) Untuk melihat detail tentang dasbor atau mempratinjau kontennya, klik Pratinjau.
Pilih dasbor yang ingin Anda instal.
Klik Impor, lalu klik Konfirmasi.

Dasbor akan ditambahkan ke dasbor yang tersedia di project Google Cloud Anda. Untuk melihat dasbor Anda, ikuti petunjuk dalam artikel Melihat dasbor yang terinstal.

Google Cloud CLI

Buka Cloud Shell:

Buka Cloud Shell

Di Cloud Shell, clone atau download repositori:

git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/

Di Cloud Shell, instal dasbor yang diperlukan menggunakan file JSON yang sesuai:
```
gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE
```
Ganti CONFIG_FROM_FILE dengan jalur ke file JSON yang berisi konfigurasi dasbor. File konfigurasi dasbor dapat ditemukan di jalur: monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.

Dasbor akan ditambahkan ke dasbor yang tersedia di project Google Cloud Anda. Untuk melihat dasbor Anda, ikuti petunjuk di Melihat dasbor yang terinstal.

Melihat dasbor yang terinstal

Untuk melihat dasbor yang terinstal, ikuti langkah-langkah berikut:

Di konsol Google Cloud, buka halaman Monitoring:

Buka Monitoring
Di panel navigasi Monitoring, klik Dasbor.
Klik nama dasbor dalam daftar.

Jika memiliki banyak dasbor, Anda dapat memfilter dasbor kustom atau untuk nama dasbor baru. Untuk informasi tentang cara memfilter daftar ini, lihat Melihat dasbor kustom.

Gambar berikut adalah contoh yang menunjukkan bagian dasbor kustom untuk metrik SAP HANA dalam Monitoring.

Screenshot menampilkan dasbor kustom untuk metrik SAP HANA
di Monitoring

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.