Instala el agente de operaciones en VM individuales

El agente de operaciones recopila registros y métricas en instancias de Compute Engine, y envía los registros a Cloud Logging y las métricas a Cloud Monitoring.

Antes de comenzar

Para instalar el agente, asegúrate de tener lo siguiente:

• Tienes una instancia de VM compatible en un proyecto de Google Cloud.

• Tienes un sistema operativo compatible.

• Tienes las credenciales en la instancia de VM que autorizan la comunicación con Cloud Logging y Cloud Monitoring. Por lo general, las instancias de VM de Compute Engine tienen las credenciales adecuadas de forma predeterminada. Si ejecutas instancias de Compute Engine muy antiguas o si creaste instancias de Compute Engine sin las credenciales predeterminadas, es posible que no tengas las credenciales adecuadas. Debes completar los procedimientos incluidos en Autoriza el agente de operaciones.

• Asegúrate de habilitar los servicios para la API de Cloud Logging y la API de Cloud Monitoring.

• Asegúrate de que tu VM no tenga el agente de Cloud Logging ni el agente de Cloud Monitoring heredados instalados. Esto puede provocar la transferencia de registros duplicados o un conflicto en la transferencia de métricas. Además, este agente usa archivos de configuración nuevos que no son compatibles con los agentes anteriores.

  Si tienes los agentes anteriores instalados, guarda los archivos de configuración personalizados del agente de Cloud Monitoring y del agente de Cloud Logging y completa los pasos de desinstalación del agente de Cloud Monitoring y del agente de Cloud Logging.

• Para los usuarios con una VM que no tiene acceso a los repositorios de paquetes remotos, consulta la sección VM sin acceso a paquetes remotos para obtener más información.

Instala el agente mediante la línea de comandos

Nota: Primero verifica que se cumplan todas las condiciones en la sección Antes de comenzar.

Para instalar el agente mediante la línea de comandos, sigue estas instrucciones.

Instala la última versión del agente

Para instalar la última versión del agente, completa los siguientes pasos.

Linux

1. Abre una conexión de terminal en tu instancia de VM mediante SSH o una herramienta similar y asegúrate de tener acceso sudo.

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

3. Ejecuta:

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

Windows

1. Conéctate a tu instancia mediante RDP o una herramienta similar y accede a Windows.

2. Haz clic con el botón derecho en el ícono de PowerShell y selecciona Ejecutar como administrador para abrir una terminal de PowerShell con privilegios de administrador.

3. Ejecuta los siguientes comandos de PowerShell:

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
   Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall"
   

Instala una versión específica del agente

Para instalar una versión específica del agente, completa los siguientes pasos.

Linux

1. Abre una conexión de terminal en tu instancia de VM mediante SSH o una herramienta similar y asegúrate de tener acceso sudo.

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

3. Descarga la secuencia de comandos de instalación del agente:

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

   Cuando ejecutas la secuencia de comandos add-google-cloud-ops-agent-repo.sh, también puedes establecer las siguientes marcas:

   • --verbose: Activa el registro detallado durante la ejecución de la secuencia de comandos.
   • --also-install: Instala el agente después de agregar el repositorio de paquetes del agente.
   • --version: Configura la versión del agente para que se instale la secuencia de comandos.
   • --uninstall: Desinstala el agente.
   • --remove-repo: Quita el repositorio de paquetes del agente correspondiente después de instalar o desinstalar el agente.
   • --dry-run: Activa solo una ejecución de prueba de la ejecución de la secuencia de comandos y, luego, imprime los comandos que deben ejecutarse.
   • --uninstall-standalone-logging-agent: Desinstala el agente de Logging heredado (StackdriverLogging).
   • --uninstall-standalone-monitoring-agent: Desinstala el agente de Monitoring heredado (StackdriverMonitoring).

   Consulta los comentarios de la secuencia de comandos para obtener más información y ejemplo de usos.

4. Agrega el repositorio de paquetes del agente y, luego, instálalo:

   1. Para ver una lista de las versiones de agente disponibles a fin de seleccionar la que deseas instalar, consulta la lista de todas las versiones del agente.

   2. Para los entornos de producción, es posible que desees fijar una versión principal a fin de evitar la instalación de versiones principales que pueden incluir cambios incompatibles con versiones anteriores. Para fijar una versión principal, ejecuta el siguiente comando:

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

      Por ejemplo, si deseas fijar la versión 1.x.x del agente, ejecuta este comando:

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=1.*.*
      

   3. Para instalar una versión específica del agente, ejecuta este comando:

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
      

