Instalar el agente de Monitoring en VM individuales

Este es un agente heredado. Si bien este agente sigue siendo compatible con Linux, te recomendamos que no lo uses para cargas de trabajo nuevas de Google Cloud.

En cambio, te recomendamos que uses el Agente de operaciones para las cargas de trabajo nuevas de Google Cloud y, luego, realices la transición de tus VMs existentes de Compute Engine a fin de usar el Agente de operaciones. El Agente de operaciones, que combina la recopilación de métricas y el registro en un solo agente, es el reemplazo final para los agentes heredados.

El Agente de operaciones está en desarrollo activo, pero puede haber algunos casos de uso que no admite. Si el Agente de operaciones no es compatible con tu caso de uso, puedes usar el agente de Monitoring en Linux.

No se desarrollarán nuevas funciones ni se admitirán nuevos sistemas operativos para el agente heredado de Monitoring.

Recomendamos que no uses el agente de Monitoring heredado en Windows. El agente de Monitoring heredado en Windows no es compatible, y todas sus funciones están disponibles en el Agente de operaciones. Recomendamos usar el Agente de operaciones para supervisar instancias de Windows. Sin embargo, si tienes que ejecutar el agente de Logging heredado en Windows y también necesitas recopilar métricas, debes usar el agente de Monitoring heredado; no puedes ejecutar el Agente de operaciones y un agente heredado en la misma máquina.

El agente de Monitoring 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.

Nota: El agente de Cloud Monitoring está diseñado para transferir métricas de telemetría de agentes, de terceros y definidas por el usuario. Algunas de estas métricas son cobrables. Para obtener más información sobre los precios, consulta Precios de Monitoring.

Antes de comenzar

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

• Una instancia de VM compatible en un proyecto de Google Cloud o una cuenta de Amazon Web Services (AWS)

  • Se recomienda tener un mínimo de 250 MiB de memoria residente (RSS) para ejecutar el agente de Monitoring.

  Además, asegúrate de que tu VM ejecute un sistema operativo compatible.

• Las credenciales en la instancia de VM que autorizan la comunicación con Cloud Logging o Cloud Monitoring. Por lo general, las instancias de VM de Compute Engine tienen las credenciales adecuadas de forma predeterminada. Si alguno de los siguientes casos se aplica a tu situación, es posible que no tengas las credenciales adecuadas y debas completar los procedimientos que se indican en Autoriza al agente de Monitoring:

  • Si ejecutas instancias de VM de AWS EC2, deberás instalar las credenciales de autorización en tus VM antes de instalar el agente

  • Si ejecutas instancias de Compute Engine muy antiguas o instancias de Compute Engine creadas sin las credenciales predeterminadas

  Para comprobar si tienes las credenciales adecuadas, ejecuta los procedimientos que se indican en Verifica las credenciales de Compute Engine.

• Para obtener información sobre los precios, ve a Precios para Google Cloud Observability.

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

Instala el agente desde la línea de comandos

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

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-monitoring-agent-repo.sh
   sudo bash add-monitoring-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://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe")
   & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"
   

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-monitoring-agent-repo.sh
   

   Cuando ejecutas la secuencia de comandos add-monitoring-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.

   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-monitoring-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

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

      sudo bash add-monitoring-agent-repo.sh --also-install \
        --version=6.*.*
      

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

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

5. Inicia el servicio del agente

   sudo service stackdriver-agent start
   

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 service stackdriver-agent status
  

  El estado del agente debe ser OK.

