Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En este documento, se describe cómo resolver problemas que podrías encontrar cuando uses el servicio de observabilidad para cargas de trabajo de SAP en el Administrador de cargas de trabajo.
El ID del sistema SAP no aparece en el panel de observabilidad
Después de configurar el agente de Google Cloudpara SAP para la observabilidad y otorgar los permisos necesarios a las cuentas de servicio para todas las VMs que alojan los diferentes elementos de un sistema SAP (como los servicios centrales, los servidores de aplicaciones y las bases de datos de SAP HANA), el ID del sistema aparece en el panel de observabilidad de SAP. Si el ID del sistema no aparece en la lista, consulta la configuración y los registros del agente, como se explica en las siguientes secciones.
Verifica la configuración del agente
Debes asegurarte de que todas las funciones requeridas estén configuradas correctamente para el agente deGoogle Cloudpara SAP.
Para obtener el estado de las funciones de tu instancia de agente, ejecuta el siguiente comando:
sudo/usr/bin/google_cloud_sap_agentstatus
El resultado de este comando resume las funciones habilitadas y las inhabilitadas. También indica si faltan permisos de IAM o si hay problemas de configuración.
Para obtener más información, consulta Valida la configuración de la observabilidad de Workload Manager.
Verifica los registros de la instancia de VM
En los registros de la instancia de VM, consulta los problemas relacionados con el hecho de que el agente para SAP no puede actualizar la información del sistema SAP.
Para ver los registros, haz lo siguiente:
Selecciona una VM para abrir la página Detalles.
Haz clic en la pestaña Observabilidad para mostrar información sobre la VM.
Selecciona Todos los registros y ordena por Error como la Gravedad.
La mayoría de estos errores están relacionados con la falta de permisos para la cuenta de servicio conectada a la VM. Para resolver estos errores, otorga los permisos necesarios a la cuenta de servicio.
Cómo verificar los registros con Cloud Logging
Debes asegurarte de que el agente para SAP descubra tus cargas de trabajo de SAP correctamente.
Para ver las entradas de registro de la instancia de VM que aloja el agente, haz lo siguiente:
En la consola de Google Cloud , selecciona Logging y, luego, Explorador de registros:
En el panel Consulta, selecciona Mostrar consulta y, luego, ingresa la siguiente consulta:
jsonPayload.@type:"SapDiscovery"
Si no puedes ver información de las VMs que alojan el agente, es posible que el agente no esté configurado o no funcione correctamente. Para obtener más información, consulta Configura el agente para SAP.
Opcional: Para ver los registros relacionados con el proceso cuando el Agente para SAP sube los datos de detección de SAP, usa la siguiente consulta:
Puede haber varias causas principales para el estado de salud Sin especificar (color gris) del sistema SAP. Este estado de salud se usa para identificar los sistemas que Workload Manager no puede evaluar correctamente debido a la falta de métricas o parámetros de configuración.
Las causas más comunes de este estado de salud son las siguientes:
Es posible que el agente de Google Cloudpara SAP esté detenido o que informe las métricas requeridas de forma incorrecta. Para obtener más información, consulta Valida la instalación del agente.
Si el agente para SAP está en funcionamiento y el estado del sistema es Sin especificar, verifica que las funciones Supervisión de procesos y Supervisión de SAP HANA estén habilitadas y configuradas correctamente en el agente según los procesos de SAP que se ejecuten en la VM.
Los servidores de aplicaciones y los servicios centrales requieren que se habilite la supervisión de procesos, mientras que las bases de datos de SAP HANA requieren que se habiliten la supervisión de procesos y la supervisión de SAP HANA.
Los valores predeterminados para la frecuencia de recopilación de las métricas de Monitoring de procesos que cambian rápidamente y las que cambian lentamente son de 5 y 30 segundos, respectivamente. Si estos valores se aumentan por encima de los valores predeterminados, es posible que veas el estado de salud como Sin especificar.
En la página System overview, verifica si Architecture y Scale-Type se identificaron correctamente para tu sistema. Si alguno de estos parámetros o ambos son incorrectos, hay un problema subyacente con el agente deGoogle Cloudpara SAP o con los datos de SAP subidos a Google Cloud.
Para obtener más análisis, comunícate con Atención al cliente de Cloud. Consulta Cómo obtener asistencia para el agente de Google Cloudpara SAP.
Los roles de cada VM relacionados con el sistema no se identifican correctamente debido a que las métricas workload/sap/nw/instance/role o workload/sap/hana/ha/availability no funcionan correctamente o faltan.
Verifica los roles de SAP identificados en la lista de VMs de los paneles de aplicaciones y bases de datos.
Se requieren los siguientes roles para cada uno de los tipos de arquitectura:
Arquitectura centralizada: Servicios centrales, servidor de aplicaciones y SAP HANA principal
Arquitectura distribuida: Servicios centrales, servidor de aplicaciones y SAP HANA principal
Distribuido con alta disponibilidad: Central Services, ERC, servidor de aplicaciones, SAP HANA principal y SAP HANA secundario.
Todas las VMs de la lista deben tener un rol asignado.
Verifica que las métricas requeridas tengan un valor válido. Para ello, revisa la métrica en Cloud Monitoring o usa el método de la API de timeSeries para que el agente de SAP envíe el valor más reciente. Si la métrica no está presente en Cloud Monitoring o no tiene valor, el estado de salud se marca como Sin especificar porque no hay suficientes datos para evaluar esa métrica.
En las arquitecturas distribuidas con alta disponibilidad, verifica si hay alguna acción fallida en el clúster y realiza una limpieza ejecutando los siguientes comandos:
RHEL
pcs resource cleanup RESOURCE_ID
SLES
crm resource cleanup RESOURCE_ID
Reemplaza RESOURCE_ID por el ID del recurso con errores en el clúster.
La acción fallida en el clúster podría afectar las métricas workload.googleapis.com/sap/cluster/nodes y workload.googleapis.com/sap/cluster/resources, y generar valores incorrectos.
Verifica si la versión del agente de Google Cloudpara SAP está actualizada y si ejecutas la versión más reciente disponible. Las versiones más recientes del agente contienen correcciones para problemas y errores relacionados con las métricas de observabilidad.
Las métricas incorrectas pueden generar el estado de Sin especificar del sistema.
En el caso de las bases de datos de SAP HANA que se replican en un sitio secundario, verifica si hay una configuración de clúster válida entre el sitio principal y el secundario.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
