Cómo instalar el agente de Cloud Monitoring

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 Compute Engine y las VM de Amazon Elastic Compute Cloud (EC2). Usar el agente es opcional, pero recomendado. Monitoring puede acceder a algunas métricas desde el hipervisor de la VM sin el agente, incluido el uso de CPU, algunas métricas de tráfico de disco, el tiempo de actividad y el tráfico de red.

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.
Un lugar de trabajo que supervise la cuenta de AWS que contiene la instancia de VM. Para obtener información sobre los precios, ve a Precios para el paquete de operaciones de Google Cloud.
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 correctas de manera predeterminada. Si alguno de los siguientes casos se aplica a ti, 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.

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 conecta su cuenta de AWS a un espacio de trabajo, se crea el proyecto del conector de AWS. El proyecto de conector tiene los siguientes atributos:

Un nombre que comienza con AWS Link
Un ID que comienza con aws-

Este ID es el proyecto de Google Cloud asociado a tu instancia de VM.

Consulta la página Lugares de trabajo para obtener más información sobre los proyectos 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 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.

Instala en Linux y Windows

Para instalar el agente en instancias de VM que ejecutan Linux o Microsoft Windows, sigue las siguientes instrucciones.

AMAZON LINUX AMI / CENTOS / RHEL

Abre una conexión de terminal en tu instancia de VM con SSH o una herramienta similar.
Asegúrate de tener acceso sudo.
Cambia a un directorio al que tengas acceso de escritura, por ejemplo, tu directorio principal.
Agrega el repositorio de paquetes del agente:
```
curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
    sudo bash add-monitoring-agent-repo.sh
    
```
Nota: La secuencia de comandos de instalación anterior, install-monitoring-agent.sh, dejó de estar disponible el 31 de enero de 2020 y se retirará el 30 de enero de 2021. La secuencia de comandos anterior solo instala versiones del agente anteriores a la 6.0.0, por lo que se recomienda a los usuarios migrar a la nueva secuencia de comandos tan pronto como sea posible. Después de migrar a la nueva secuencia de comandos, puede fijar temporalmente la versión 5.xx del agente para medir el impacto de los cambios más recientes en la versión 6.0.0. Sin embargo, con el lanzamiento de la versión 6.0.0 del agente, la versión 5.xx podría dejar de estar disponible en breve.
Instala el agente:
1. Para instalar la versión más reciente del agente, ejecuta lo siguiente:
```
sudo yum install -y stackdriver-agent
    
```
2. De manera opcional, puede mostrar todas las versiones disponibles del agente para seleccionar la versión que se instalará. Para ver una lista de las versiones disponibles, ejecuta lo siguiente:
```
sudo yum list -y stackdriver-agent
    
```
3. En el caso de los entornos de producción, es posible que desee fijar una versión principal para evitar incluir versiones principales que podrían incluir cambios incompatibles con versiones anteriores. Para fijar una versión principal, ejecuta lo siguiente:
```
sudo yum install -y stackdriver-agent-[MAJOR_VERSION].*
    
```
  Por ejemplo, para fijar a la versión Nxx del agente, ejecute lo siguiente:
```
sudo yum install -y stackdriver-agent-N.*
    
```
4. También tiene la opción de instalar una versión específica del agente ejecutando el siguiente comando:
```
sudo yum install -y stackdriver-agent-[VERSION_NUMBER]
    
```

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

DEBIAN / UBUNTU

Abre una conexión de terminal en tu instancia de VM con SSH o una herramienta similar.
Asegúrate de tener acceso sudo.
Cambia a un directorio al que tengas acceso de escritura, por ejemplo, tu directorio principal.
Agrega el repositorio de paquetes del agente:
```
curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
    sudo bash add-monitoring-agent-repo.sh
    sudo apt-get update
    
```
Nota: La secuencia de comandos de instalación anterior, install-monitoring-agent.sh, dejó de estar disponible el 31 de enero de 2020 y se retirará el 30 de enero de 2021. La secuencia de comandos anterior solo instala versiones del agente anteriores a la 6.0.0, por lo que se recomienda a los usuarios migrar a la nueva secuencia de comandos tan pronto como sea posible. Después de migrar a la nueva secuencia de comandos, puede fijar temporalmente la versión 5.xx del agente para medir el impacto de los cambios más recientes en la versión 6.0.0. Sin embargo, con el lanzamiento de la versión 6.0.0 del agente, la versión 5.xx podría dejar de estar disponible en breve.
Instala el agente:
1. Para instalar la versión más reciente del agente, ejecuta lo siguiente:
```
sudo apt-get install stackdriver-agent
    
```
2. De manera opcional, puede mostrar todas las versiones disponibles del agente para seleccionar la versión que se instalará. Para ver una lista de las versiones disponibles, ejecuta lo siguiente:
```
sudo apt-cache madison stackdriver-agent
    
```
3. En el caso de los entornos de producción, es posible que desee fijar una versión principal para evitar incluir versiones principales que podrían incluir cambios incompatibles con versiones anteriores. Para fijar una versión principal, ejecuta lo siguiente:
```
sudo apt-get install 'stackdriver-agent=[MAJOR_VERSION].*'
    
```
  Por ejemplo, para fijar a la versión Nxx del agente, ejecute lo siguiente:
