Instalación del Agente de operaciones en VMs 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:

Instala el agente de forma automática durante la creación de la VM

Para obtener más información, consulta Instala el agente de operaciones durante la creación de la VM.

Instala el agente desde la línea de comandos

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

Instala la versión más reciente 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. Descarga y ejecuta la secuencia de comandos de instalación del agente mediante los siguientes comandos:

    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

    Después de instalarlo, el agente se inicia de manera automática.

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. Para obtener información sobre la versión, consulta Enumera todas las versiones del agente.
    • --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 enumerar las versiones de agente disponibles, consulta Enumera 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"*"

    Verifica que los componentes “Agente de Logging” y “Agente de métricas” estén en ejecución.

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. Para obtener información sobre la versión, consulta Enumera todas las versiones del agente.
    • -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 enumerar las versiones de agente disponibles, consulta Enumera 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 a través de Google Cloud Console

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

Cloud Monitoring

En la consola de Google Cloud, ve a la página Instancias de VM:

Ve al Panel de instancias de VM

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

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:

El panel Instancias de VM de Monitoring muestra el estado de los agentes.

En la columna Agente, se informan los siguientes valores:

  • No detectado: O no tienes un agente instalado o no se está ejecutando. Si no estás seguro de si instalaste un agente, puedes verificar la versión instalada. Si instalaste el agente, puedes reiniciarlo. Si instalaste y, luego, iniciaste el agente de operaciones, pero el estado sigue siendo No detectado, es posible que el agente no se haya iniciado de forma correcta o no pueda enviar métricas.

    Para solucionar problemas de inicio, consulta El agente está instalado, pero no se ejecuta. Para solucionar problemas de transferencia de métricas, consulta Soluciona problemas de transferencia de datos. La secuencia de comandos de diagnóstico de agente general y las verificaciones de estado también pueden ser útiles.

  • 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.

    Si la instalación del agente permanece en Pendiente durante más de 10 minutos, puede haber un problema cuando se aplica la política del SO del agente de operaciones o se inicia el agente. Si deseas obtener información sobre la solución de problemas, consulta Herramienta de diagnóstico de agente para políticas de instalación automática.

  • 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.

Para instalar el agente de operaciones, haz lo siguiente:

  • Selecciona las instancias de VM en las que deseas instalar los agentes.
  • Haz clic en la opción Instalar/Actualizar agentes de operaciones en la tabla Instancias.

También puedes instalar o actualizar el agente de operaciones desde la página Detalles de la VM de una VM específica.

Cuando sea posible, el agente se instala mediante una política del SO del agente de operaciones. Para obtener más información, consulta Administra las VM que cubre la política del SO del agente de operaciones. Las políticas del SO del agente de operaciones no son compatibles con todas las versiones de todos los sistemas operativos. En este caso, si haces clic en Instalar/Actualizar el agente de operaciones, se proporciona una serie de comandos para ejecutar en Cloud Shell.

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.

Compute Engine

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

    Ir a Instancias de VM

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Compute Engine.

  2. Haz clic en el nombre de la VM en la que deseas instalar el agente.

  3. Haz clic en la pestaña Observabilidad.

  4. Haz clic en Instalar agente de operaciones.

    Cuando sea posible, el agente se instala mediante una política del SO del agente de operaciones. Para obtener más información, consulta Administra las VM que cubre la política del SO del agente de operaciones. Las políticas del SO del agente de operaciones no son compatibles con todas las versiones de todos los sistemas operativos. En este caso, si haces clic en Instalar/Actualizar el agente de operaciones, se proporciona una serie de comandos para ejecutar en Cloud Shell.

    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.

    Si la instalación del agente permanece en Pendiente durante más de 10 minutos, puede haber un problema cuando se aplica la política del SO del agente de operaciones o se inicia el agente. Si deseas obtener información sobre la solución de problemas, consulta Herramienta de diagnóstico de agente para políticas de instalación automática.

Verifica que el agente de operaciones esté en ejecución

Para verificar que el Agente de operaciones se esté ejecutando, puedes usar cualquiera de las siguientes opciones:

  • Panel Instancias de VM: En este panel, puedes ver el estado de instalación del agente en toda tu flota de VMs. Sin embargo, el estado puede ser inexacto si la VM no tiene los permisos de acceso necesarios o si la cuenta de servicio asociada no tiene roles de IAM insuficientes.

  • gcpdiag: gcpdiag proporciona información más confiable y sólida sobre el estado del agente que el panel deInstancias de VM, y verifica la instalación de agentes y la transmisión de telemetría desde la VM. Usar gcpdiag tiene algunos requisitos previos, proporciona una mejor manera de supervisar el estado del agente.

Usa el panel de Instancias de VM

En la consola de Google Cloud, ve a la página Instancias de VM:

Ve al Panel de instancias de VM

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

Luego, verifica que la columna Agente para esta VM indique el Agente de operaciones.

Usa gcpdiag

Para obtener más información sobre el uso de gcpdiag, consulta Verifica el estado del agente con gcpdiag.

Tareas opcionales

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

Configure 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"*"

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 a través de 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 systemctl restart google-cloud-ops-agent

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:

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 a través de 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.

    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

Crea una lista de 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

De forma opcional, para quitar el repositorio y desinstalar el agente, agrega --remove-repo al comando anterior.

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 mediante 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?