Guía del usuario del agente de supervisión de SAP HANA

Google Cloud Platform (GCP) proporciona un agente de supervisión personalizado que recopila métricas personalizadas de SAP HANA y las envía a Google Stackdriver Monitoring, la solución de supervisión integrada de GCP. Con Stackdriver Monitoring, puedes crear paneles para visualizar tus métricas de SAP HANA y configurar alertas según los límites de las métricas. Para obtener más información, consulta la documentación de Stackdriver Monitoring.

Requisitos previos

En esta guía, se da por hecho que implementaste SAP HANA en GCP mediante el método descrito en la guía de implementación de SAP HANA.

Configura Stackdriver Monitoring para tu proyecto

A fin de usar el agente de supervisión de Google para SAP HANA, debes configurar un nuevo lugar de trabajo que esté conectado a tu proyecto de GCP. Sigue estos pasos para crear un nuevo lugar de trabajo:

  1. En tu navegador, ve a Stackdriver Monitoring:

    Ir a Stackdriver Monitoring

  2. Haz clic en Agregar lugar de trabajo.

  3. En la página Crea tu lugar de trabajo gratuito, haz clic en el campo proyecto de Google Cloud Platform. Aparecerá un menú desplegable que contiene tus proyectos de GCP.

  4. Selecciona tu proyecto en el menú desplegable y haz clic en Crear cuenta.

  5. En la página Agregar proyectos de Google Cloud Platform para supervisar, haz clic en Continuar.

  6. En la página Supervisar cuentas de AWS, haz clic en Omitir la configuración de AWS.

  7. En la página Instalar los agentes de Stackdriver, haz clic en Continuar.

  8. En la página Obtener informes por correo electrónico, selecciona Sin informes y, luego, haz clic en Continuar.

  9. Después de que aparezca el mensaje “Colección inicial terminada”, haz clic en Iniciar la supervisión para ingresar al panel de tu lugar de trabajo.

  10. Haz clic en Continuar con la prueba para finalizar la configuración.

Ahora tienes un lugar de trabajo que supervisa tu proyecto de GCP, y el agente de supervisión puede enviar métricas a Stackdriver.

Configura las funciones de IAM necesarias

De manera predeterminada, el agente de supervisión usa la cuenta de servicio predeterminada de la instancia de tu máquina virtual (VM) de Compute Engine. Esta cuenta de servicio permite que los objetos binarios que se ejecutan en la instancia de VM escriban métricas en Stackdriver.

Si eliges usar una cuenta de servicio diferente, debes agregar de forma manual la función de IAM que proporciona esos permisos a tu cuenta de servicio.

Para agregar la función de IAM necesaria a tu cuenta de servicio, sigue estos pasos:

  1. Ve a la página IAM y administración en Cloud Console.

    Ir a la página de IAM y administración

  2. Selecciona tu proyecto y haz clic en Continuar.

  3. Identifica la cuenta de servicio a la que le quieres agregar una función.

    • Si la cuenta de servicio aún no se encuentra en la lista de miembros, no tiene ninguna función asignada. Haz clic en Agregar miembro y, luego, ingresa la dirección de correo electrónico de la cuenta de servicio.
    • Si la cuenta de servicio ya se encuentra en la lista de miembros, es porque tiene funciones existentes. Haz clic en la lista desplegable de la función actual para la cuenta de servicio que deseas editar.
  4. Selecciona Supervisión > Supervisión del escritor de métricas en la lista de funciones disponibles.

  5. Haz clic en Agregar o Guardar a fin de aplicar las funciones a la cuenta de servicio.

Instala el agente

Elige una ubicación de implementación

El agente de supervisión se puede ejecutar directamente en uno o más nodos en tu instalación de SAP HANA o de forma indirecta como un servicio en otra instancia de VM. Elige tu ubicación de implementación según el caso práctico.

Descarga e instala el agente

Para descargar e instalar el agente, sigue estos pasos:

  1. Establece una conexión SSH con tu instancia de VM de SAP HANA.
  2. Descarga y ejecuta la secuencia de comandos de instalación:

    curl https://storage.googleapis.com/gcm-ext/gcm_install.sh | bash -x
    

Cuando ejecutes el comando anterior, la secuencia de comandos de instalación realiza las siguientes operaciones:

  1. Crea los siguientes directorios:

    • /usr/local/lib/gcm, que contendrá el objeto binario del agente
    • /etc/gcm.d, que contendrá las consultas que deseas que ejecute el agente
    • /var/spool/gcm, que contiene las métricas que recopiló el agente durante el último tiempo. En el futuro, el agente enviará esas métricas a Stackdriver Monitoring
  2. Descarga la versión más reciente del agente y la guarda en /usr/local/lib/gcm/.

  3. Crea un symlink al objeto binario en /usr/local/bin/gcm.

  4. Crea una plantilla de configuración básica, /etc/default/gcm.

  5. Crea un archivo de configuración de daemon, /etc/systemd/system/gcm.service.

  6. Vuelve a cargar las definiciones de servicio systemd.

  7. Habilita el agente de supervisión como un daemon.

