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.
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 de Google Cloud's operations suite.
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.
Proyectos de Google Cloud para instancias de VM de AWS EC2
Cuando la documentación menciona al proyecto de Google Cloud asociado a tu instancia de VM, en el caso de las instancias de VM de EC2, esta frase hace referencia al proyecto del conector de AWS vinculado a tu cuenta de AWS.
Cuando conectas tu cuenta de AWS a un lugar de trabajo, se crea el proyecto del conector de AWS. Para identificar el proyecto de conector de AWS, ve a la pestaña Configuración del lugar de trabajo. El proyecto de conector se enumera en el encabezado Cuentas de AWS. En la columna ID del proyecto, se muestran los proyectos de Google Cloud asociados con tu lugar de trabajo.
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 usas VPC-SC o una red privada, la configuración de red también puede afectar tu capacidad para instalar dependencias de agentes de repositorios ascendentes. El agente en sí puede accederse a través de 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.
Instala el agente en una sola VM
Para reiniciar el agente, sigue estas instrucciones.
AMAZON LINUX AMI / CENTOS / RHEL
Abre una conexión de terminal en tu instancia de VM mediante SSH o una herramienta similar y asegúrate de tener acceso
sudo
.Cambia a un directorio al que tengas acceso de escritura, como 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
Instala el agente:
Crea una lista de las versiones disponibles del agente para seleccionar qué versión instalar:
sudo yum list --showduplicates stackdriver-agent
Para los entornos de producción, es posible que desees fijar una versión principal a fin de evitar la incorporación de versiones principales que pueden incluir cambios incompatibles con versiones anteriores. Para fijar una versión principal, ejecuta el siguiente comando:
sudo yum install -y stackdriver-agent-major-version.*
Por ejemplo, si deseas fijar la versión 6.x.x del agente, ejecuta este comando:
sudo yum install -y stackdriver-agent-6.*
Si no deseas fijar una versión principal, puedes seleccionar una de las otras opciones de instalación:
Para instalar una versión específica del agente, ejecuta este comando:
sudo yum install -y stackdriver-agent-version-number
Para instalar la versión más reciente del agente, ejecuta este comando:
sudo yum install -y stackdriver-agent
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.
DEBIAN / UBUNTU
Abre una conexión de terminal en tu instancia de VM mediante SSH o una herramienta similar y asegúrate de tener acceso
sudo
.Cambia a un directorio al que tengas acceso de escritura, como 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
Instala el agente:
Crea una lista de las versiones disponibles del agente para seleccionar qué versión instalar:
sudo apt-cache madison stackdriver-agent
Para los entornos de producción, es posible que desees fijar una versión principal a fin de evitar la incorporación de versiones principales que pueden incluir cambios incompatibles con versiones anteriores. Para fijar una versión principal, ejecuta el siguiente comando:
sudo apt-get install -y 'stackdriver-agent=major-version.*'
Por ejemplo, si deseas fijar la versión 6.x.x del agente, ejecuta este comando:
sudo apt-get install -y 'stackdriver-agent=6.*'
Si no deseas fijar una versión principal, puedes seleccionar una de las otras opciones de instalación:
Para instalar una versión específica del agente, ejecuta este comando:
sudo apt-get install -y stackdriver-agent=version-number
Para instalar la versión más reciente del agente, ejecuta este comando:
sudo apt-get install -y stackdriver-agent
Puedes borrar la secuencia de comandos de instalación una vez que se ejecuta 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.
SLES / SUSE
Abre una conexión de terminal en tu instancia de VM mediante SSH o una herramienta similar y asegúrate de tener acceso
sudo
.Cambia a un directorio al que tengas acceso de escritura, como 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
Instala el agente:
Crea una lista de las versiones disponibles del agente para seleccionar qué versión instalar:
sudo zypper search -s stackdriver-agent
Para los entornos de producción, es posible que desees fijar una versión principal a fin de evitar la incorporación de versiones principales que pueden incluir cambios incompatibles con versiones anteriores. Para fijar una versión principal, ejecuta el siguiente comando:
sudo zypper install -y 'stackdriver-agent<major-version.0.0'
Por ejemplo, si deseas fijar la versión 6.x.x del agente, ejecuta este comando:
sudo zypper install -y 'stackdriver-agent<7.0.0'
Si no deseas fijar una versión principal, puedes seleccionar una de las otras opciones de instalación:
Para instalar una versión específica del agente, ejecuta este comando:
sudo zypper install -y stackdriver-agent=version-number
Para instalar la versión más reciente del agente, ejecuta este comando:
sudo zypper install -y stackdriver-agent
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
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 de PowerShell. No necesitas privilegios de administrador.
(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:.\StackdriverMonitoring-GCM-46.exe /S
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 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 de instancias de VM de Monitoring preconfiguradas.
Para acceder a este panel, haz lo siguiente:
- En Cloud Console, selecciona tu proyecto de Google Cloud.
Ir a Cloud Console - En el panel de navegación, selecciona Monitoring.
Si nunca usaste Cloud Monitoring, entonces, en tu primer acceso a Monitoring en Google Cloud Console, se crea un lugar de trabajo de forma automática y tu proyecto se asocia con ese lugar de trabajo. De lo contrario, si el proyecto no está asociado con un lugar de trabajo, aparecerá un diálogo y podrás crear uno o agregar tu proyecto a un lugar de trabajo existente. Te recomendamos que crees un lugar de trabajo. Después de realizar la selección, haz clic en Agregar.
- En el panel de navegación de Monitoring, selecciona Alertas.
- En la tabla de paneles, ubica la entrada Instancias de VM y haz clic en el nombre.
La pestaña Inventario en el panel Instancias de VM muestra todas las VM y contiene una columna de estado para el agente, como se muestra en la siguiente captura de pantalla:
Si el agente no se detecta en una instancia de Compute Engine, puedes hacer clic en el vínculo "No detectado" 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
Edita el siguiente archivo de configuración (debe crearse si 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
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.
Reinicia el agente de supervisión ejecutando el siguiente comando en tu instancia de VM.
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
yHTTPS_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
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. Necesitas privilegios de administrador.
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 -y stackdriver-agent
SLES / SUSE
Ejecuta el siguiente comando en SUSE:
sudo zypper update stackdriver-agent
Si actualizas desde un agente con la versión <= 6.0.5, debes reiniciar el servicio de forma manual:
sudo service stackdriver-agent restart
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. El instalador 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 remove 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.