Información de diagnóstico del agente de Google Cloud para SAP

Para problemas relacionados con la versión 3.8 (la más reciente) del agente deGoogle Cloudpara SAP, proporciona la siguiente información de diagnóstico al servicio de Atención al cliente de Cloud lo antes posible:

• Una descripción completa y detallada del problema.
• El paquete de asistencia para el agente.
• Los datos más recientes que recopiló el agente.
• El archivo de configuración del agente.
• El archivo de registro para el agente.

Descripción detallada del problema

Proporciona una descripción completa y detallada del problema, incluida la versión del agente, y la fecha y hora en que se produjo el problema.

Para ver la versión de tu agente, completa los siguientes pasos:

Paquete de asistencia

El paquete de asistencia es una colección de información del agente de Google Cloudpara SAP, que ayuda al servicio de atención al cliente para que puedas solucionar problemas. Esta función está disponible para la versión 2.1 o posterior del agente de Google Cloudpara SAP.

A partir de la versión 3.4 del agente, puedes subir el resultado del comando supportbundle con la opción result-bucket. Para ello, debes asegurarte de que la cuenta de servicio que usa el agente tenga el siguiente permiso de IAM: storage.objects.create.

Qué contiene el paquete de asistencia

• Los archivos de registro y configuración del agente

  A partir de la versión 3.0 del agente, esto incluye los registros y los archivos de configuración relacionados con las funciones de Backint y de instantánea de disco del agente.

• Archivos de seguimiento y topología de SAP HANA para el nombre de host y el SID asignados

• Agente de Backint de Cloud Storage para el archivo de configuración y los registros de SAP HANA.

• Para un clúster de alta disponibilidad (HA) en RHEL, cuando especificas pacemaker-diagnosis="true", el resultado de sosreport se guarda en el siguiente directorio: /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP. Si la ejecución del comando sosreport falla, el resultado de crm_report se guarda en el directorio especificado.

• Para un clúster de HA en SUSE, cuando especificas pacemaker-diagnosis=true, el resultado de las utilidades hb_report y supportconfig se guarda en el siguiente directorio: /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP. Si la ejecución de estas utilidades falla, el resultado de hb_report y crm_report se guarda en el directorio especificado.

• El archivo /var/log/messages, que ayuda a proporcionar información útil sobre las operaciones del sistema Linux.

• A partir de la versión 3.8 del agente, el archivo sapdiscovery.json se incluye de forma predeterminada. El archivo contiene información sobre los productos de SAP y los componentes relacionados que se ejecutan en la instancia de procesamiento. Esta información le brinda al equipo de Customer Care un mejor contexto sobre el rol y la configuración de tu sistema SAP.

  Para permitir que el agente recopile esta información, debes cumplir con los siguientes requisitos:

  • Especifica "log_to_cloud": true en el archivo de configuración del agente.
  • Otorga el permiso de IAM logging.logEntries.list a la cuenta de servicio que usa el agente.

• A partir de la versión 3.8 del agente, cuando especificas la opción metrics, el paquete incluye información sobre las ocurrencias de eventos de SAP predefinidos y los cambios en los valores de la métrica de supervisión de procesos y la métrica de supervisión de SAP HANA para un período específico.

  • Para permitir que el agente recopile información sobre las ocurrencias de eventos de SAP predefinidos de los registros de Cloud Logging, debes cumplir con los siguientes requisitos:
    • Especifica "log_to_cloud": true en el archivo de configuración del agente.
    • Otorga el permiso de IAM logging.logEntries.list a la cuenta de servicio que usa el agente.
  • Para permitir que el agente recopile información sobre los cambios en los valores de las métricas de Cloud Monitoring, debes cumplir con los siguientes requisitos:
    • Especifica "send_metrics_to_monitoring": true en el archivo de configuración del agente.
    • Otorga los siguientes permisos de IAM a la cuenta de servicio que usa el agente: monitoring.metricDescriptors.get, monitoring.metricDescriptors.list, monitoring.monitoredResourceDescriptors.get, monitoring.monitoredResourceDescriptors.list y monitoring.timeSeries.list.
  • El período con el que el agente filtra los registros de Cloud Logging y las entradas de Cloud Monitoring se determina según el comportamiento de las siguientes opciones:
    • timestamp: Es la marca de tiempo, en formato YYYY-MM-DD HH:MM:SS, alrededor de la cual deseas recopilar información sobre las ocurrencias de los tipos de eventos de SAP predefinidos y los cambios en los valores de las métricas. El valor predeterminado es la hora en la que ejecutas el comando supportbundle.
    • before-duration: Es la cantidad de segundos antes de timestamp durante los cuales el agente busca la ocurrencia de eventos de SAP predefinidos y los cambios en los valores de las métricas. El valor predeterminado es 3,600 segundos.
    • after-duration: Es la cantidad de segundos después de timestamp durante los cuales el agente busca las ocurrencias de eventos predefinidos de SAP y los cambios en los valores de las métricas. El valor predeterminado es 1,800 segundos.

  • La información recopilada se organiza en carpetas que contienen archivos JSON para cada tipo de evento de SAP que se produjo y cada métrica que cambió su valor. El siguiente es un ejemplo de cómo se ve el resultado:

    supportbundle/
    |--- process_metrics/
      |--- pm_sap_control_cpu_utilization.json
      |--- pm_sap_control_memory_utilization.json
    |--- hana_monitoring_metrics/
      |--- hm_sap_hanamonitoring_disk_readtime.json
      |--- hm_sap_hanamonitoring_disk_writetime.json
    |--- sap_events/
      |--- se_HA_Availability.json
      |--- se_HA_Replication.json

