Cómo instalar la solución de monitoreo Sensu en Ubuntu 22.04

Sensu es un sistema de monitoreo de infraestructura y aplicaciones de código abierto diseñado tanto para monitoreo de contenedores como de no contenedores y para infraestructura multi-nube.

Sensu es una solución de monitoreo escalable, segura e integrada para tu tecnología e infraestructura de servidores. Se puede utilizar para monitorear servidores, la salud de las aplicaciones y servicios, y enviar notificaciones de alertas a múltiples destinos con integración de terceros.

En esta guía, configurarás la solución de monitoreo Sensu en un servidor Ubuntu 22.04. También instalarás y configurarás el cliente Sensu-go que se utilizará para gestionar Sensu. Y por último, instalarás el Agente Sensu en el host objetivo para monitorear y configurar verificaciones de Sensu para el monitoreo básico del sistema.

Requisitos previos

Para completar esta guía, necesitarás los siguientes requisitos:

• Dos servidores Ubuntu 22.04 - El primer servidor se utilizará para instalar la solución de monitoreo Sensu, y el segundo servidor es el servidor objetivo a monitorear.
• Un usuario no root con privilegios de administrador sudo/root.

A continuación se detallan los servidores que se utilizarán para esta guía:

Hostname        IP Address      Used as  
--------------------------------------------------  
sensugo-server  192.168.5.100   Sensu Server  
machine1        192.168.5.120   Target Monitoring

Ahora pasemos a la instalación.

Agregando el repositorio de Sensu

Sensu es una solución de monitoreo segura y escalable que se puede instalar en múltiples sistemas operativos como Linux, macOS, Windows y FreeBSD. Sensu proporciona su propio repositorio, especialmente para distribuciones basadas en RHEL y Debian. Los paquetes de sensu se entregan a través del repositorio packagecloud.io.

Para este primer paso, configurarás el repositorio de Sensu tanto en el servidor Sensu como en el sistema de monitoreo objetivo.

Para comenzar, ejecuta el siguiente comando apt para actualizar el índice de paquetes e instalar algunos paquetes básicos en tu sistema.

sudo apt update  
sudo apt install wget curl gnupg2 apt-transport-https

Cuando se te solicite, ingresa y para confirmar y presiona ENTER.

A continuación, ejecuta el siguiente comando para agregar el repositorio estable de Sensu a tus sistemas. Esto descargará el script bash que configurará y configurará automáticamente el repositorio de Sensu para tus sistemas Ubuntu.

curl -s https://packagecloud.io/install/repositories/sensu/stable/script.deb.sh | sudo bash

Recibirás una salida similar a esta.

Después de que se agregue el repositorio de sensu, ahora estarás listo para comenzar la instalación de Sensu Go en el servidor Sensu y el Agente Sensu en el Monitoreo Objetivo.

Instalando y configurando Sensu Go Backend

Sensu Go Backend es el componente principal de la Plataforma de Monitoreo Sensu. Proporciona un panel de administración web y una API HTTP que te permite gestionar Sensu a través de la línea de comandos, y también proporciona los WebSockets que se utilizarán para que las máquinas/agentes objetivo se conecten.

Antes de comenzar, asegúrate de ejecutar todos los siguientes comandos en el Servidor Sensu. En este ejemplo, el nombre del servidor es ‘sensugo-server’.

Para comenzar, ejecuta el siguiente comando apt para instalar el backend de Sensu Go.

sudo apt install sensu-go-backend

Ahora debería comenzar la instalación.

Después de que se instale Sensu Go Backend, descarga la configuración de muestra a través del comando wget a ‘/etc/sensu/backend.yml’. Luego abre el archivo usando el comando del editor nano.

sudo curl -L https://docs.sensu.io/sensu-go/latest/files/backend.yml -o /etc/sensu/backend.yml  
sudo nano /etc/sensu/backend.yml

Descomenta las siguientes líneas en el archivo.

cache-dir: "/var/cache/sensu/sensu-backend"  
config-file: "/etc/sensu/backend.yml"  
  
log-level: "debug"  
state-dir: "/var/lib/sensu/sensu-backend"

Guarda el archivo y sal del editor cuando hayas terminado.

A continuación, ejecuta el siguiente comando de utilidad systemctl para iniciar y habilitar el servicio Sensu Go Backend ‘sensu-backend‘.