Puedes borrar la secuencia de comandos de instalación una vez que se ejecute de forma correcta.

• Para verificar que el agente funcione de la forma prevista, ejecuta el siguiente comando:

  sudo systemctl status google-cloud-ops-agent"*"
  

  El estado del agente debe ser OK.

Si tienes problemas con la instalación, consulta la página Solución de problemas.

Windows

1. Conéctate a tu instancia mediante RDP o una herramienta similar y accede a Windows.

2. Haz clic con el botón derecho en el ícono de PowerShell y selecciona Ejecutar como administrador para abrir una terminal de PowerShell con privilegios de administrador.

3. Descarga la secuencia de comandos de instalación del agente:

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
   

   Cuando ejecutas la secuencia de comandos add-google-cloud-ops-agent-repo.ps1, también puedes establecer las siguientes marcas:

   • -Verbose: Activa el registro detallado durante la ejecución de la secuencia de comandos.
   • -AlsoInstall: Instala el agente después de agregar el repositorio de paquetes del agente.
   • -Version: Configura la versión del agente para que se instale la secuencia de comandos.
   • -Uninstall: Desinstala el agente.
   • -RemoveRepo: Quita el repositorio de paquetes del agente correspondiente después de instalar o desinstalar el agente.
   • -WhatIf: Activa solo una ejecución de prueba de la ejecución de la secuencia de comandos y, luego, imprime los comandos que deben ejecutarse.
   • -UninstallStandaloneLoggingAgent: Desinstala el agente de Logging heredado (StackdriverLogging).
   • -UninstallStandaloneMonitoringAgent: Desinstala el agente de Monitoring heredado (StackdriverMonitoring).

   Consulta los comentarios de la secuencia de comandos para obtener más información y ejemplo de usos.

4. Agrega el repositorio de paquetes del agente y, luego, instálalo:

   1. Para ver una lista de las versiones de agente disponibles a fin de seleccionar la que deseas instalar, consulta la lista de todas las versiones del agente.

   2. Para los entornos de producción, es posible que desees fijar una versión principal a fin de evitar la instalación de versiones principales que pueden incluir cambios incompatibles con versiones anteriores. Para fijar una versión principal, ejecuta el siguiente comando:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version MAJOR_VERSION.*.*"
      

      Por ejemplo, si deseas fijar la versión 1.x.x del agente, ejecuta este comando:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.*.*"
      

   3. Para instalar una versión específica del agente, ejecuta este comando:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version version-number"
      

      Por ejemplo:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.0.1"
      

Puedes borrar la secuencia de comandos de instalación una vez que se ejecute de forma correcta.

• Para verificar que el agente funcione de la forma prevista, ejecuta el siguiente comando:

  Get-Service google-cloud-ops-agent
  

  El estado del agente debe ser Running.

Si tienes problemas con la instalación, consulta la página Solución de problemas.

Instala el agente mediante la consola de Google Cloud

Nota: Primero verifica que se cumplan todas las condiciones en la sección Antes de comenzar.

Puedes instalar el agente en una VM individual de Linux mediante la consola de Google Cloud desde las páginas Cloud Monitoring o Compute Engine.

Cloud Monitoring

1. En la consola de Google Cloud, selecciona tu proyecto de Google Cloud.

   Ir a la consola de Google Cloud

2. En el panel de navegación, selecciona Monitoring.

3. En el panel de navegación de Monitoring, selecciona Alertas.

4. En la tabla de paneles, busca la entrada Instancias de VM y, luego, haz clic en el nombre.

La vista Lista en la pestaña Inventario del panel enumera todas las VMs y, además, incluye una columna de estado para el agente, como se muestra en la siguiente captura de pantalla:

En la columna Agente, se informan los siguientes valores:

• No detectado: No hay instalado ningún agente. Si Cloud Monitoring no detecta ningún agente instalado en la instancia de Compute Engine, puedes instalar un agente mediante las siguientes acciones:

  • Selecciona las instancias de VM en las que deseas instalar los agentes.

  • Haz clic en la opción Instalar agentes de la tabla Instancias, que activa un flujo de trabajo de instalación en el panel y sigue las instrucciones.

    También puedes instalar o actualizar los agentes desde la página Detalles de la VM para una VM específica.

    El agente de operaciones recopila métricas y registros de forma predeterminada. Puedes cambiar este comportamiento predeterminado mediante la configuración del agente de operaciones.