Configura el agente

Después de ejecutar la secuencia de comandos de instalación, configura las instancias de VM que supervisará el agente y, si lo deseas, las consultas que realizará el agente en tu base de datos.

Define el archivo de configuración

Cuando ejecutaste la secuencia de comandos de instalación, se creó un archivo de plantilla de configuración en la siguiente ubicación:

/etc/default/gcm

Con el archivo de configuración, puedes configurar el agente para que consulte SAP HANA en una o más instancias de VM. Para cada instancia de VM que desees supervisar sigue estos pasos:

  1. Agrega una definición de instancia de VM en el archivo de configuración en instances. Para cada instancia, define el nombre, el host, el puerto, el usuario y la contraseña.
  2. Para permitir que el agente recopile métricas de esa instancia de VM, agrega el nombre de la instancia de VM en enabled_instances.

Define los atributos en la configuración con el siguiente formato:

---
config:
  timestamps_in_output: no
  debug_messages: yes
  skip_default_queries: yes
  queries_directory: /etc/gcm.d
  spool_directory: /var/spool/gcm
  enabled_instances:
    - [INSTANCE_NAME]
    - [INSTANCE_NAME_2]
  project_id: [PROJECT_ID]
  instances:
    - name: [INSTANCE_NAME]
      host: [INSTANCE_IP]
      port: [PORT_NUMBER]
      user: [DB_USERNAME]
      password: [YOUR_PASSWORD]
      type: [INSTANCE_TYPE]
    - name: [INSTANCE_NAME_2]
      host: [INSTANCE_IP_2]
      ...

Los siguientes atributos son necesarios en el archivo de configuración:

  • [PROJECT_ID]: El ID del proyecto de Google Cloud que contiene las instancias de VM que se deben supervisar. Especifica solo un ID del proyecto.
  • [INSTANCE_NAME]: El nombre de la instancia de VM de Compute Engine que deseas supervisar.
  • [INSTANCE_IP]: La IP interna o externa de la instancia de VM de Compute Engine que deseas supervisar. Google recomienda usar IP internas si es posible, ya que requieren menos configuración que las IP externas, además de ser privadas y seguras de forma predeterminada.
  • [DB_USERNAME]: El usuario de la base de datos SAP HANA que deseas usar.
  • [PORT_NUMBER]: El número de puerto de tu base de datos de SAP HANA. Por lo general, el número de puerto es 39015 para SAP HANA Express o 30015 para SAP HANA Platform Edition.
  • [YOUR_PASSWORD]: La contraseña de usuario para el usuario de tu base de datos.
  • [INSTANCE_TYPE]: Ingresa sap_hana para este campo.

También tienes la opción de configurar el agente con las siguientes marcas. Estas marcas de parámetros deben establecerse antes del elemento config:

  • timestamps_in_output (booleano): Si estás ejecutando el agente como un daemon en systemd, configúralo como no, ya que systemd proporciona marcas de tiempo. El valor predeterminado es no.
  • debug_messages (booleano): Si está configurado, muestra mensajes de depuración. El valor predeterminado es yes.
  • skip_default_queries (booleano): Omite el conjunto predeterminado de consultas. No afecta las consultas definidas por el usuario. El valor predeterminado es no.
  • queries_directory (string): El directorio en el que se buscan las consultas definidas por el usuario. El valor predeterminado es /etc/gcm.d.
  • spool_directory (string): El directorio en el que se recopilan las métricas en spool. El valor predeterminado es /var/spool/gcm.

Define consultas personalizadas

De forma predeterminada, el agente recopila un conjunto predeterminado de métricas de tu base de datos de SAP HANA. Para obtener descripciones de estas métricas, así como de las consultas que generan las métricas, visita la página sobre las métricas predeterminadas de SAP HANA.

Puedes agregar consultas adicionales si creas uno o más archivos YAML personalizados en el siguiente directorio:

/etc/gcm.d

El siguiente es un archivo de consulta de ejemplo:

- root: by_component
  type: sap_hana
  description: |
      Amount of memory (in MiB) used by service components
  query: |
    SELECT
             HOST AS "host",
             COMPONENT AS "component",
             SUM(USED_MEMORY_SIZE)/1024/1024 AS "mem_used_mb"
        FROM M_SERVICE_COMPONENT_MEMORY
    GROUP BY HOST, COMPONENT;
  columns:
    - type: LABEL
      value_type: STRING
      name: host
    - type: LABEL
      value_type: STRING
      name: component
    - type: GAUGE
      description: Amount of memory (in MiB) used by the service component
      value_type: DOUBLE
      name: mem_used_mb

