Ayúdanos a definir el futuro de las operaciones de software y haz oír tu voz mediante la encuesta estatal de DevOps 2021.

Instala el agente de Cloud Monitoring en una VM única

El agente de Cloud Monitoring recopila métricas del sistema y de la aplicación de tus instancias de VM y las envía a Monitoring. También puedes configurar el agente de Monitoring para supervisar las aplicaciones de terceros.

En esta guía, se explica cómo instalar el agente de Cloud Monitoring para Monitoring en las VM de Compute Engine y Amazon Elastic Compute Cloud (EC2). Usar el agente es opcional, pero se recomienda para las instancias de VM de Compute Engine. En estas VM, Monitoring puede acceder a algunas métricas del hipervisor de VM sin el agente, incluido el uso de CPU, algunas métricas de tráfico de disco, el tráfico de red y el tiempo de actividad. El agente es obligatorio para las VM de Amazon Elastic Compute Cloud (EC2).

En las instancias que ejecutan Microsoft Windows, el agente registra el uso de CPU y la memoria, el archivo de paginación y el uso del volumen. Si ejecutas el servidor IIS o SQL, el agente colecta métricas de esos servicios de manera predeterminada.

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 a un agente:

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

  • Si eres usuario de AWS, haz lo siguiente:

    1. Conecta tu cuenta de AWS a Google Cloud. Para obtener información sobre este proceso, consulta Visualiza las métricas de las cuentas de AWS.

    2. Consulta la sección Proyectos de Google Cloud para instancias de VM de AWS EC2 a fin de obtener más información.

  • Para obtener información sobre los precios, ve a Precios del paquete de operaciones de Google Cloud.

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

Instala el agente en una sola VM

Para instalar el agente, 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-monitoring-agent-repo.sh
    sudo bash add-monitoring-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://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.
    • --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 independiente (StackdriverLogging).
    • --uninstall-standalone-monitoring-agent: Desinstala el agente de supervisión independiente (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-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.

    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

    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
    

    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\Monitoring\"
    

    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.

Instala el agente en una VM de Compute Engine

Puedes instalar el agente de Monitoring en una sola VM desde el panel Instancias de VM preconfiguradas de Monitoring.

Para acceder a este panel, haz lo siguiente:

  1. En Cloud Console, selecciona tu proyecto de Google Cloud.
    Ir a Cloud Console
  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, ubica la entrada Instancias de VM y haz clic en el nombre.

En la pestaña Inventario en el panel Instancias de VM, se enumeran todas las VM y contienen 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.

Si el agente no se detecta en una instancia de Compute Engine, puedes hacer clic en el vínculo Instalar agente para abrir un flujo de trabajo de instalación en el panel.

Tareas opcionales

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

Configurar el agente

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

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 aún 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
      
  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. Reinicia el agente mediante la ejecución del comando siguiente en tu instancia de VM:

     sudo service stackdriver-agent restart
    

Windows

  1. Si usas un proxy HTTP, ejecuta el siguiente comando desde un símbolo del sistema del administrador. Esto establece las variables de entorno HTTP_PROXY y HTTPS_PROXY para que el agente pueda enviar datos a Monitoring 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:

Linux

Para actualizar el agente a la versión más reciente, ejecuta el comando siguiente:

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

Para actualizar el agente a la última versión menor 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, 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.

Enumera todas las versiones del agente

Para obtener una lista de las versiones disponibles del agente, ejecuta el siguiente comando:

AMAZON LINUX AMI / CENTOS / RHEL

Enumera las versiones disponibles del agente:

sudo yum list --showduplicates stackdriver-agent

DEBIAN / UBUNTU

Enumera las versiones disponibles del agente:

sudo apt-cache madison stackdriver-agent

SLES / SUSE

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

Linux

Ejecuta el siguiente comando:

sudo bash add-monitoring-agent-repo.sh --uninstall

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.

Información sobre proyectos de Google Cloud para instancias de VM de AWS EC2

Cuando la documentación se refiere a el proyecto de Google Cloud asociado a tu instancia de VM para instancias de VM de EC2, esta frase hace referencia al proyecto de conector de AWS vinculado a tu cuenta de AWS.

Cuando conectas tu cuenta de AWS a Google Cloud, creas un proyecto de conector de AWS. Para obtener información sobre este proceso, consulta Visualiza las métricas de las cuentas de AWS.

Para acceder al proyecto de conector de AWS de una cuenta de AWS, realiza una de las siguientes acciones:

  • Usa el selector de proyectos de Google Cloud Console a fin de identificar los proyectos que coinciden con las convenciones de nombres de proyectos de conectores de AWS y, luego, selecciona el proyecto específico para tu cuenta de AWS.

  • Identifica el proyecto de Google Cloud cuyo alcance de métricas incluya las métricas de tu cuenta de AWS y selecciona ese proyecto en el selector de proyectos de Google Cloud Console. Para este proyecto de Google Cloud, ve a la página Monitoring y, luego, selecciona la página Configuración. En la página Configuración, se enumeran los proyectos de conector de AWS. Puedes usar el selector de proyectos de Google Cloud Console para acceder al proyecto de conector de AWS.

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.

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.