• Agente de operaciones: Ejecutas el agente de operaciones. Si no ves una marca de verificación verde junto a la entrada, hay una actualización del agente disponible, basada en el sistema operativo detectado de tu VM.

  Cuando colocas el cursor sobre el indicador del agente de operaciones en la tabla, verás información sobre la versión del agente de operaciones. Si ejecutas una versión anterior, también verás una recomendación para actualizar el agente.

• Pendiente: El agente de operaciones se está instalando o actualizando.

• Agente heredado: Ejecutas el agente heredado de Monitoring o Logging. Consulta Migración de los agentes heredados al agente de operaciones para obtener información sobre la transición al agente de operaciones.

• No aplicable: Esta VM no es una plataforma compatible para ejecutar el agente.

• Desconocido: La VM no está en ejecución, por lo que se desconoce el estado del agente.

Compute Engine

1. Ve a la página Instancias de VM en la consola de Google Cloud.

   Instancias de VM

2. Haz clic en el nombre de la VM en la que deseas instalar el agente. Se abrirá la página Detalles.

3. Haz clic en la pestaña Observabilidad. Se abrirá la página Observabilidad.

4. Haz clic en Instalar agente de operaciones.

5. Haz clic en Ejecutar en Cloud Shell. Cloud Shell se abre y pega el comando de instalación.

6. Presiona Intro en el teclado para ejecutar el comando.

7. Haz clic en Autorizar para permitir que Cloud Shell instale el agente. La instalación se realiza correctamente si ves una línea en Cloud Shell que es similar a la siguiente:

   Instance: projects/example-project/zones/us-west1-a/instances/example-vm successfully runs ops-agent
   

Tareas opcionales

En esta sección, se describe cómo realizar tareas de mantenimiento comunes.

Configura un proxy HTTP

Si usas un proxy HTTP para enviar solicitudes mediante proxy a las API de Logging y Monitoring, haz lo siguiente:

Linux

1. Edita el siguiente archivo de configuración (crea el archivo si todavía no existe):

    /etc/systemd/system.conf
   

2. Agrega lo siguiente al archivo.

    DefaultEnvironment="HTTP_PROXY=http://proxy-ip:proxy-port" "HTTPS_PROXY=http://proxy-ip:proxy-port" "NO_PROXY=http://metadata.google.internal"  # Skip proxy for the local Metadata Server.
   

3. Vuelve a cargar las variables de entorno:

    sudo systemctl daemon-reload
   

4. Ejecuta el siguiente comando en tu instancia de VM para reiniciar el agente:

    sudo systemctl restart google-cloud-ops-agent.target
   

Windows

1. Si usas un proxy HTTP, ejecuta el siguiente comando desde un símbolo del sistema del administrador. De este modo, se configuran las variables de entorno HTTP_PROXY y HTTPS_PROXY para que el agente pueda enviar datos mediante HTTPS de salida:

   setx HTTP_PROXY http://proxy-ip:proxy-port /m
   setx HTTPS_PROXY http://proxy-ip:proxy-port /m
   setx no_proxy metadata.google.internal /m
   

Determina la versión del agente

Para determinar la versión del agente de operaciones en tu sistema, ejecuta los siguientes comandos en la instancia de VM:

Consola de Google Cloud

Para ver la versión de tu agente de operaciones en una VM, sigue estos pasos:

• Ubica la entrada de la VM en la tabla Instancias en la página Instancias de VM de Monitoring. Para obtener información sobre la navegación, consulta Instala el agente mediante la consola de Google Cloud.

• Coloca el cursor sobre el indicador Agente de operaciones en la entrada de la tabla.

CENTOS / RHEL

Ejecuta el siguiente comando en Red Hat o CentOS Linux:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent

DEBIAN / UBUNTU

Ejecuta el siguiente comando en Debian o Ubuntu:

dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' google-cloud-ops-agent

SLES / SUSE

Ejecuta el siguiente comando en SUSE:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent

WINDOWS

Ejecuta el siguiente comando en Windows:

googet installed google-cloud-ops-agent

Reinicia el agente

Debes reiniciar el agente de operaciones para que este incorpore los cambios de los archivos de configuración. Para reiniciar el agente, sigue estas instrucciones.

LINUX

Ejecuta el siguiente comando en tu instancia:

 sudo service google-cloud-ops-agent restart