```
sudo apt-get install 'stackdriver-agent=N.*'
    
```
4. También tiene la opción de instalar una versión específica del agente ejecutando el siguiente comando:
```
sudo apt-get install stackdriver-agent=[VERSION_NUMBER]
    
```

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

SLES / SUSE

Abre una conexión de terminal en tu instancia de VM con SSH o una herramienta similar.
Asegúrate de tener acceso sudo.
Cambia a un directorio al que tengas acceso de escritura, por ejemplo, tu directorio principal.
Agrega el repositorio de paquetes del agente:
```
curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
    sudo bash add-monitoring-agent-repo.sh
    
```
Nota: La secuencia de comandos de instalación anterior, install-monitoring-agent.sh, dejó de estar disponible el 31 de enero de 2020 y se retirará el 30 de enero de 2021. La secuencia de comandos anterior solo instala versiones del agente anteriores a la 6.0.0, por lo que se recomienda a los usuarios migrar a la nueva secuencia de comandos tan pronto como sea posible. Después de migrar a la nueva secuencia de comandos, puede fijar temporalmente la versión 5.xx del agente para medir el impacto de los cambios más recientes en la versión 6.0.0. Sin embargo, con el lanzamiento de la versión 6.0.0 del agente, la versión 5.xx podría dejar de estar disponible en breve.
Instala el agente:
1. Para instalar la versión más reciente del agente, ejecuta lo siguiente:
```
sudo zypper install stackdriver-agent
    
```
2. De manera opcional, puede mostrar todas las versiones disponibles del agente para seleccionar la versión que se instalará. Para ver una lista de las versiones disponibles, ejecuta lo siguiente:
```
sudo zypper search -s stackdriver-agent
    
```
3. En el caso de los entornos de producción, es posible que desee fijar una versión principal para evitar incluir versiones principales que podrían incluir cambios incompatibles con versiones anteriores. Para fijar una versión principal, ejecuta lo siguiente:
```
sudo zypper install 'stackdriver-agent<[MAJOR_VERSION].0.0'
    
```
  Por ejemplo, para fijar a la versión Nxx del agente, ejecute lo siguiente:
```
sudo zypper install 'stackdriver-agent<N+1.0.0'
    
```
4. También tiene la opción de instalar una versión específica del agente ejecutando el siguiente comando:
```
sudo zypper install stackdriver-agent=[VERSION_NUMBER]
    
```

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

WINDOWS

Para instalar el agente en una instancia de VM que ejecute Windows, sigue estos pasos:

Conéctate a tu instancia mediante RDP o una herramienta similar y accede a Windows.
Abre una terminal de PowerShell y ejecuta los siguientes comandos. No necesitas privilegios de administrador.
```
cd $env:UserProfile;
    (New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", ".\StackdriverMonitoring-GCM-46.exe")
    .\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:
```
.\StackdriverMonitoring-GCM-46.exe /S
    
```
Precaución: La instalación silenciosa es una operación asíncrona. 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\MonitoringAgent” 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:
```
.\StackdriverMonitoring-GCM-46.exe /S /D="C:\Google Cloud's operations suite\Monitoring\"
    
```
Puedes borrar el instalador una vez que se complete de forma correcta.

Tareas opcionales

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

Cómo configurar un proxy HTTP

Si usas un proxy HTTP, haz lo siguiente:

LINUX

Edite el siguiente archivo de configuración:
- Para las versiones de agente 6.0.0 y posteriores, edita:
```
/etc/default/stackdriver-agent
    
```
- Para las versiones de agente anteriores a la 6.0.0, edita el archivo adecuado para tu SO:
  
  Para Debian y Ubuntu, edita:
```
/etc/default/stackdriver-agent
    
```
  Para CentOS y SLES, edita:
```
/etc/default/stackdriver-collectd
    
```
  Nota: Si este archivo no existe, créelo.

Agrega estas líneas:

 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.

Ejecuta el siguiente comando en tu instancia de VM para reiniciar el agente de Monitoring:
```
 sudo service stackdriver-agent restart
    
```

WINDOWS

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

Requiere privilegios de administrador: Para reiniciar el agente, ejecuta los siguientes comandos en tu instancia de VM en PowerShell:

Restart-Service -Name StackdriverMonitoring

Actualiza el agente

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

AMAZON LINUX AMI / CENTOS / RHEL

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

sudo yum update stackdriver-agent

DEBIAN / UBUNTU

Ejecuta los siguientes comandos en Debian o Ubuntu:

sudo apt-get update
    sudo apt-get install stackdriver-agent

SLES / SUSE

Ejecuta el siguiente comando en SUSE:

sudo zypper update stackdriver-agent

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.

Desinstala el agente

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

AMAZON LINUX AMI / CENTOS / RHEL

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

sudo yum remove stackdriver-agent

DEBIAN / UBUNTU

Ejecuta el siguiente comando en Debian o Ubuntu:

sudo apt-get purge stackdriver-agent

SLES / SUSE

Ejecuta el siguiente comando en SUSE Linux:

sudo zypper remove stackdriver-agent

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.

Soluciona problemas

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