Configura el agente de operaciones para la solución Bare Metal

El agente de operaciones recopila registros y métricas en el servidor de la solución Bare Metal. Envía tus registros a Cloud Logging y tus métricas a Cloud Monitoring. Para obtener más información sobre el Agente de operaciones, consulta Descripción general del Agente de operaciones.

Si ya tienes una solución de supervisión a nivel del SO, asegúrate de poder compartir datos con nosotros en caso de que ocurra un incidente en el que necesites nuestra asistencia. Si no tienes ninguna de esas soluciones ni ninguna otra, te recomendamos que uses Agente de operaciones.

Antes de comenzar

• Asegúrate de que el servidor de la solución Bare Metal ejecute un SO compatible. Los siguientes SO son compatibles con el Agente de operaciones:

  • RHEL 7.x
  • RHEL 8.x
  • SLES 12.x
  • SLES 15.x

• Asegúrate de tener las credenciales de la cuenta de servicio en el servidor de la solución Bare Metal que autoricen la comunicación con Cloud Logging y Cloud Monitoring. Si no tienes las credenciales requeridas, debes autorizar el Agente de operaciones antes de instalarlo.

• Habilita los servicios para la API de Cloud Logging y la API de Cloud Monitoring.

Autorizar el agente de operaciones

Antes de instalar el agente de operaciones, debes asegurarte de que tenga permiso para enviar información a Google Cloud. Este permiso se otorga mediante credenciales de cuenta de servicio que se deben almacenar en el servidor de la solución Bare Metal. Estas credenciales funcionan como credenciales predeterminadas de la aplicación (ADC) para el agente de operaciones.

La autorización hace referencia al proceso de determinar qué permisos tiene un cliente autenticado sobre un conjunto de recursos. Google Cloud autoriza al agente de operaciones en un servidor de la solución Bare Metal a través de las ADC.

El agente de operaciones es compatible con ADC que se autentican con una clave privada de una cuenta de servicio. La clave autoriza el par de claves en una cuenta de servicio en un proyecto, lo que te permite crear un token de acceso. Luego, el token se usa para proporcionar una identidad para que puedas interactuar con las APIs de Google Cloud en nombre de la cuenta de servicio.

Para autorizar al agente, sigue estos pasos:

1. Crea una cuenta de servicio.
2. Autoriza la cuenta de servicio con una clave privada.
3. Autoriza el agente de operaciones.

Si ya tienes las credenciales necesarias, puedes omitir este proceso y instalar el agente de operaciones.

Crea una cuenta de servicio y una clave

En esta sección, se describe cómo crear una cuenta de servicio nueva y otorgarle los roles necesarios, y cómo actualizar una cuenta de servicio existente si no tiene los roles necesarios.

Para crear una cuenta de servicio, completa los procedimientos que se indican en Crea una cuenta de servicio con la siguiente información:

1. Selecciona el mismo proyecto de Google Cloud que contiene el servidor de la solución Bare Metal para crear la cuenta de servicio.
2. En el menú desplegable Función, selecciona los siguientes roles:
   • Monitoring > Escritor de métricas de supervisión.
   • Logging > Escritor de registros.
3. Selecciona JSON como Tipo de clave.

4. Haz clic en Crear.

   Cuando haces clic en Crear, se descarga un archivo que contiene una clave de cuenta de servicio a tu sistema local. Para obtener más información, consulta Crea y borra claves de cuentas de servicio.

Nota: Las claves de cuenta de servicio son un riesgo de seguridad si no se administran de forma adecuada. Eres responsable de la seguridad de la clave privada y de otras operaciones que se describen en Prácticas recomendadas para administrar claves de cuentas de servicio. Si no se te permite crear una clave de cuenta de servicio, es posible que la creación de claves de cuentas de servicio esté inhabilitada para tu organización. Para obtener más información, consulta Administra los recursos de la organización con seguridad de forma predeterminada.

A continuación, autoriza el agente de operaciones con una clave privada de cuenta de servicio.

Cómo autorizar una cuenta de servicio con una clave privada

