Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ce document explique comment résoudre les problèmes que vous pouvez rencontrer lors de l'utilisation du service d'observabilité pour les charges de travail SAP dans Workload Manager.
L'ID système SAP ne figure pas dans le tableau de bord d'observabilité
Après avoir configuré l'agent Google Cloudpour SAP pour l'observabilité et accordé les autorisations requises aux comptes de service pour toutes les VM qui hébergent les différents éléments d'un système SAP (tels que les services centraux, les serveurs d'application et les bases de données SAP HANA), l'ID du système s'affiche dans le tableau de bord d'observabilité SAP. Si l'ID système ne figure pas dans la liste, vérifiez la configuration et les journaux de l'agent, comme expliqué dans les sections suivantes.
Vérifier la configuration de l'agent
Vous devez vous assurer que toutes les fonctionnalités requises sont correctement configurées pour l'agentGoogle Cloudpour SAP.
Pour obtenir l'état des fonctionnalités de votre instance d'agent, exécutez la commande suivante :
Dans les journaux d'instance de VM, consultez les problèmes liés à l'incapacité de l'agent pour SAP à mettre à jour les informations du système SAP.
Pour afficher les journaux, procédez comme suit :
Sélectionnez une VM pour ouvrir la page Détails.
Cliquez sur l'onglet Observability (Observabilité) pour afficher des informations sur la VM.
Sélectionnez Tous les journaux et triez-les par Gravité en sélectionnant "Erreur".
La plupart de ces erreurs sont liées à des autorisations manquantes pour le compte de service associé à la VM. Pour résoudre ces erreurs, accordez les autorisations requises au compte de service.
Vérifier les journaux à l'aide de Cloud Logging
Vous devez vous assurer que l'agent pour SAP découvre correctement vos charges de travail SAP.
Pour afficher les entrées de journal de l'instance de VM qui héberge l'agent, procédez comme suit :
Dans la console Google Cloud , sélectionnez Logging, puis Explorateur de journaux :
Dans le volet Requête, sélectionnez Afficher la requête et saisissez la requête suivante :
jsonPayload.@type:"SapDiscovery"
Si vous ne voyez aucune information provenant des VM qui hébergent l'agent, il est possible que l'agent ne soit pas configuré ou qu'il ne fonctionne pas correctement. Pour en savoir plus, consultez Configurer l'agent pour SAP.
Facultatif : Pour afficher les journaux liés au processus lorsque l'agent pour SAP importe les données de découverte SAP, utilisez la requête suivante :
L'état de fonctionnement est indiqué comme non spécifié
Il peut y avoir plusieurs causes premières à l'état de santé Non spécifié (couleur grise) du système SAP. Cet état de fonctionnement permet d'identifier les systèmes qui ne peuvent pas être évalués correctement par Workload Manager en raison de métriques ou de paramètres manquants.
Voici les causes les plus courantes de cet état :
L'agent Google Cloudpour SAP est peut-être arrêté ou ne signale pas correctement les métriques requises. Pour en savoir plus, consultez Valider l'installation de l'agent.
Si l'agent pour SAP est opérationnel et que l'état du système est Non spécifié, vérifiez que les fonctionnalités Surveillance des processus et Surveillance SAP HANA sont activées et correctement configurées dans l'agent, en fonction des processus SAP exécutés sur la VM.
Les services centraux et les serveurs d'application nécessitent l'activation de la surveillance des processus, tandis que les bases de données SAP HANA nécessitent l'activation de la surveillance des processus et de la surveillance SAP HANA.
Les valeurs par défaut de la fréquence de collecte des métriques de surveillance des processus à évolution rapide et lente sont respectivement de 5 et 30 secondes. Si ces valeurs sont supérieures aux valeurs par défaut, l'état de santé peut être Non spécifié.
Sur la page "Présentation du système", vérifiez que l'architecture et le type de mise à l'échelle sont correctement identifiés pour votre système. Si l'un de ces paramètres ou les deux sont incorrects, cela signifie qu'il existe un problème sous-jacent avec l'agentGoogle Cloudpour SAP ou les données SAP importées dans Google Cloud.
Pour une analyse plus approfondie, contactez l'assistance Cloud Customer Care. Consultez Obtenir de l'aide concernant l'agent Google Cloudpour SAP.
Les rôles de chaque VM liés au système ne sont pas correctement identifiés, car les métriques workload/sap/nw/instance/role ou workload/sap/hana/ha/availability ne fonctionnent pas correctement ou sont manquantes.
Vérifiez les rôles SAP identifiés dans la liste des VM des tableaux de bord "Applications" et "Bases de données".
Les rôles suivants sont requis pour chacun des types d'architecture :
Architecture centralisée : services centraux, serveur d'application et serveur SAP HANA principal.
Architecture distribuée : services centraux, serveur d'application et serveur SAP HANA principal.
Distribution avec haute disponibilité : services centraux, ERC, serveur d'application, SAP HANA principal et SAP HANA secondaire.
Un rôle doit être attribué à toutes les VM de la liste.
Vérifiez que les métriques requises ont une valeur valide en vérifiant la métrique dans Cloud Monitoring ou en utilisant la méthode d'API timeSeries pour que la dernière valeur envoyée par l'agent pour SAP soit transmise. Si la métrique n'est pas présente dans Cloud Monitoring ou n'a aucune valeur, l'état de santé est marqué comme Non spécifié, car il n'y a pas assez de données pour évaluer cette métrique.
Dans les architectures distribuées avec haute disponibilité, vérifiez si une action a échoué dans le cluster et effectuez un nettoyage en exécutant les commandes suivantes :
RHEL
pcs resource cleanup RESOURCE_ID
SLES
crm resource cleanup RESOURCE_ID
Remplacez RESOURCE_ID par l'ID de la ressource ayant échoué dans le cluster.
Une action ayant échoué dans le cluster peut avoir un impact sur les métriques workload.googleapis.com/sap/cluster/nodes et workload.googleapis.com/sap/cluster/resources, et générer des valeurs incorrectes.
Vérifiez que la version de l'agent Google Cloudpour SAP est à jour et que vous exécutez la dernière version disponible. Les versions plus récentes de l'agent contiennent des correctifs pour les problèmes et les bugs liés aux métriques d'observabilité.
Des métriques incorrectes peuvent entraîner l'état de santé Non spécifié du système.
Pour les bases de données SAP HANA répliquées sur un site secondaire, vérifiez s'il existe une configuration de cluster valide entre le site principal et le site secondaire.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]
