Versi 2: Panduan pemecahan masalah Agent for SAP dari Google Cloud

Panduan ini menunjukkan cara menyelesaikan masalah terkait Agen untuk SAP Google Cloud versi 2.

Logging

Periksa log di direktori yang khusus untuk sistem operasi Anda.

Untuk melihat log Agen Google Cloud untuk SAP, buka jalur berikut:

Linux

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

Windows

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log

Masalah umum

Masalah: Izin IAM tidak memadai

Masalah: Log Agen Google Cloud untuk SAP menampilkan error izin IAM yang tidak memadai.

Penyebab: Akun layanan tidak memiliki izin IAM yang diperlukan untuk mengakses Cloud Monitoring API.

Penyelesaian: Di konsol Google Cloud, pada halaman detail instance VM, catat nama akun layanan VM. Contoh: sap-example@example-project-123456.iam.gserviceaccount.com Di halaman beranda IAM & Admin, pastikan akun layanan menyertakan peran IAM berikut:

Fitur	Peran IAM yang diperlukan
Pengumpulan metrik Agen Host SAP	Compute Viewer (`roles/compute.viewer`) Monitoring Viewer (`roles/monitoring.viewer`)
Pengumpulan metrik Process Monitoring	Compute Viewer (`roles/compute.viewer`) Monitoring Metric Writer (`roles/monitoring.metricWriter`) Secret Manager Secret Accessor (`roles/secretmanager.secretAccessor`) (Diperlukan saat Anda menggunakan Secret Manager untuk mengautentikasi akun pengguna database untuk SAP HANA.)
Pengumpulan metrik evaluasi Workload Manager	Compute Viewer (`roles/compute.viewer`) Monitoring Metric Writer (`roles/monitoring.metricWriter`) Secret Manager Secret Accessor (`roles/secretmanager.secretAccessor`) (Diperlukan saat Anda menggunakan Secret Manager untuk mengautentikasi akun pengguna database untuk SAP HANA.)
Pengumpulan metrik pemantauan SAP HANA	Compute Viewer (`roles/compute.viewer`) Monitoring Metric Writer (`roles/monitoring.metricWriter`) Secret Manager Secret Accessor (`roles/secretmanager.secretAccessor`) (Diperlukan saat Anda menggunakan Secret Manager untuk mengautentikasi akun pengguna database untuk SAP HANA.)

Untuk mengetahui informasi selengkapnya tentang autentikasi yang diperlukan oleh Agen Google Cloud untuk SAP, lihat Autentikasi dan akses.

Untuk mengonfirmasi izin yang diperlukan agen Cloud Monitoring, lihat dokumentasi Monitoring berikut:

Masalah: Cakupan akses salah untuk akun layanan VM

Masalah: Jika Anda membatasi cakupan akses pada instance VM host, log agen Google Cloud untuk SAP mungkin menampilkan error izin IAM yang tidak memadai.

Penyebab: Agen Google Cloud untuk SAP memerlukan cakupan akses Cloud API minimum pada instance VM host. Error ini terjadi saat akun layanan tidak memiliki cakupan akses yang diperlukan.

Penyelesaian: Cakupan akses adalah metode lama untuk menentukan izin instance VM Anda. Compute Engine merekomendasikan konfigurasi instance VM Anda untuk mengizinkan semua cakupan akses ke semua Cloud API dan hanya menggunakan izin IAM akun layanan VM untuk mengontrol akses ke resource Google Cloud.

Untuk mengatasi masalah ini, sebagai praktik terbaik, tetapkan semua cakupan akses cloud-platform pada instance VM, lalu batasi akses API akun layanan dengan peran IAM secara aman. Contoh:

https://www.googleapis.com/auth/cloud-platform

Jika Anda membatasi cakupan akses instance VM, Anda harus memastikan bahwa instance VM host memiliki cakupan akses berikut:

