Agen Google Cloud untuk SAP diperlukan untuk dukungan SAP sistem SAP yang berjalan di Google Cloud, termasuk SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB, dan lainnya.
Saat Anda menginstal Agen Google Cloud untuk SAP di instance VM Compute Engine, untuk metrik Agen Host SAP, agen tersebut akan menggabungkan data pemantauan dari Cloud Monitoring dan Compute Engine API serta memberikan data tersebut ke SAP Agen Host.
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 mengetahui informasi tentang sistem operasi yang didukung oleh Agen Google Cloud untuk SAP, lihat Sistem operasi yang didukung.
Untuk menginstal dan mengonfigurasi Agent for SAP versi 3.2 (terbaru) di Google Cloud di server Solusi Bare Metal, baca bagian Menginstal Agen Google Cloud untuk SAP di server Solusi Bare Metal.
Ringkasan penginstalan
Di Linux, Anda dapat 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 versi terbaru Agen Google Cloud untuk SAP.
- Membuat agen sebagai layanan
systemd
Linux, yang bernamagoogle-cloud-sap-agent
. - Mengaktifkan dan memulai layanan,
google-cloud-sap-agent
.
Di Windows, instal Agen Google Cloud untuk SAP menggunakan perintah
pengelolaan paket GooGet, googet
. Perintah pengelolaan paket akan menyelesaikan
tugas-tugas berikut:
- Download versi terbaru Agen Google Cloud untuk SAP.
Membuat layanan Windows bernama
google-cloud-sap-agent
dan tugas terjadwal yang berjalan setiap menit untuk memeriksa apakah layanan masih berjalan dan, jika perlu, memulai ulang layanan.
Prasyarat untuk agen
Sebelum menginstal Agen Google Cloud untuk SAP, Anda harus memastikan bahwa prasyarat berikut terpenuhi.
Menetapkan peran IAM yang diperlukan
Setidaknya, akun layanan yang digunakan oleh Agent for SAP Google Cloud harus menyertakan peran Compute Viewer (roles/compute.viewer
), Monitoring Viewer (roles/monitoring.viewer
), dan Workload Manager Insights Writer (roles/workloadmanager.insightWriter
).
Untuk menambahkan peran yang diperlukan ke akun layanan Anda, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman IAM.
Pilih project Google Cloud Anda.
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.
Pilih peran yang diperlukan dari daftar peran yang tersedia:
- Compute Engine > Viewer Compute
- Monitoring > Monitoring Viewer
- Workload Manager > Workload Manager Insights Writer
Klik Add atau Save untuk menerapkan peran ke akun layanan.
Mengaktifkan akses ke Google Cloud API
Compute Engine merekomendasikan konfigurasi instance VM Anda untuk mengizinkan semua cakupan akses ke semua Cloud API dan hanya menggunakan izin IAM dari akun layanan instance untuk mengontrol akses ke resource Google Cloud. Untuk mengetahui informasi selengkapnya, lihat Membuat VM yang menggunakan akun layanan yang dikelola pengguna.
Jika Anda membatasi akses ke Cloud API, Agen Google Cloud untuk SAP memerlukan cakupan akses Cloud API minimum berikut pada instance VM host:
- Cloud Platform: Diaktifkan
- Compute Engine: Hanya Baca
- Stackdriver Monitoring API: Hanya Baca
Jika Anda menjalankan aplikasi SAP pada instance VM yang tidak memiliki alamat IP eksternal, Anda harus mengaktifkan Akses Google Pribadi pada subnet VM agar Agen Google Cloud untuk SAP dapat mengakses Google API dan layanan Google. Untuk mengaktifkan Akses Google Pribadi di subnet, lihat Mengonfigurasi Akses Google Pribadi.
Menginstal agen
Untuk menginstal Agen Google Cloud untuk SAP pada instance VM Anda, pilih sistem operasi Anda, lalu selesaikan langkah-langkah berikut.
Linux
Untuk menginstal agen pada instance VM, ikuti langkah-langkah berikut:
- Buat koneksi SSH ke instance VM host Anda.
Di terminal, instal agen dengan menjalankan perintah khusus untuk sistem operasi Anda:
- (Disarankan) Untuk menginstal agen versi 3.2 (terbaru):
RHEL
sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM [google-cloud-sap-agent] name=Google Cloud Agent for SAP baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-\$basearch enabled=1 gpgcheck=1 repo_gpgcheck=1 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM sudo yum install google-cloud-sap-agent
SLES 15
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-\$basearch google-cloud-sap-agent sudo zypper install google-cloud-sap-agent
SLES 12
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-\$basearch google-cloud-sap-agent sudo zypper install google-cloud-sap-agent
Untuk menginstal versi agen tertentu:
RHEL
sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM [google-cloud-sap-agent] name=Google Cloud Agent for SAP baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-\$basearch enabled=1 gpgcheck=1 repo_gpgcheck=1 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64
SLES 15
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-\$basearch google-cloud-sap-agent sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64
SLES 12
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-\$basearch google-cloud-sap-agent 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.
- (Disarankan) Untuk menginstal agen versi 3.2 (terbaru):
Windows
Untuk menginstal agen pada instance VM, ikuti langkah-langkah berikut:
- Gunakan RDP untuk terhubung ke instance VM.
- Sebagai administrator, jalankan perintah berikut dari PowerShell:
googet addrepo google-cloud-sap-agent https://packages.cloud.google.com/yuck/repos/google-cloud-sap-agent-windows googet install google-cloud-sap-agent
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
Untuk memverifikasi bahwa agen sedang berjalan, pilih sistem operasi Anda, lalu ikuti langkah-langkah berikut:
Linux
Buat koneksi SSH dengan instance VM host 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
Pada image SLES, untuk memastikan Anda menggunakan Agent for SAP Google Cloud versi terbaru, jalankan perintah berikut.
sudo zypper remove google-cloud-sap-agent sudo zypper addrepo -p 98 --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-\$basearch google-cloud-sap-agent sudo zypper install google-cloud-sap-agent
Windows
Gunakan RDP untuk terhubung ke instance VM.
Sebagai administrator, jalankan perintah berikut dari PowerShell:
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
Jika agen berjalan, statusnya akan menampilkanRunning
.
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
- Penyedia Cloud:
Mengonfigurasi Agen Google Cloud untuk SAP di Linux
Setelah menginstal Agen Google Cloud untuk SAP, Anda dapat mengaktifkan fitur agen lainnya secara opsional dengan melakukan konfigurasi berikut. Secara default, kumpulan metrik Agen Host SAP dan metrik evaluasi Workload Manager diaktifkan.
Fitur berikut hanya didukung di Linux. Fitur tersebut tidak didukung di Windows.
- Mengonfigurasi pengumpulan metrik Pemantauan Proses
- Mengonfigurasi kumpulan metrik evaluasi Workload Manager
- Mengonfigurasi pengumpulan metrik pemantauan SAP HANA.
- Mengonfigurasi pencadangan dan pemulihan berbasis Backint untuk SAP HANA.
- Melakukan pencadangan dan pemulihan untuk SAP HANA menggunakan snapshot disk.
File konfigurasi default
Cuplikan berikut adalah contoh konfigurasi default versi 3.2 (terbaru) Agent for SAP Google Cloud:
{ "provide_sap_host_agent_metrics": true, "bare_metal": false, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": true, "collect_process_metrics": false }, "discovery_configuration": { "enable_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Untuk melihat contoh file konfigurasi khusus fitur, lihat panduan konfigurasi untuk fitur tersebut.
Parameter konfigurasi
Tabel berikut menjelaskan parameter konfigurasi Agen untuk SAP Google Cloud yang berjalan di VM Compute Engine, termasuk parameter yang terkait dengan kumpulan metrik. Untuk informasi tentang parameter konfigurasi yang terkait dengan fitur Backint agen, lihat Parameter konfigurasi.
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 tingkat logging agen, tetapkan nilai yang diperlukan. Tingkat 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 pada server Solusi Bare Metal,
tentukan project ID dari project Google Cloud yang Anda
gunakan dengan Solusi Bare Metal. |
cloud_properties.instance_name
|
Tentukan nama instance VM Compute Engine Anda. Agen akan otomatis mendeteksinya saat penginstalan. |
cloud_properties.region |
Jika sistem SAP Anda berjalan di server Solusi Bare Metal,
tentukan region server Solusi Bare Metal. |
cloud_properties.zone |
Ketika agen berjalan di instance VM, secara default, agen menggunakan zona instance VM tempat agen diinstal. |
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 informasi selengkapnya, lihat codebase agen di repositori GitHub |
discovery_configuration.enable_discovery |
Untuk mengirimkan informasi yang dikumpulkan agen tentang produk SAP yang berjalan di host ke Cloud Logging, tentukan Jika Anda menentukan nilai |
collection_configuration.collect_process_metrics |
Untuk mengaktifkan pengumpulan metrik Process Monitoring, tentukan |
collection_configuration.process_metrics_frequency |
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: Nilai default untuk parameter ini adalah
Semua metrik Process Monitoring lainnya (berubah lambat) dikumpulkan pada
frekuensi default 30 detik. Untuk mengubah frekuensi pengumpulan metrik Pemantauan Proses yang lambat, gunakan parameter |
collection_configuration.slow_process_metrics_frequency |
Tentukan frekuensi pengumpulan metrik Pemantauan Proses yang lambat, dalam hitungan detik. Nilai default untuk parameter ini adalah |
collection_configuration.process_metrics_to_skip |
Tentukan
metrik Process Monitoring
yang Anda tidak ingin dikumpulkan oleh agen. Parameter ini menerima nilai yang dipisahkan koma dari nama metrik Process Monitoring. Contoh:
|
collection_configuration.hana_metrics_config.hana_db_user |
Tentukan akun pengguna database yang digunakan agen untuk membuat kueri
SAP HANA. Default-nya adalah |
collection_configuration.hana_metrics_config.hana_db_password |
Tentukan sandi teks biasa untuk akun pengguna database yang
digunakan agen untuk mengkueri SAP HANA. |
collection_configuration.hana_metrics_config.hana_db_password_secret_name |
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 |
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 defaultnya 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_secret_name |
Tentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna. |
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 hitungan detik, untuk evaluasi Workload Manager.
Defaultnya adalah |
hana_monitoring_configuration.enabled |
Opsional. Agar dapat mengaktifkan Agen Google Cloud untuk SAP untuk mengumpulkan metrik pemantauan
SAP HANA, tentukan hana_monitoring_configuration.enabled: true .
|
hana_monitoring_configuration.sample_interval_sec |
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 |
hana_monitoring_configuration.query_timeout_sec |
Opsional. Tentukan waktu tunggu untuk setiap kueri yang diajukan ke instance SAP HANA. Nilai default-nya adalah 300 detik. |
hana_monitoring_configuration.execution_threads |
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 |
Tentukan ID nama untuk instance SAP HANA Anda. |
hana_monitoring_configuration.hana_instances.sid |
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 |
Tentukan ID untuk mesin, baik lokal maupun jarak jauh, yang menghosting instance SAP HANA Anda. Berikut ini adalah nilai yang didukung:
|
hana_monitoring_configuration.hana_instances.port |
Tentukan port tempat instance SAP HANA Anda menerima kueri. Untuk
instance database tenant pertama atau satu-satunya, port-nya adalah
|
hana_monitoring_configuration.hana_instances.user |
Tentukan akun pengguna yang digunakan untuk membuat kueri instance SAP HANA. |
hana_monitoring_configuration.hana_instances.password |
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:
Jika Anda menggunakan kedua parameter tersebut, parameter |
hana_monitoring_configuration.hana_instances.secret_name |
Opsional. Tentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna. |
hana_monitoring_configuration.hana_instances.enable_ssl |
Opsional. Menentukan apakah SSL diaktifkan atau tidak di instance SAP
HANA. Nilai defaultnya adalah |
hana_monitoring_configuration.hana_instances.host_name_in_certificate |
Jika menentukan |
hana_monitoring_configuration.hana_instances.tls_root_ca_file |
Jika Anda menentukan |
hana_monitoring_configuration.queries.enabled |
Opsional. Agar dapat mengaktifkan kueri SQL untuk semua instance SAP HANA, tentukan nilai |
hana_monitoring_configuration.queries.name |
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 |
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 |
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 |
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 |
Untuk penanganan oleh Monitoring, tentukan salah satu jenis
metrik berikut: Metrik jenis |
hana_monitoring_configuration.queries.columns.value_type |
Untuk penanganan oleh Monitoring, tentukan jenis data yang didukung oleh jenis metrik. Jenis data yang didukung adalah sebagai berikut: |
hana_monitoring_configuration.queries.columns.name_override |
Opsional. Untuk menangani melalui Monitoring, tentukan jalur yang ingin ditampilkan di URL metrik, bukan nama kueri dan kolom. Contoh:
|
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.