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

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

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.)

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 koleksi metrik Process Monitoring atau pengumpulan metrik evaluasi Workload Manager, 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 atau eksternal.

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: 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.

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 Informasi diagnostik Agen Google Cloud untuk SAP.