sudo systemctl start sensu-backend  
sudo systemctl enable sensu-backend

El ‘sensu-backend‘ debería estar ahora en ejecución y habilitado. Además, el servicio se ejecutará automáticamente al iniciar.

Verifica el estado del servicio ‘sensu-backend’ a través del siguiente comando systemctl.

sudo systemctl is-enabled sensu-backend  
sudo systemctl status sensu-backend

Recibirás una salida similar a esta - El servicio ‘sensu-backend‘ está habilitado y ahora está en ejecución.

Con el Sensu Go Backend en ejecución, a continuación inicializarás el Sensu Go Backend configurando la contraseña de administrador y generando algunas configuraciones.

Para inicializar la instalación de Sensu Go Backend, ejecuta el siguiente comando para crear nuevas variables de entorno que se utilizarán para configurar el usuario y la contraseña de administrador de Sensu.

Este ejemplo utilizará ‘sensuadmin‘ como el usuario y ‘sensupassword‘ como la contraseña. Así que asegúrate de cambiar el usuario y la contraseña de administrador.

export SENSU_BACKEND_CLUSTER_ADMIN_USERNAME=sensuadmin  
export SENSU_BACKEND_CLUSTER_ADMIN_PASSWORD=sensupassword

Ahora ejecuta el siguiente comando ‘sensu-backend’ para inicializar la instalación de Sensu Go Backend.

sensu-backend init

Recibirás una salida similar a esta - El Sensu Go Backend ahora está inicializado y se está ejecutando en el puerto predeterminado ‘3000‘.