Windows

1. Conéctate a tu instancia mediante RDP o una herramienta similar y accede a Windows.

2. Haz clic con el botón derecho en el ícono de PowerShell y selecciona Ejecutar como administrador para abrir una terminal de PowerShell con privilegios de administrador.

3. Ejecuta el siguiente comando de PowerShell:

Restart-Service google-cloud-ops-agent -Force

Actualiza el agente

Para actualizar el agente de operaciones a la versión más reciente, sigue estas instrucciones:

Nota: Si actualizaste el sistema operativo Linux de tu instancia a una versión principal nueva, primero debes quitar el agente y, luego, volver a instalarlo mediante los procedimientos de esta página, en lugar de completar estos procedimientos de actualización.

Consola de Google Cloud

Puedes actualizar el agente de operaciones mediante las instrucciones de instalación de Cloud Monitoring. Para obtener más información, consulta Instala el agente mediante la consola de Google Cloud.

Linux

Para actualizar el agente a la última versión, ejecuta el siguiente comando:

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

Para actualizar el agente a la versión más reciente de una versión principal específica, ejecuta el siguiente comando:

sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

Para actualizar a la última versión del agente, sigue estos pasos:

1. Conéctate a tu instancia mediante RDP o una herramienta similar y accede a Windows.

2. Haz clic con el botón derecho en el ícono de PowerShell y selecciona Ejecutar como administrador para abrir una terminal de PowerShell con privilegios de administrador.

   Nota: Si actualizas tu agente desde una versión anterior a la 2.0.3 a la versión 2.0.3 o posterior, la actualización quita el archivo de configuración anterior. Si personalizaste la configuración del agente, asegúrate de guardar una copia de seguridad del archivo de configuración antes de realizar la actualización y, luego, aplicar los cambios necesarios al archivo de configuración después de la actualización.

   Copy-Item -Path "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml" -Destination "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.bak"
   

3. Ejecuta los siguientes comandos de PowerShell para quitar el agente instalado y ejecutar el comando de instalación:

   googet -noconfirm remove google-cloud-ops-agent
   googet -noconfirm install google-cloud-ops-agent
   

Muestra todas las versiones del agente

Para ver las versiones disponibles del agente, ejecuta el siguiente comando:

CENTOS / RHEL

Crea una lista de las versiones disponibles del agente:

sudo yum list --showduplicates google-cloud-ops-agent

DEBIAN / UBUNTU

Crea una lista de las versiones disponibles del agente:

sudo apt-cache madison google-cloud-ops-agent

SLES / SUSE

Crea una lista de las versiones disponibles del agente:

sudo zypper search -s google-cloud-ops-agent

WINDOWS

Crea una lista de las versiones disponibles del agente:

googet available google-cloud-ops-agent

Desinstala el agente

Para quitar el agente de operaciones y sus archivos de configuración, sigue estas instrucciones.

Después de desinstalar el agente, la consola de Google Cloud puede tardar hasta una hora en informar este cambio.

Linux

Ejecuta el siguiente comando:

sudo bash add-google-cloud-ops-agent-repo.sh --uninstall

Windows

Para desinstalar el agente de operaciones, sigue estos pasos:

1. Conéctate a tu instancia mediante RDP o una herramienta similar y accede a Windows.

2. Haz clic con el botón derecho en el ícono de PowerShell y selecciona Ejecutar como administrador para abrir una terminal de PowerShell con privilegios de administrador.

3. Ejecuta el siguiente comando de PowerShell:

   googet -noconfirm remove google-cloud-ops-agent
   

VM sin acceso a paquetes remotos

La instalación del agente de operaciones requiere acceso a los repositorios de paquetes remotos, tanto para el paquete del agente (en Linux) como para sus dependencias.

Si usas VPC-SC o una red privada, la configuración de red también puede afectar la capacidad de instalar dependencias de agentes desde repositorios ascendentes. Los paquetes de agentes son accesibles mediante el Acceso privado a Google. Esto se puede configurar en Habilita el Acceso privado a Google.

Si la política de seguridad de tu host de VM niega el acceso a los repositorios de paquetes remotos, te recomendamos crear una imagen de VM personalizada con el agente preinstalado y, luego, inhabilitar la administración de paquetes de esa imagen.

¿Qué sigue?

• Obtén información sobre los registros que el agente envía a Cloud Logging mediante su configuración predeterminada.