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

En esta guía, se muestra cómo configurar el agente de Google Cloudpara 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

Roles obligatorios

Para garantizar que la cuenta de servicio tenga los permisos necesarios para permitir que el agente de Google Cloudpara SAP recopile métricas de estado del agente, pídele a tu administrador que le otorgue a la cuenta de servicio los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para permitir que el agente de Google Cloudpara SAP recopile métricas de estado del agente. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para permitir que el agente de Google Cloudpara SAP recopile métricas de estado del agente:

  • Para recopilar las métricas de estado del agente de la instancia de Compute Engine host y escribirlas en Cloud Monitoring, sigue estos pasos: monitoring.timeSeries.create

Es posible que tu administrador también pueda otorgar estos permisos a la cuenta de servicio con roles personalizados o con otros roles predefinidos.

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

Si deseas permitir que el agente de Google Cloudpara 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 del host 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 deGoogle Cloudpara SAP que se ejecuta en una instanciade Compute Engine, en el que 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
  },
  "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 deGoogle Cloudpara SAP que se ejecuta en una instanciade un servidor de la solución Bare Metal, en el que 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 deGoogle Cloudpara SAP que son específicos 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.