Para autorizar el agente de operaciones con una clave privada de cuenta de servicio, haz lo siguiente:

1. Copia el archivo de clave privada en la siguiente ubicación del servidor de la solución Bare Metal para que el agente de operaciones pueda reconocer las credenciales.

   Advertencia: Si ya tienes un archivo de credenciales, asegúrate de que las credenciales nuevas no reemplacen las credenciales de tus aplicaciones actuales.

   /etc/google/auth/application_default_credentials.json
   

2. Crea una variable de entorno para que apunte al archivo de credenciales en tu estación de trabajo. En el siguiente ejemplo, se crea una variable llamada CREDS:

   CREDS="~/Downloads/PROJECT-NAME-KEY-ID.json"
   

3. Transfiere la clave de la cuenta de servicio a tu servidor de la solución Bare Metal.

   Nota: En las siguientes instrucciones, se da por sentado que tienes un entorno de Linux tanto en tu sistema local como en tu servidor. Si usas un entorno diferente, consulta la documentación de tu proveedor de servicios en la nube para saber cómo copiar el archivo de claves privadas. Asegúrate de que el archivo de clave privada esté en la misma ubicación que la variable CREDS.

   En tu sistema local, usa la herramienta de línea de comandos scp.

   1. Ve a la página Servidores.

      Ir a Servidores

   2. Identifica la siguiente información de tu servidor:

      • ID del proyecto
      • Nombre del servidor
      • Ubicación del servidor

   3. En el servidor de la solución Bare Metal, ejecuta los siguientes comandos:

      GOOGLE_APPLICATION_CREDENTIALS="/etc/google/auth/application_default_credentials.json"
      sudo mkdir -p /etc/google/auth
      sudo mv "$HOME/temp.json" "$GOOGLE_APPLICATION_CREDENTIALS"
      sudo chown root:root "$GOOGLE_APPLICATION_CREDENTIALS"
      sudo chmod 0400 "$GOOGLE_APPLICATION_CREDENTIALS"
      
      

      La variable GOOGLE_APPLICATION_CREDENTIALS debe ser visible para el proceso del Agente de operaciones. Si el archivo de credenciales no se encuentra en la ubicación predeterminada anterior, además de los comandos de los ejemplos anteriores, asegúrate de que GOOGLE_APPLICATION_CREDENTIALS esté definido y visible para el proceso del agente de operaciones.

Autorizar el agente de operaciones

1. Edita el archivo /etc/systemd/system.conf para agregar la siguiente información. Crea el archivo si no existe.

   DefaultEnvironment=GOOGLE_APPLICATION_CREDENTIALS=path_to_credentials_file BMS_PROJECT_ID=PROJECT_ID BMS_LOCATION=REGION BMS_INSTANCE_ID=SERVER_ID
   

2. Vuelve a cargar las variables de entorno.

   sudo systemctl daemon-reload
   

   Tu servidor de la solución Bare Metal ahora tiene las credenciales que necesita el agente de operaciones.

3. En el servidor de la solución Bare Metal, reinicia el agente de operaciones para usar las credenciales nuevas. Para ello, ejecuta el siguiente comando:

   sudo service google-cloud-ops-agent restart
   

Instalar el agente de operaciones.

Para instalar el agente mediante la línea de comandos, haz lo siguiente:

1. Abre una conexión de terminal en tu servidor de la solución Bare Metal con SSH o una herramienta similar y asegúrate de tener acceso sudo.

2. Cambia a un directorio al que tengas acceso de escritura. Por ejemplo, tu directorio principal.

3. Descarga y ejecuta la secuencia de comandos de instalación del Agente de operaciones mediante los siguientes comandos:

   curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
   

   sudo REPO_SUFFIX=bms bash add-google-cloud-ops-agent-repo.sh --also-install
   

Una vez que se complete la instalación, el agente de operaciones se iniciará automáticamente.

¿Qué sigue?

• Obtén información sobre las configuraciones predeterminadas y personalizadas del agente de operaciones. Consulta Configura el agente de operaciones.