https://www.googleapis.com/auth/source.read_write
https://www.googleapis.com/auth/compute
https://www.googleapis.com/auth/servicecontrol
https://www.googleapis.com/auth/service.management.readonly
https://www.googleapis.com/auth/logging.admin
https://www.googleapis.com/auth/monitoring
https://www.googleapis.com/auth/trace.append
https://www.googleapis.com/auth/devstorage.full_control

Jika Anda telah mengaktifkan pengumpulan metrik Pemantauan Proses, metrik evaluasi Pengelola Beban Kerja, atau metrik pemantauan SAP HANA, cakupan akses instance VM host juga harus memiliki akses tulis untuk memublikasikan data metrik ke project Google Cloud Anda:

https://www.googleapis.com/auth/monitoring.write

Untuk mengubah cakupan akses, Anda harus menghentikan instance VM, membuat perubahan, lalu memulai ulang instance VM. Untuk mendapatkan petunjuk, baca dokumentasi Compute Engine. Anda tidak perlu melakukan perubahan apa pun pada izin untuk peran IAM untuk masalah ini.

Masalah: Agen Host SAP tidak ada atau salah

Masalah: Log Agen Google Cloud untuk SAP menampilkan error Agen Host SAP yang tidak ada atau salah.

Penyebab: Agen Host SAP atau level patch minimum yang diperlukan untuk Agen Host SAP tidak diinstal. Agar Agen Google Cloud untuk SAP dapat berfungsi, Agen Host SAP harus diinstal di sistem SAP Anda dan level patch minimum yang diperlukan untuk Agen Host tersebut dipertahankan.

Penyelesaian: Untuk mengatasi masalah ini, instal versi Agen Host SAP yang diperlukan. Untuk mengetahui petunjuk penginstalan Agen Host SAP, lihat dokumentasi SAP.

Untuk persyaratan versi Agen Host SAP, lihat Catatan SAP berikut:

Linux: Catatan SAP 2460297 - SAP di Linux pada Google Cloud Platform: Enhanced Monitoring
Windows: Catatan SAP 1409604 - Virtualisasi di Windows: Enhanced Monitoring

Masalah: Penginstalan Agen Google Cloud untuk SAP gagal

Masalah: Penginstalan agen gagal saat perintah instal pengelola paket (yum, zypper, atau googet) dijalankan.

Penyebab: Penginstalan agen gagal karena server host yang menjalankan agen telah dibuat tanpa alamat IP publik.

Penyelesaian: Untuk mengatasi masalah ini, siapkan gateway NAT yang memberi server host akses keluar ke internet. Untuk informasi tentang cara menyiapkan gateway NAT, lihat panduan deployment untuk sistem SAP Anda. Misalnya, untuk SAP NetWeaver, lihat:

Masalah: Pengumpulan metrik pemantauan SAP HANA gagal

Masalah: Saat mengupgrade dari agen pemantauan untuk SAP HANA, setelah Anda menginstal Agen Google Cloud untuk SAP, Anda akan melihat pesan error yang mirip dengan berikut ini:

tls: failed to verify certificate: x509: certificate relies on legacy Common Name field, use SANs instead

Penyebab: Agen Google Cloud untuk SAP tidak dapat memulai pengumpulan metrik pemantauan SAP HANA karena instance SAP HANA target menggunakan sertifikat SSL yang ditentukan dengan Common Name (CN).

Penyelesaian: Untuk mengatasi masalah ini, selesaikan beberapa langkah berikut:

