このドキュメントでは、Workload Manager で SAP ワークロードのオブザーバビリティ サービスを使用する際に発生する可能性のある問題の解決方法について説明します。
オブザーバビリティ ダッシュボードに SAP システム ID が表示されない
オブザーバビリティ用に Google Cloudの SAP 用エージェントを構成し、SAP システムのさまざまな要素（セントラル サービス、アプリケーション サーバー、SAP HANA データベースなど）をホストするすべての VM のサービス アカウントに必要な権限を付与すると、システム ID が SAP オブザーバビリティ ダッシュボードに表示されます。システム ID が表示されない場合は、次のセクションで説明するように、エージェントの構成とログを確認します。
エージェントの構成を確認する
Google Cloudの SAP 用エージェントに必要なすべての機能が正しく構成されていることを確認する必要があります。
SAP システムの [Unspecified]（グレー）の健全性ステータスには、複数の根本原因が考えられます。この健全性ステータスは、指標や設定がないために Workload Manager で正しく評価できないシステムを特定するために使用されます。この健全性ステータスの最も一般的な原因は次のとおりです。
Google Cloudの SAP 用エージェントが停止しているか、必要な指標を誤って報告している可能性があります。詳細については、エージェントのインストールを検証するをご覧ください。
SAP 用エージェントが実行中で、システム ステータスが [Unspecified] の場合は、VM で実行されている SAP プロセスに応じて、エージェントで プロセス モニタリング機能と SAP HANA モニタリング機能が有効になっており、正しく構成されていることを確認します。セントラル サービスとアプリケーション サーバーでは Process Monitoring を有効にする必要があります。SAP HANA データベースでは、Process Monitoring と SAP HANA Monitoring を有効にする必要があります。
変化の激しい Process Monitoring 指標と変化の緩やかな Process Monitoring 指標の収集頻度のデフォルト値は、それぞれ 5 秒と 30 秒です。これらの値をデフォルト値より大きくすると、ヘルスステータスが [Unspecified]（未指定）と表示されることがあります。
[システムの概要] ページで、システムのアーキテクチャとスケールタイプが正しく識別されているかどうかを確認します。これらのパラメータのいずれかまたは両方が正しくない場合は、Google Cloudの SAP 用エージェントまたは Google Cloudにアップロードされた SAP データに根本的な問題があります。詳細な分析については、Cloud カスタマーケアにお問い合わせください。 Google Cloudの SAP 用エージェントのサポートを受けるをご覧ください。
指標 workload/sap/nw/instance/role または workload/sap/hana/ha/availability が正しく機能していないか、欠落しているため、システムに関連する各 VM のロールが正しく識別されていません。アプリケーションとデータベースのダッシュボードの VM のリストで、特定された SAP ロールを確認します。
各アーキテクチャ タイプには、次のロールが必要です。
集中型アーキテクチャ: セントラル サービス、アプリケーション サーバー、SAP HANA プライマリ。
分散アーキテクチャ: セントラル サービス、アプリケーション サーバー、SAP HANA プライマリ。
HA で分散: Central Services、ERC、アプリケーション サーバー、SAP HANA プライマリ、SAP HANA セカンダリ。
リスト内のすべての VM にロールが割り当てられている必要があります。
Cloud Monitoring 内の指標を確認するか、timeSeries API メソッドを使用して SAP 用エージェントから最新の値を取得することで、必要な指標に有効な値があることを確認します。指標が Cloud Monitoring に存在しない場合や、値がない場合、その指標を評価するのに十分なデータがないため、ヘルスステータスは [未指定] とマークされます。
HA アーキテクチャで分散されている場合は、クラスタに失敗したアクションがあるかどうかを確認し、次のコマンドを実行してクリーンアップを行います。
Google Cloudの SAP 用エージェントのバージョンが最新であり、利用可能な最新バージョンを実行していることを確認します。エージェントの新しいバージョンには、オブザーバビリティ指標に関連する問題とバグの修正が含まれています。指標が正しくないと、システムのヘルスステータスが [Unspecified] になることがあります。
セカンダリ サイトにレプリケートする SAP HANA データベースの場合は、プライマリとセカンダリの間に有効なクラスタ構成があるかどうかを確認します。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["わかりにくい","hardToUnderstand","thumb-down"],["情報またはサンプルコードが不正確","incorrectInformationOrSampleCode","thumb-down"],["必要な情報 / サンプルがない","missingTheInformationSamplesINeed","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 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."]]