Cada archivo YAML comprende uno o más elementos que representan los resultados de una determinada consulta de SQL en las métricas de tu base de datos de SAP HANA. Cada elemento tiene los siguientes atributos:

  • root: Un espacio de nombres descriptivo para un determinado grupo de métricas.
  • query: La consulta de SQL.
  • columns: El tipo de datos, el tipo de valor y el nombre de columna para cada campo en la consulta.

    • type: Describe cómo se informan los datos a Stackdriver. Puedes configurar type como LABEL, lo que indica que el tipo es un encabezado de columna, o como GAUGE,, uno de los tipos de métrica definidos en la enumeración MetricKind de la API de Stackdriver. En este momento, GAUGE es el único tipo de métrica compatible con el agente.
    • value_type: El tipo de valor de la métrica. El valor de este parámetro puede ser cualquiera de los tipos de valor definidos en la enumeración ValueType de la API de Stackdriver.
    • name: El nombre de la columna.

A fin de obtener una lista completa de las vistas del sistema que SAP HANA pone a disposición para realizar consultas, visita la página sobre el SQL de SAP HANA y la referencia de vistas del sistema.

Realiza operaciones básicas

En esta sección, se describe cómo realizar operaciones básicas con el agente de supervisión de SAP HANA. Para obtener una lista completa de opciones configurables, ejecuta gcm --help.

Administra el daemon del agente de supervisión

Cuando ejecutaste la secuencia de comandos de instalación, el instalador creó un archivo de unidad systemd para el agente, lo que te permite administrar el agente con los comandos estándar systemctl. Los siguientes comandos inician, detienen y sondean el estado del agente, respectivamente:

sudo systemctl start gcm
sudo systemctl stop gcm
sudo systemctl status gcm

Para leer los registros que genera systemctl, consulta el contenido del diario systemd mediante el siguiente comando:

sudo journalctl -u gcm

Para ver las últimas líneas que se registraron, puedes agregar la marca -f, que funciona como una canalización hacia tail -f:

sudo journalctl -u gcm -f

Suprime consultas predeterminadas

De forma predeterminada, el agente ejecuta sus consultas predeterminadas además de cualquier consulta personalizada que hayas definido. Para inhabilitar este conjunto de consultas predeterminado, configura la marca skip_default_queries como yes en tu archivo de configuración o configura la marca --no-defaults cuando ejecutes la herramienta de forma manual. Para obtener más información, consulta la sección sobre cómo definir el archivo de configuración.

Recopila y envía métricas de forma manual

A fin de verificar que el agente funcione como se esperaba, puedes ejecutar comandos de forma manual para ejecutar tus consultas, recopilar las métricas resultantes y, luego, enviarlas a Stackdriver Monitoring. Para ejecutar tus consultas y recopilar las métricas resultantes exactamente una vez, ejecuta el siguiente comando:

sudo gcm gather

Para enviar las métricas que recopiló el agente cuando ejecutaste tus consultas, ejecuta el siguiente comando:

sudo gcm send

Visualiza tus métricas en Stackdriver Monitoring

Para mostrar las métricas que recopiló Stackdriver Monitoring en tus propios gráficos y paneles. sigue estos pasos:

  1. En Cloud Console, ve a la página Supervisión.

    Ir a Monitoring

  2. Selecciona Paneles>Crear panel.

  3. Haz clic en Agregar gráfico.

  4. En el menú Tipo de recurso, selecciona Métricas personalizadas.

  5. En el menú Métrica, selecciona by_component/mem_used_mb. Deja los otros campos con sus valores predeterminados. Verás los datos del gráfico en la sección Vista previa del panel.

  6. Haz clic en Guardar.

Ahora, un panel simple muestra métricas en vivo de tu instancia o instancias de VM de SAP HANA.

Solución de problemas

Las consultas predeterminadas fallan

Asegúrate de que el usuario de tu base de datos SAP HANA tenga acceso a las siguientes vistas del sistema SAP HANA:

  • M_CS_ALL_COLUMNS
  • M_CS_TABLES
  • M_EXPENSIVE_STATEMENTS
  • M_HOST_RESOURCE_UTILIZATION
  • M_SERVICE_COMPONENT_MEMORY
  • M_SERVICE_MEMORY

Las métricas no se envían a Stackdriver Monitoring

Asegúrate de que tu cuenta de servicio de GCP tenga permiso para escribir métricas en Stackdriver Monitoring. Para obtener más detalles, consulta la sección sobre cómo configura las funciones de IAM necesarias.

Asistencia

Los clientes de Google Cloud, ya sea con una función de asistencia de producción o con Asistencia para empresas, pueden solicitar asistencia con el aprovisionamiento y la configuración de los recursos de Google Cloud que se requieren para los sistemas SAP. Se requiere la Asistencia a nivel de producción o para empresas de Google Cloud a fin de conseguir la compatibilidad de sistemas SAP en entornos de producción.

Para obtener más información sobre las opciones de asistencia de Google Cloud, consulta los Planes de asistencia de Google Cloud Platform.

Por problemas relacionados con el producto SAP, registra una solicitud de asistencia en Asistencia de SAP. SAP evalúa el ticket de asistencia y, si parece ser un problema de infraestructura de Google Cloud, transfiere el ticket a la cola de Google Cloud.

Próximos pasos