Untuk instance SAP HANA yang ingin dipantau menggunakan Agen Google Cloud untuk SAP, Anda harus beralih menggunakan sertifikat SSL Subject Alternative Name (SAN), bukan sertifikat SSL yang ditentukan dengan Nama Umum (CN).
Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.
Buka file konfigurasi Agen Google Cloud untuk SAP:
```
/etc/google-cloud-sap-agent/configuration.json
```
Di bagian hana_monitoring_configuration, tetapkan parameter enabled ke true.
Di bagian hana_monitoring_configuration.hana_instances, lakukan tindakan berikut untuk setiap instance SAP HANA yang menggunakan protokol TLS/SSL untuk komunikasi yang aman:
1. Tentukan parameter enable_ssl dan tetapkan nilainya ke true.
2. Tentukan parameter host_name_in_certificate dan tetapkan nama host SAP HANA, seperti yang ditentukan dalam sertifikat TLS/SSL, sebagai nilainya.
3. Tentukan parameter tls_root_ca_file dan tetapkan jalur, tempat sertifikat TLS/SSL disimpan, sebagai nilainya.
Simpan file konfigurasi.
Mulai ulang Agen Google Cloud untuk SAP agar setelan baru diterapkan:
```
sudo systemctl restart google-cloud-sap-agent
```
Pastikan agen sedang mengumpulkan metrik pemantauan SAP HANA. Untuk mengetahui petunjuknya, lihat Melihat metrik lainnya.
Uninstal agen pemantauan untuk SAP HANA.

Masalah: Error koneksi ditolak

Masalah: Log Agen Host SAP menampilkan error koneksi ditolak.

Penyebab: Agen Google Cloud untuk SAP tidak dapat dimulai karena port 18181 tidak tersedia. Agen Google Cloud untuk SAP memproses permintaan pada port 18181. Port ini harus tersedia agar agen dapat dimulai.

Penyelesaian: Untuk mengatasi masalah ini, pastikan port 18181 tersedia untuk Agen Google Cloud untuk SAP. Jika layanan lain menggunakan port 18181, Anda mungkin perlu memulai ulang layanan lain tersebut atau mengonfigurasinya ulang untuk menggunakan port lain.

Masalah: Untuk image OS SLES 15 SP4 untuk SAP dan yang lebih baru, Agen Google Cloud untuk SAP tidak berjalan

Masalah: Saat Anda menggunakan image OS "untuk SAP" SLES, Agen Google Cloud untuk SAP sudah diinstal untuk Anda. Namun, untuk image OS SLES 15 SP4 untuk SAP dan yang lebih baru, Agen bawaan untuk SAP tidak akan memulai secara mandiri.

Untuk memastikan bahwa agen sudah berjalan atau tidak, lakukan langkah-langkah berikut:

Hubungkan ke instance VM host atau server Solusi Bare Metal.

Jalankan perintah berikut:

systemctl status google-cloud-sap-agent

Jika agen tidak berjalan, output berisi inactive (dead). Contoh:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
 Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled)
 Active: inactive (dead)

Penyebab: Agen untuk SAP tidak dimulai sendiri karena ada masalah pada paket OS.

Penyelesaian: Untuk mengatasi masalah tersebut, lakukan langkah-langkah berikut:

Hubungkan ke instance VM host atau server Solusi Bare Metal.

Jalankan perintah berikut:

sudo sed -i 's~ /usr/sap~ -/usr/sap~g' /usr/lib/systemd/system/google-cloud-sap-agent.service
sudo systemctl restart google-cloud-sap-agent

Pastikan agen sedang berjalan:

systemctl status google-cloud-sap-agent

Anda akan melihat output yang mirip dengan berikut ini:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
  Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled)
  Active: active (running) since Wed 2023-07-12 03:07:23 UTC; 7s ago
Main PID: 6117 (google_cloud_sa)
   Tasks: 6
  Memory: 8.8M (max: 1.0G limit: 1.0G available: 1015.1M)
  CGroup: /system.slice/google-cloud-sap-agent.service
           └─ 6117 /usr/bin/google_cloud_sap_agent startdaemon

Mendapatkan dukungan untuk Agen Google Cloud untuk SAP

Jika Anda memerlukan bantuan untuk menyelesaikan masalah pada Agen Google Cloud untuk SAP, kumpulkan informasi diagnostik yang diperlukan dan hubungi Cloud Customer Care. Untuk mengetahui informasi selengkapnya, lihat Versi 2: Agen Google Cloud untuk informasi diagnostik SAP.