• También puedes examinar los registros y asegurarte de que no haya errores:

  sudo grep collectd /var/log/{syslog,messages} | tail
  

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.

   Nota: Solo la versión más reciente del agente es compatible con las instancias de VM que ejecutan Windows. No se recomienda instalar versiones anteriores.

   1. Ejecuta los siguientes comandos de PowerShell:

      (New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe")
      & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"
      

   Como alternativa, puedes navegar a la siguiente URL para descargar y ejecutar el instalador del agente:

   https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe

   Precaución: Debes descargar el instalador en un directorio que no sea del sistema, como C:\Users\[USERNAME]. Por motivos de seguridad, el instalador no se ejecuta desde los directorios del sistema, incluido el directorio C:\.
   Si descargas el instalador en un directorio del sistema, trasládalo a otro directorio antes de ejecutarlo.
   Nota: El instalador del agente también admite una opción "silenciosa", /S, que se puede usar en la secuencia de comandos de la instalación.

   Para instalar el agente de forma silenciosa, agrega la opción /S a la invocación del instalador:

   & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S
   

   Precaución: La instalación silenciosa es un proceso asíncrono. El agente aún no está instalado cuando se cierra el comando de instalación. Para comprobar si la instalación se realizó de manera correcta, busca el servicio StackdriverMonitoring.
   Nota: El instalador coloca el agente en el directorio “C:\Program Files (x86)\Stackdriver\Google Cloud ObservabilityAgent” de forma predeterminada. Puedes cambiar ese directorio durante la instalación.

   En el modo "silencioso", usa la opción /D para especificar el directorio de instalación, por ejemplo:

   & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S /D="C:\Stackdriver\Google Cloud Observability\"
   

   Puedes borrar el instalador una vez que la instalación se complete de forma correcta.

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

Visualiza la información del agente mediante la consola de Google Cloud

Puedes encontrar información de estado del agente en el panel de Instancias de VM de Monitoring preconfigurado. Para acceder a este panel, haz lo siguiente:

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:

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.

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

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.

Tareas opcionales

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

Configurar el agente de Monitoring

Para ajustar la configuración del agente, consulta Configura el agente de Monitoring.

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):

   • Para las versiones de agente 6.0.0 y versiones posteriores, edita lo siguiente:

     /etc/default/stackdriver-agent
     

   • En las versiones de agente anteriores a la 6.0.0, edita el archivo adecuado para tu SO:

     En Debian y Ubuntu, edita lo siguiente:

     /etc/default/stackdriver-agent
     

     En CentOS y SLES, edita lo siguiente:

     /etc/default/stackdriver-collectd
     

     Nota: Si el archivo no existe, créalo.

2. Agrega lo siguiente al archivo.

    export http_proxy="http://proxy-ip:proxy-port"
    export https_proxy="http://proxy-ip:proxy-port"
    export no_proxy=169.254.169.254  # Skip proxy for the local Metadata Server.
   

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

    sudo service stackdriver-agent restart
   

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 169.254.169.254 /m
   

Determina la versión del agente

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

AMAZON LINUX AMI / CENTOS / RHEL

Ejecuta el siguiente comando en Amazon Linux, Red Hat o CentOS Linux:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent

DEBIAN / UBUNTU

Ejecuta el siguiente comando en Debian o Ubuntu:

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

SLES / SUSE

Ejecuta el siguiente comando en SUSE:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent

WINDOWS

Por el momento, no hay forma de determinar la versión del agente de Monitoring que se ejecuta en Windows.

Reinicia el agente

Debes reiniciar el agente de Monitoring para que se incorporen los cambios en los archivos de configuración. Para reiniciar el agente, sigue estas instrucciones.

LINUX

Ejecuta el siguiente comando en tu instancia:

     sudo service stackdriver-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 -Name StackdriverMonitoring

Actualiza el agente

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

Nota: Si actualizaste el sistema operativo Linux de tu instancia a una nueva versión principal, es mejor que no actualices el agente con este procedimiento, sino que lo quites y, luego, vuelvas a instalarlo según los procedimientos que se indican en esta página.

Linux

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

sudo bash add-monitoring-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-monitoring-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

Para actualizar a la última versión del agente, instala el agente más reciente según se indica en la sección de esta página sobre la instalación en Windows. En la instalación, se te solicitará que desinstales la versión anterior del agente.

Crea una lista de todas las versiones del agente

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

AMAZON LINUX AMI / CENTOS / RHEL

Crea una lista de las versiones disponibles del agente:

sudo yum list --showduplicates stackdriver-agent

DEBIAN / UBUNTU

Crea una lista de las versiones disponibles del agente:

sudo apt-cache madison stackdriver-agent

SLES / SUSE

Crea una lista de las versiones disponibles del agente:

sudo zypper search -s stackdriver-agent

WINDOWS

No se admite la instalación de versiones anteriores del agente en Windows.

Desinstala el agente

Para quitar el agente de Monitoring 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-monitoring-agent-repo.sh --uninstall

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

Windows

En el panel de control de Windows, elige Desinstalar un programa. Debes ver el agente de Monitoring en la lista de programas que puedes desinstalar. También puedes ejecutar uninstall.exe desde el directorio en el que instalaste el agente de Monitoring.

VM sin acceso a paquetes remotos

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

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?

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