Configura la recopilación de métricas de estado del agente

En esta guía, se muestra cómo configurar el agente de Google Cloud para SAP a fin de recopilar las métricas de estado del proceso daemon del agente en tu instancia de Compute Engine o en el servidor de la solución Bare Metal.

Para obtener información sobre esta función, consulta Recopilación de métricas de estado del agente.

Antes de comenzar

Configura los permisos de IAM

Para habilitar el agente de Google Cloud para SAP y recopilar las métricas de estado, debes asegurarte de que la cuenta de servicio que usa tu instancia de Compute Engine o el servidor de la solución Bare Metal incluya los permisos de IAM necesarios.

Para agregar estos permisos necesarios a tu cuenta de servicio, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página IAM.

    Ir a IAM

  2. Selecciona tu proyecto de Google Cloud.

  3. Identifica la cuenta de servicio a la que le quieres agregar un rol.

    • Si la cuenta de servicio no se encuentra aún en la lista de principales, no tiene ningún rol asignado. Haz clic en Otorgar acceso 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 principales es porque tiene roles existentes. Haz clic en el botón Editar de la cuenta de servicio que deseas editar.

  4. Selecciona la función necesaria de la lista de funciones disponibles:

    • Monitoring > Escritor de métricas de Monitoring

  5. Haz clic en Guardar para aplicar las funciones a la cuenta de servicio.

Para obtener un nivel de acceso detallado, puedes configurar los siguientes permisos de IAM en tu rol personalizado:

  • Recopilación de métricas:
    • monitoring.timeSeries.create

Para obtener más información sobre cómo crear un rol personalizado, consulta Crea y administra roles personalizados.

Habilita la recopilación de métricas de estado del agente

Si deseas permitir que el agente de Google Cloud para SAP recopile las métricas de estado de su proceso daemon en tu host, sigue estos pasos:

  1. Establece una conexión SSH con tu instancia de Compute Engine o el servidor de la solución Bare Metal.

  2. Habilita la recopilación de las métricas de estado del agente:

    Ejecuta el comando

    1. Para habilitar la recopilación de las métricas de estado del agente, ejecuta el siguiente comando:

      sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -enable

    2. De manera opcional, puedes modificar la frecuencia con la que el agente recopila el uso de CPU y memoria de su proceso daemon y lo envía a Cloud Monitoring. La frecuencia predeterminada es de 60 segundos.

      Para modificar esta frecuencia, ejecuta el siguiente comando:

      sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_metrics_frequency=FREQUENCY

      Reemplaza FREQUENCY por el valor requerido, en segundos. La frecuencia no debe ser inferior a 5 segundos.

    3. De manera opcional, puedes modificar la frecuencia con la que el agente verifica su estado operativo y envía esa información a Cloud Monitoring. La frecuencia predeterminada es de 60 segundos.

      Para modificar esta frecuencia, ejecuta el siguiente comando. La frecuencia no debe ser inferior a 5 segundos.

      sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY

    Edita el archivo de configuración

    Como alternativa a la ejecución del comando del agente, puedes modificar de forma manual la configuración del agente de la siguiente manera:

    1. Abre el archivo de configuración de Backint:

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

    2. En la sección collection_configuration, incluye lo siguiente:

      "collect_agent_metrics": true

    3. De manera opcional, puedes modificar la frecuencia con la que el agente recopila el uso de CPU y memoria de su proceso daemon y lo envía a Cloud Monitoring. La frecuencia predeterminada es de 60 segundos.

      Para modificar esta frecuencia, incluye lo siguiente en la sección collection_configuration.

      "agent_metrics_frequency": FREQUENCY

      Reemplaza FREQUENCY por el valor requerido, en segundos. La frecuencia no debe ser inferior a 5 segundos.

    4. De manera opcional, puedes modificar la frecuencia con la que el agente verifica su estado operativo y envía esa información a Cloud Monitoring. La frecuencia predeterminada es de 60 segundos.

      Para modificar esta frecuencia, incluye lo siguiente en la sección collection_configuration. La frecuencia no debe ser inferior a 5 segundos.

      "agent_health_frequency": FREQUENCY

    5. Guarda el archivo de configuración.

    6. Reinicia el agente para que se aplique la configuración nueva:

      sudo systemctl restart google-cloud-sap-agent

Archivos de configuración de ejemplo

Instancia de Compute Engine

El siguiente ejemplo es un archivo de configuración completo del agente de Google Cloud para SAP, que se ejecuta enuna instancia de Compute Engine, donde se habilita la recopilación de las métricas de estado del agente:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Servidor de solución Bare Metal

El siguiente ejemplo es un archivo de configuración completo del agente de Google Cloud para SAP, que se ejecuta enun servidor de la solución Bare Metal, donde se habilita la recopilación de las métricas de estado del agente:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
    "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Parámetros de configuración

En la siguiente tabla, se explican los parámetros de configuración del agente de Google Cloud para SAP que son específicas de la recopilación de métricas de estado del agente:

Parámetros
collection_configuration.collect_agent_metrics

Boolean

Opcional. Especifica true para permitir que el agente recopile la siguiente información y la envíe a Cloud Monitoring:

  • Uso de memoria y CPU mediante el proceso daemon del agente en tu host.
  • El estado operativo del proceso daemon del agente en tu host.

El valor predeterminado es false.
collection_configuration.agent_metrics_frequency

Int

Opcional. Especifica la frecuencia con la que el agente recopila el uso de CPU y memoria de su proceso daemon en el host y lo envía a Cloud Monitoring. Las métricas sap/agent/cpu/utilization y sap/agent/memory/utilization captan esta información. El valor predeterminado es 60 segundos. La frecuencia no debe ser inferior a 5 segundos.

collection_configuration.agent_health_frequency

Int

Opcional. Especifica la frecuencia con la que el agente verifica su estado operativo y envía esa información a Cloud Monitoring. La métrica sap/agent/health captura esta información. El valor predeterminado es 60 segundos. La frecuencia no debe ser inferior a 5 segundos.