Ahora abre el navegador web y visita la dirección IP del servidor seguida del puerto TCP 3000 (es decir: http://192.168.5.100:3000). Y deberías obtener la página de inicio de sesión de Sensu.

Inicia sesión con el nombre de usuario y la contraseña durante el proceso de inicialización y haz clic en ‘INICIAR SESIÓN‘.

Después de iniciar sesión, deberías ver el panel de administración de Sensu. Ahora has terminado la instalación de Sensu Go Backend.

Además, también puedes verificar el estado de salud de tu servidor Sensu Go a través de la API de Sensu.

Instala el paquete ‘jq‘ en tu sistema a través del siguiente comando apt.

sudo apt install jq -y

Ahora ejecuta el siguiente comando curl para acceder a la API del Servidor Sensu que se ejecuta en el puerto predeterminado ‘8080‘. Este comando verificará el estado de salud de tu servidor Sensu, luego la salida se formateará como json, lo que hace que la salida sea legible.

curl -s http://127.0.0.1:8080/health | jq .

Salida - En la siguiente salida, ‘Healthy: true’ y sin errores.

Instalando y configurando sensuctl

Con el Sensu Go Backend instalado y configurado, a continuación instalarás el Cliente Sensu Go en el Servidor Sensu. El Cliente Sensu Go proporciona una utilidad de línea de comandos ‘sensuctl’ que te permite gestionar Sensu a través del servidor de terminal.

La forma en que funciona ‘sensuctl’ es comunicándose con el Servidor Sensu a través de la API para crear, leer, actualizar y eliminar recursos, eventos y entidades en el Servidor Sensu.

Ejecuta el siguiente comando apt para instalar el Cliente Sensu Go. La instalación debería comenzar ahora.

sudo apt install sensu-go-cli

Después de que se instale ‘sensu-go-cli‘, abre el archivo ‘~ /.bashrc‘ usando el siguiente comando del editor nano.

nano ~/.bashrc

Agrega las siguientes líneas al final del archivo. Esta configuración habilitará la autocompletación para el comando ‘sensuctl’.

if [ -f /usr/share/bash-completion/bash_completion ]; then  
. /usr/share/bash-completion/bash_completion  
elif [ -f /etc/bash_completion ]; then  
. /etc/bash_completion  
fi  
  
source <(sensuctl completion bash)

Guarda el archivo y sal cuando hayas terminado.

A continuación, recarga tu sesión actual recargando el archivo ‘~/.bashrc‘. Luego verifica usando el comando ‘sensuctl’.

source ~/.bashrc  
sensuctl TAB

Si presionas el botón TAB después del comando ‘sensuctl‘, deberías obtener la lista de opciones para ese comando.

Con el Cliente Sensu Go instalado, ahora comenzarás a configurar la conexión al Servidor Sensu.

Ejecuta el siguiente comando ‘sensuctl configure‘ para agregar el Servidor Sensu.

sudo sensuctl configure

Ahora se te preguntará sobre algunas configuraciones:

• ¿Método de autenticación? nombre de usuario/contraseña
• ¿URL de la API de Sensu Backend? La API de Sensu se ejecuta por defecto en http://127.0.0.1:8080
• ¿Namespace? predeterminado
• ¿Formato de salida preferido? Selecciona el formato de salida que desees - este ejemplo es tabular.
• ¿Nombre de usuario? usuario administrador para sensu
• ¿Contraseña? contraseña para el usuario administrador de sensu

Después de que se complete la configuración de ‘sensuctl‘, ejecuta el siguiente comando para verificar los detalles de la configuración actual.

sudo sensuctl config view

Recibirás una salida similar a esta - El Cliente Sensu Go ahora está conectado al Servidor Sensu a través de la API HTTP que se ejecuta por defecto en localhost:8080.

En este punto, has terminado la configuración básica del Sensu Go Backend y del Cliente Sensu Go. En el siguiente paso, monitorearás la máquina objetivo a través del Agente Sensu.

Instalando el Agente Sensu en la Máquina Objetivo

El Agente Sensu es un cliente ligero que se ejecuta en las máquinas objetivo que deseas monitorear. Funciona comunicándose a través de WebSockets con el Servidor Sensu con características como auto-registro, envío de mensajes de keepalive y ejecución de verificaciones de monitoreo.

Antes de comenzar, asegúrate de que el repositorio de Sensu esté agregado. Además, asegúrate de ejecutar los siguientes comandos en la máquina objetivo, este ejemplo utiliza el servidor con el nombre de host ‘machine1‘.

Ejecuta el siguiente comando apt para instalar el Agente Sensu en tu sistema. La instalación debería proceder automáticamente.

sudo apt install sensu-go-agent

Después de que se instale el Agente Sensu, descarga el archivo de configuración del Agente Sensu a ‘ /etc/sensu/agent.yml‘ a través del comando curl. Luego abre el archivo ‘ /etc/sensu/agent.yml‘ usando el comando del editor nano.

sudo curl -L https://docs.sensu.io/sensu-go/latest/files/agent.yml -o /etc/sensu/agent.yml  
sudo nano /etc/sensu/agent.yml

Cambia la configuración predeterminada con las siguientes líneas. Asegúrate de cambiar el ‘nombre’ con el nombre de host de la máquina objetivo, y la URL del backend es la dirección WebSocket para el Servidor Sensu que se ejecuta en el puerto predeterminado ‘8081‘.

En este ejemplo, el nombre de host de la máquina objetivo es ‘machine1‘ y la dirección IP del Servidor Sensu es ‘192.168.5.100‘.

name: "machine1"  
namespace: "default"  
...  
backend-url:  
  - "ws://192.168.5.100:8081"  
cache-dir: "/var/cache/sensu/sensu-agent"  
config-file: "/etc/sensu/agent.yml"

Guarda el archivo y sal del editor cuando hayas terminado.

A continuación, ejecuta el siguiente comando de utilidad systemctl para iniciar y habilitar el servicio ‘sensu-agent‘. El servicio debería estar ahora en ejecución y habilitado, lo que significa que el servicio se iniciará automáticamente al arrancar.

sudo systemctl start sensu-agent  
sudo systemctl enable sensu-agent

Ahora verifica el servicio ‘sensu-agent’ a través del siguiente comando para asegurarte de que el servicio esté en ejecución.

sudo systemctl is-enabled sensu-agent  
sudo systemctl status sensu-agent

Recibirás una salida como la siguiente - El servicio ‘sensu-agent‘ está habilitado y el estado actual es en ejecución.

Por último, regresa a la terminal del Servidor Sensu y ejecuta el siguiente comando ‘sensuctl’ para verificar que la máquina objetivo ‘machine1’ esté disponible en el Servidor Sensu.

sensuctl entity list --format tabular

Recibirás una salida similar a esta - La máquina objetivo ‘machine1‘ se ha agregado al Servidor Sensu a través del Agente Sensu.

Ahora que la máquina objetivo ‘machine1’ se ha agregado al Servidor Sensu, a continuación configurarás verificaciones para el monitoreo básico del sistema.

Configurando verificaciones para el monitoreo del sistema

En Sensu, las verificaciones son donde defines qué cosa deseas monitorear. Ejemplos de verificaciones son el monitoreo del uso de CPU, uso de memoria, uso de disco, y muchos más. Las verificaciones son parte de los Activos, que son entornos dinámicos que son compartibles y reutilizables.

En este paso, crearás nuevas verificaciones para monitorear el uso de CPU, uso de memoria y uso de disco. Estas verificaciones se utilizarán para monitorear la máquina objetivo ‘machine1‘.

Para comenzar, ejecuta el siguiente comando sensuctl para actualizar la entidad o máquina objetivo ‘machine1‘.

sensuctl entity update machine1

La clase debe ser ‘agent‘ y la Suscripción debe ser ‘System‘.

Ahora ejecuta el siguiente comando de utilidad sensuctl para agregar activos a tu Servidor Sensu. Puedes obtener otro activo de Sensu desde el hub de activos de Sensu https://bonsai.sensu.io.

sensuctl asset add sensu/check-cpu-usage  
sensuctl asset add sensu/check-memory-usage  
sensuctl asset add sensu/check-disk-usage

Recibirás una salida similar a esta.

Agregando activo de tiempo de ejecución ‘sensu/check-cpu-usage‘

Agregando activo de tiempo de ejecución ‘sensu/check-memory-usage‘.

Agregando activo de tiempo de ejecución ‘sensu/check-disk-usage‘.

A continuación, verifica la lista de activos en el Servidor Sensu a través del comando sensuctl a continuación. Deberías ver que estos activos de tiempo de ejecución se han agregado al Servidor Sensu.

sensuctl asset list

Con los activos de Sensu agregados, a continuación crearás verificaciones basadas en el activo que has agregado.

Ejecuta el siguiente comando para crear una verificación ‘check_cpu’ con la suscripción como ‘system‘ y usa el activo de tiempo de ejecución ‘sensu/check-cpu-usage‘. Puedes ajustar la configuración en la opción ‘command‘.

sensuctl check create check_cpu \  
--command 'check-cpu-usage -w 75 -c 90' \  
--interval 60 \  
--subscriptions system \  
--runtime-assets sensu/check-cpu-usage

Ejecuta el siguiente comando para crear una verificación ‘check_mem‘ con la suscripción como ‘system’ y usa el activo de tiempo de ejecución ‘sensu/check-memory-usage‘. Puedes ajustar la configuración en la opción ‘command‘.

sensuctl check create check_mem \  
--command 'check-memory-usage -w 80 -c 90' \  
--interval 60 \  
--subscriptions system \  
--runtime-assets sensu/check-memory-usage

Ejecuta el siguiente comando para crear una verificación ‘check_disk’ con la suscripción como ‘system‘ y usa el activo de tiempo de ejecución ‘sensu/check-disk-usage‘. Puedes ajustar la configuración en la opción ‘command‘.

sensuctl check create check_disk \  
--command 'check-disk-usage --include-fs-type "xfs,ext4" --exclude-fs-path "/boot" --warning 90 --critical 95' \  
--interval 60 \  
--subscriptions system \  
--runtime-assets sensu/check-disk-usage

Ahora verifica la lista de verificaciones en el Servidor Sensu a través de la utilidad de comando ‘sensuctl’ a continuación. Luego verás tres verificaciones que has creado, check_cpu, check_mem y check_disk.

sensuctl check list

Ahora regresa al navegador web y visita el panel de administración de Sensu. Asegúrate de que estés en el namespace ‘default‘, luego haz clic en ‘Entities‘.

Deberías ver que la máquina objetivo ‘machine1‘ se ha agregado con el estado OK.

Haz clic en ‘machine1‘ para obtener detalles de monitoreo. Y deberías obtener la página como la siguiente - todas las verificaciones que has creado se están ejecutando y funcionando.

Ahora has creado y configurado activos y verificaciones para el monitoreo del sistema en el Servidor Sensu.

Conclusión

Ahora has instalado la solución de monitoreo Sensu en el Servidor Ubuntu 22.04. También has aprendido el uso básico del comando Sensuctl para gestionar el backend de Sensu. Además, has monitoreado con éxito la máquina host Linux a través del Agente Sensu y configurado “activos” y “verificaciones” para monitorear servidores objetivo.