Genera un paquete de asistencia

Si quieres generar el paquete de asistencia para una instancia de agente que se ejecuta en Linux, ejecuta el siguiente comando en tu instancia de procesamiento:

sudo /usr/bin/google_cloud_sap_agent supportbundle --sid="SID" --instance-numbers="INSTANCE_NUMBERS" --hostname="HOST_NAME" [--pacemaker-diagnosis="BOOLEAN_VALUE"] [--result-bucket="BUCKET_NAME"] [--metrics] [--timestamp="TIMESTAMP"] [-before-duration=BEFORE_DURATION] [-after-duration=AFTER_DURATION]

Reemplaza lo siguiente:

• SID: El ID del sistema SAP.
• INSTANCE_NUMBERS: los números de instancia de SAP para los que quieres generar el paquete de asistencia.

  Para especificar varios números de instancias, sepáralos con un espacio. Por ejemplo, 00 11 22. Cuando especificas dos o más números de instancias de SAP, el comando genera un paquete de asistencia combinado para las instancias especificadas.

• HOST_NAME: Es el nombre del host en el que ejecutas el comando.
• BOOLEAN_VALUE: El valor true o false, que determina si se realiza o no el diagnóstico relacionado con el marcapasos. El valor predeterminado es false.
• BUCKET_NAME: Es el nombre del bucket de Cloud Storage en el que deseas subir el resultado del comando supportbundle.
• TIMESTAMP: Es la marca de tiempo, en formato YYYY-MM-DD HH:MM:SS, en la que deseas recopilar información sobre las ocurrencias de los tipos de eventos de SAP predefinidos y los cambios en los valores de las métricas. El valor predeterminado es la hora en la que ejecutas el comando supportbundle.
• BEFORE_DURATION: Es la cantidad de segundos antes del valor de la opción timestamp durante los cuales el agente busca las ocurrencias de eventos predefinidos de SAP y los cambios en los valores de las métricas. El valor predeterminado es de 3,600 segundos.
• AFTER_DURATION: Es la cantidad de segundos después del valor de la opción timestamp durante los cuales el agente busca las ocurrencias de eventos predefinidos de SAP y los cambios en los valores de las métricas. El valor predeterminado es 1,800 segundos.

Los datos más recientes que recopiló el agente

Proporciona los datos más recientes que recopiló el agente. Guarda los datos más recientes que recopiló el agente en un archivo y adjúntalos a tu caso de asistencia.

Para ver los datos más recientes que recopiló el agente, completa los siguientes pasos:

Archivo de configuración

Después de quitar las credenciales, como el nombre de usuario y las contraseñas de la base de datos de SAP HANA, proporciona el archivo de configuración para el agente de Google Cloudpara SAP.

Para encontrar el archivo de configuración del agente, navega a la siguiente ruta:

/etc/google-cloud-sap-agent/configuration.json

C:\Program Files\Google\google-cloud-sap-agent\conf\configuration.json

Archivo de registro

Proporciona el archivo de registro del agente de Google Cloudpara SAP.

Para encontrar el archivo de registro del agente, navega a la siguiente ruta:

/var/log/google-cloud-sap-agent.log

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log