Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Dokumen ini menjelaskan cara menyelesaikan masalah yang mungkin Anda alami saat
menggunakan layanan observabilitas untuk workload SAP di Workload Manager.
ID sistem SAP tidak tercantum di dasbor kemampuan pengamatan
Setelah mengonfigurasi Google CloudAgen untuk SAP untuk kemampuan pengamatan dan
memberikan izin yang diperlukan ke akun layanan untuk semua VM yang menghosting
berbagai elemen sistem SAP (seperti Layanan Pusat, Server Aplikasi, dan database SAP HANA), ID sistem akan muncul di dasbor kemampuan pengamatan SAP. Jika ID sistem tidak tercantum, periksa konfigurasi dan log agen seperti yang dijelaskan di bagian berikut.
Memverifikasi konfigurasi agen
Anda harus memastikan bahwa semua fitur yang diperlukan dikonfigurasi dengan benar untuk AgenGoogle Clouduntuk SAP.
Untuk mendapatkan status fitur instance agen Anda, jalankan perintah berikut:
sudo/usr/bin/google_cloud_sap_agentstatus
Output perintah ini merangkum fitur yang diaktifkan dan dinonaktifkan. Bagian ini juga menunjukkan izin IAM yang tidak ada atau masalah konfigurasi.
Untuk mengetahui informasi selengkapnya, lihat Memvalidasi penyiapan untuk kemampuan pengamatan Workload Manager.
Periksa log instance VM
Di log instance VM, lihat masalah terkait Agen untuk SAP yang tidak dapat memperbarui informasi sistem SAP.
Untuk melihat log, lakukan hal berikut:
Pilih VM untuk membuka halaman Detail.
Klik tab Observability untuk menampilkan informasi tentang VM.
Pilih Semua log dan urutkan menurut Error sebagai Tingkat Keseriusan.
Sebagian besar error ini terkait dengan izin yang tidak ada untuk akun layanan yang terpasang ke VM. Untuk mengatasi error ini, berikan izin yang diperlukan
ke akun layanan.
Memeriksa log menggunakan Cloud Logging
Anda harus memastikan bahwa Agen untuk SAP menemukan workload SAP Anda dengan benar.
Untuk melihat entri log untuk instance VM yang menghosting agen, lakukan hal berikut:
Di konsol Google Cloud , pilih Logging, lalu pilih Logs Explorer:
Di panel Query, pilih Show query dan masukkan kueri berikut:
jsonPayload.@type:"SapDiscovery"
Jika Anda tidak dapat melihat informasi apa pun dari VM yang menghosting agen, berarti agen mungkin tidak dikonfigurasi atau berfungsi dengan benar. Untuk mengetahui informasi selengkapnya,
lihat Mengonfigurasi Agen untuk SAP.
Opsional: Untuk melihat log yang terkait dengan proses saat Agen untuk SAP mengupload data penemuan SAP, gunakan kueri berikut:
Mungkin ada beberapa penyebab utama untuk status kesehatan Tidak Ditentukan (warna abu-abu) sistem SAP. Status kondisi ini digunakan untuk mengidentifikasi sistem yang tidak dapat dievaluasi dengan benar oleh Workload Manager karena metrik atau setelan tidak ada.
Penyebab paling umum untuk status kesehatan ini adalah sebagai berikut:
Agen Google Clouduntuk SAP mungkin dihentikan atau salah melaporkan metrik yang diperlukan. Untuk mengetahui informasi selengkapnya, lihat Memvalidasi penginstalan agen.
Jika Agen untuk SAP sudah aktif dan berjalan serta status sistemnya adalah Tidak Ditentukan, periksa apakah fitur Pemantauan Proses dan Pemantauan SAP HANA diaktifkan dan dikonfigurasi dengan benar di agen, bergantung pada proses SAP yang berjalan di VM.
Central Services dan Application Servers memerlukan Process Monitoring diaktifkan, sedangkan database SAP HANA memerlukan Process Monitoring dan SAP HANA Monitoring diaktifkan.
Nilai default untuk frekuensi pengumpulan
metrik Process Monitoring yang berubah cepat dan lambat masing-masing adalah 5 detik dan
30 detik. Jika nilai ini dinaikkan di atas nilai default, Anda mungkin melihat status respons sebagai Tidak Ditentukan.
Di halaman Ringkasan sistem, periksa apakah Arsitektur dan Jenis Skala
diidentifikasi dengan benar untuk sistem Anda. Jika salah satu atau kedua parameter ini salah, berarti ada masalah mendasar dengan AgenGoogle Clouduntuk SAP atau data SAP yang diupload ke Google Cloud.
Untuk analisis lebih lanjut, hubungi Cloud Customer Care. Lihat Mendapatkan dukungan untuk Agen Google Cloud untuk SAP. Google Cloud
Peran untuk setiap VM yang terkait dengan sistem tidak diidentifikasi dengan benar karena metrik workload/sap/nw/instance/role
atau workload/sap/hana/ha/availability tidak berfungsi dengan benar atau tidak ada.
Periksa peran SAP yang teridentifikasi dalam daftar VM di dasbor Aplikasi dan Database.
Peran berikut diperlukan untuk setiap jenis arsitektur:
Arsitektur Terpusat: Layanan Pusat, Server Aplikasi, dan SAP HANA Primer.
Arsitektur Terdistribusi: Central Services, Application Server, dan SAP HANA Primary.
Didistribusikan dengan HA: Central Services, ERC, Application Server, SAP HANA Primary, dan SAP HANA Secondary.
Semua VM dalam daftar harus memiliki peran yang ditetapkan.
Pastikan metrik yang diperlukan memiliki nilai yang valid dengan memeriksa metrik di dalam Cloud Monitoring atau menggunakan metode API timeSeries agar nilai terbaru didorong oleh Agen untuk SAP. Jika metrik tidak ada di Cloud Monitoring atau tidak memiliki nilai,
status kesehatan akan ditandai sebagai Tidak Ditentukan karena tidak ada cukup data untuk mengevaluasi metrik tersebut.
Pada arsitektur Distributed dengan HA, periksa apakah ada tindakan yang gagal di cluster dan lakukan pembersihan dengan menjalankan perintah berikut:
RHEL
pcs resource cleanup RESOURCE_ID
SLES
crm resource cleanup RESOURCE_ID
Ganti RESOURCE_ID dengan ID resource yang gagal di cluster.
Tindakan yang gagal di cluster dapat memengaruhi metrik workload.googleapis.com/sap/cluster/nodes
dan workload.googleapis.com/sap/cluster/resources serta melaporkan nilai yang salah.
Periksa apakah versi Agen Google Clouduntuk SAP sudah yang terbaru dan Anda menjalankan versi terbaru yang tersedia. Versi agen yang lebih baru berisi perbaikan untuk masalah dan bug terkait metrik observabilitas.
Metrik yang salah dapat menyebabkan status respons sistem menjadi Tidak ditentukan.
Untuk database SAP HANA yang mereplikasi ke situs sekunder, periksa apakah ada konfigurasi cluster yang valid antara primer dan sekunder.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[],[],null,["# Troubleshoot observability issues for SAP\n\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis document describes how to resolve issues that you might encounter while\nusing the observability service for SAP workloads in Workload Manager.\n\nSAP system ID is not listed on the observability dashboard\n----------------------------------------------------------\n\nAfter [configuring the Google Cloud's Agent for SAP](/workload-manager/docs/observe/sap/configure-agent) for observability and\ngranting the required permissions to service accounts for all VMs that host\nthe different elements of an SAP system (such as Central Services,\nApplication Servers, and SAP HANA databases), the system ID appears\non the SAP observability dashboard. If the system ID is not listed, check the\nagent configuration and logs as explained in the following sections.\n\n### Verify the agent configuration\n\nYou must ensure that all required features are correctly configured for the\nGoogle Cloud's Agent for SAP.\n\nTo get the status of the features of your agent instance, run the following command: \n\n sudo /usr/bin/google_cloud_sap_agent status\n\nThis command output summarizes the enabled and disabled features. It also\nindicates any missing IAM permissions or configuration issues.\nFor more information, see [Validate the setup for Workload Manager observability](/workload-manager/docs/observe/sap/configure-agent#validate-setup).\n\n### Check the VM instance logs\n\nIn the VM instance logs, view issues related to the Agent for SAP not being able to update the SAP system information.\nTo view logs, do the following:\n\n1. Select a VM to open the **Details** page.\n2. Click the **Observability** tab to display information about the VM.\n3. Select **All logs** and sort by Error as the **Severity**.\n\n Most of these errors are related to missing permissions for the service account\n attached to the VM. To resolve these errors, [grant the required permissions](/workload-manager/docs/observe/sap/prerequisites#service-account)\n to the service account.\n\n### Check logs using Cloud Logging\n\nYou must ensure that the Agent for SAP discovers your SAP workloads correctly.\nTo view log entries for the VM instance that hosts the agent, do the following:\n\n1. In the Google Cloud console, select **Logging** , and then select **Logs Explorer**:\n\n [Go to the Logs Explorer](https://console.cloud.google.com/logs)\n2. In the **Query** pane, select **Show query** and enter the following query:\n\n ```\n jsonPayload.@type:\"SapDiscovery\"\n ```\n\n If you cannot see any information from the VMs that host the agent, then the\n agent might not be configured or working properly. For more information,\n see [Configure Agent for SAP](/workload-manager/docs/observe/sap/configure-agent).\n3. Optional: To view logs related to the process when Agent for SAP\n uploads the SAP discovery data, use the following query:\n\n ```\n -jsonPayload.caller=~\"third_party/sapagent/internal/system/clouddiscovery/cloud_discovery.go\"\n -jsonPayload.caller=~\"third_party/sapagent/internal/system/sapdiscovery\"\n ```\n\nHealth status appears as unspecified\n------------------------------------\n\nThere might be multiple root causes for *Unspecified* (gray color) health status\nof the SAP system. This health status is used to identify systems that cannot\nbe correctly evaluated by Workload Manager due to missing metrics or settings.\nThe most common causes for this health status are as follows:\n\n- The Google Cloud's Agent for SAP might be stopped or incorrectly\n reporting the required metrics. For more information, see [Validate your installation of the agent](/sap/docs/agent-for-sap/latest/install-config-on-vm#validate-agent4sap-installation).\n\n- If Agent for SAP is up and running and the system status is *Unspecified* ,\n check that the [Process Monitoring](/sap/docs/agent-for-sap/latest/process-monitoring) and [SAP HANA Monitoring](/sap/docs/agent-for-sap/latest/monitoring-sap-hana) features are enabled and configured\n correctly in the agent depending on the SAP processes running on the VM.\n Central Services and Application Servers require Process Monitoring to be enabled\n while SAP HANA databases require Process Monitoring and SAP HANA Monitoring enabled.\n\n - The default values for the [collection frequency](/sap/docs/agent-for-sap/latest/process-monitoring#pm_metric_types) of the fast-changing and slow-changing Process Monitoring metrics are 5 seconds and 30 seconds respectively. If these values are increased above the default values, you might see the health status as *Unspecified*.\n- On the System overview page, check whether the **Architecture** and **Scale-Type**\n are correctly identified for your system. If any or both of these parameters\n are incorrect, then there is an underlying issue with either the\n Google Cloud's Agent for SAP or the uploaded SAP data to Google Cloud.\n For further analysis, contact Cloud Customer Care. See [Getting support\n for Google Cloud's Agent for SAP](/sap/docs/agent-for-sap/latest/troubleshooting#getting_support_for_agent).\n\n- The roles for each VM related to the system are not correctly identified due\n to the metrics `workload/sap/nw/instance/role`\n or `workload/sap/hana/ha/availability` not working correctly or missing.\n Check the identified SAP roles in the list of VMs on the Applications and Databases dashboards.\n\n | **Note:** On the observability dashboards, the *role* for a VM represents the SAP service hosted on that VM.\n\n The following roles are required for each of the architecture types:\n - Centralized Architecture: Central Services, Application Server, and SAP HANA Primary.\n - Distributed Architecture: Central Services, Application Server, and SAP HANA Primary.\n - Distributed with HA: Central Services, ERC, Application Server, SAP HANA Primary, and SAP HANA Secondary.\n\n All the VMs in the list should have a role assigned to them.\n- Verify that [the required metrics](/workload-manager/docs/observe/sap/view-dashboards#metrics) have a valid value by either checking\n the metric inside Cloud Monitoring or by using the [timeSeries](/monitoring/api/ref_v3/rest/v3/projects.timeSeries) API method\n to have the latest value pushed by the Agent for SAP. If the metric is not present in Cloud Monitoring or has no value,\n then the health status is marked as *Unspecified* because there is not enough data to evaluate such a metric.\n\n- On Distributed with HA architectures, check if there is a failed action\n in the cluster and perform a cleanup by running the following commands:\n\n ### RHEL\n\n ```sh\n pcs resource cleanup RESOURCE_ID\n ```\n\n ### SLES\n\n\n ```sh\n crm resource cleanup RESOURCE_ID\n ```\n\n \u003cbr /\u003e\n\n Replace \u003cvar translate=\"no\"\u003eRESOURCE_ID\u003c/var\u003e with the ID of the failed resource\n in the cluster.\n\n Failed action in the cluster might impact the metrics `workload.googleapis.com/sap/cluster/nodes`\n and `workload.googleapis.com/sap/cluster/resources` and it reports incorrect values.\n- Check whether the Google Cloud's Agent for SAP version is up to date and that\n you are running the latest version available. Newer versions of the\n agent contains fixes for issues and bugs related to observability metrics.\n Incorrect metrics might result in the *Unspecified* health status of the system.\n\n- For SAP HANA databases replicating to a secondary site, check if there is a valid cluster configuration between primary and secondary."]]
