Cómo instalar la solución de monitoreo Sensu en Debian 11

Sensu es un sistema de monitoreo de infraestructura y aplicaciones de código abierto diseñado tanto para el monitoreo de contenedores como para el monitoreo de infraestructura multi-nube. Sensu es una solución de monitoreo escalable, segura e integrada para su tecnología e infraestructura de servidores. Se puede utilizar para monitorear servidores, la salud de aplicaciones y servicios, y enviar notificaciones de alertas a múltiples destinos con integración de terceros.

En este tutorial, aprenderá cómo instalar el software de monitoreo Sensu en un servidor Debian 11. También aprenderá cómo configurar Sensu CLI para gestionar Sensu. Finalmente, aprenderá cómo configurar el monitoreo del servidor con Sensu a través de Sensu Agent.

Prerrequisitos

Para esta implementación de Sensu, necesitará los siguientes requisitos:

• Un servidor Debian 11 con 4 GB de RAM y 2 CPUs. Este requisito depende mucho de su entorno de infraestructura.
• Un usuario no root con privilegios de sudo/administrador.
• Se utilizará una máquina Linux como objetivo a monitorear.

Agregando el repositorio de Sensu

Para comenzar con la instalación de Sensu, necesitará agregar el repositorio de paquetes de Sensu a todos sus sistemas, tanto al backend de Sensu como a los servidores de destino.

El repositorio de Sensu está disponible en packagecloud.io, que se puede agregar a su sistema manualmente o a través del script bash proporcionado por packagecloud.io.

Antes de agregar el repositorio de Sensu, ejecute el comando apt a continuación para instalar las dependencias básicas del paquete. Presione Y y Enter cuando se le pida confirmar la instalación.

sudo apt install debian-archive-keyring curl gnupg apt-transport-https

Ahora ejecute el siguiente comando para agregar el repositorio de Sensu. Este script bash agregará automáticamente el repositorio de Sensu y la clave GPG a sus servidores Debian.

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

Si desea agregar manualmente el repositorio de Sensu, siga estos pasos:

Cree un directorio de llaveros para almacenar la clave GPG del repositorio de Sensu.

mkdir -p /etc/apt/keyrings/  
curl -fsSL https://packagecloud.io/sensu/stable/gpgkey | gpg --dearmor > /etc/apt/keyrings/sensu_stable-archive-keyring.gpg

Agregue el repositorio de Sensu utilizando el siguiente comando. Este repositorio es para Debian 11 Bullseye y la última versión estable de Sensu.

cat <

Ahora puede actualizar y refrescar su índice de paquetes de Debian utilizando el siguiente comando apt.

sudo apt update

Instalando Sensu Backend

El corazón principal de la solución de monitoreo Sensu es un “Sensu Backend”, que proporciona una API HTTP que puede ser utilizada por un administrador a través del comando “sensuctl”. La API de WebSocket que será utilizada por “Sensu Agent” para el monitoreo, y también proporciona un panel de control de interfaz web para gestionar Sensu.

Además, Sensu utiliza “ etcd “ para almacenar datos, especialmente en grandes implementaciones de clústeres de Sensu.

Para instalar Sensu Backend, ejecute el comando apt a continuación. La instalación comenzará automáticamente.

sudo apt install sensu-go-backend

Después de que la instalación haya finalizado, descargue el ejemplo de configuración del backend de Sensu en “/etc/sensu/backend.yml”. Luego, edite el archivo “/etc/sensu/backend.yml” utilizando el siguiente comando.

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

Descomente la siguiente configuración.

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

Cuando haya terminado, guarde y cierre el archivo.

A continuación, ejecute el siguiente comando systemctl para iniciar el servicio Sensu Backend y habilitarlo. Y el servicio Sensu Backend se ejecutará automáticamente al inicio del sistema.

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

Verifique el servicio de backend de Sensu utilizando el siguiente comando. Debería ver que el servicio de Sensu Backend está actualmente en ejecución y habilitado.

sudo systemctl status sensu-backend

Después de que el backend de Sensu esté en funcionamiento, ahora inicializará la instalación y configuración de Sensu Backend. Esto se puede hacer utilizando la línea de comandos “sensu-backend init”, que es proporcionada por el paquete Sensu Backend.

Además, durante la inicialización de Sensu Backend, configurará el usuario administrador y la contraseña para su solución de monitoreo Sensu.

Ejecute el siguiente comando para crear nuevas variables de entorno del sistema para el usuario administrador de Sensu y la contraseña. En este ejemplo, creará un nuevo usuario administrador de Sensu “ adminsensu “ con la contraseña “ SensuRocks “.

export SENSU_BACKEND_CLUSTER_ADMIN_USERNAME=adminsensu  
export SENSU_BACKEND_CLUSTER_ADMIN_PASSWORD=SensuRocks

Ahora comience a inicializar el backend de Sensu utilizando el siguiente comando. Debería ver el proceso de inicialización y Sensu almacenará datos dentro del almacén de datos “etcd”.

sensu-backend init

Para verificar su instalación de Sensu backend, realizará la verificación de salud de Sensu a través del comando curl a la API HTTP de Sensu que se ejecuta en el puerto predeterminado “8080”.

Ejecute el comando curl a continuación para realizar la verificación de salud de su instalación de Sensu backend. Debería ver el mensaje de salida en la pantalla de su terminal como “ health: OK “.

curl http://127.0.0.1:8080/health

También puede visitar el panel de control de la interfaz web de Sensu a través del puerto TCP “ 3000 “. Abra su navegador web y visite la dirección IP de su servidor seguida del puerto 3000 (es decir: http://192.168.5.100:3000). Y debería ver la página de inicio de sesión de Sensu.

Ingrese el usuario administrador “ adminsensu “ con la contraseña “ SensuRocks “. Luego, haga clic en “ SIGN-IN “ para iniciar sesión en el panel de control de la interfaz web de Sensu.

Ahora debería ver el panel de administración web de Sensu.

Instalando la línea de comandos Sensuctl

En Sensu, el administrador puede gestionar la solución de monitoreo Sensu a través del panel de administración de la interfaz web de Sensu y a través de la terminal de línea de comandos utilizando “ sensuctl “.

El “ sensuctl “ es una herramienta de línea de comandos para gestionar los recursos de Sensu. Se utiliza una API HTTP para comunicarse con Sensu Backend, lo que le permite crear, leer y eliminar recursos, eventos y entidades.

El “ sensuctl “ se puede instalar en múltiples sistemas operativos como Linux, Windows y macOS. La función de “sensuctl” es similar al panel de administración de la interfaz web de Sensu, y puede instalarlo en su estación de trabajo local o en el servidor “bastion” seguro de su infraestructura.

Para sistemas basados en Debian/Ubuntu, ejecute el siguiente comando apt a continuación para instalar la herramienta de línea de comandos “ sensuctl “. La instalación comenzará automáticamente.

sudo apt install sensu-go-cli

Después de que la instalación haya finalizado, ejecute el siguiente comando “ sensuctl “ para comenzar a configurar y conectarse a la API del servidor Sensu Backend.

sensuctl configure

Se le pedirá que realice las siguientes configuraciones:

• Para el método de autenticación, seleccione “nombre de usuario/contraseña”.
• Ingrese la URL de la API de Sensu Backend de su servidor. En este ejemplo, configuraremos “sensuctl” en el mismo servidor, por lo que el host será localhost o “127.0.0.1”. Y el puerto predeterminado para la API HTTP de Sensu es “8080” - http://127.0.0.1:8080.
• Para la configuración del espacio de nombres, seleccione “default”.
• Para el formato de salida, puede seleccionar el estilo “tabular” o utilizar el formato de salida “yaml”.
• Por último, ingrese el usuario administrador y la contraseña para su Sensu Backend.

Ahora ha completado la configuración básica de “ sensuctl “ y se ha conectado al servidor API de Sensu Backend.

Ejecute el siguiente comando “ sensuctl “ a continuación para verificar su configuración. Debería ver configuraciones detalladas de la API de “ sensuctl “.

sensuctl config view

Además, el “sensuctl” también proporciona autocompletado para su shell. Si está utilizando bash, necesita instalar el paquete “bash-completion” y agregar algunas configuraciones al archivo de configuración “ ~/.bashrc “.

Ejecute el siguiente comando apt para instalar el paquete “bash-completion”.

sudo apt install bash-completion

Ahora edite la configuración de “~/.bashrc” utilizando el siguiente comando.

sudo nano ~/.bashrc

Agregue la siguiente configuración al archivo.

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)

Cuando haya terminado, guarde y cierre el archivo.

A continuación, recargue la sesión actual de su shell utilizando el siguiente comando.

source ~/.bashrc

Por último, ingrese el comando “ sensuctl “ y presione el botón TAB para obtener todas las opciones de comando disponibles. Debería obtener todas las opciones disponibles del comando “ sensuctl “.

sensuctl TAB

Instalando Sensu Agent

Para monitorear el host o máquina utilizando Sensu, debe instalar el paquete Sensu Agent en todos sus hosts. El Sensu Agent está disponible para casi todas las distribuciones de Linux y Windows.

Para instalar Sensu Agent en un sistema Linux, asegúrese de que el repositorio de Sensu esté agregado.

Para sistemas basados en Debian/Ubuntu, ejecute el siguiente comando apt para instalar el paquete Sensu Agent. Ahora comenzará la instalación.

sudo apt install sensu-go-agent

Después de que la instalación haya finalizado, descargue la configuración de Sensu Agent en “ /etc/sensu/agent.yml “. Luego, edite la configuración “ /etc/sensu/agent.yml “ utilizando el siguiente comando.

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

Descomente las siguientes configuraciones. Asegúrese de cambiar el “nombre” aquí al nombre de host del sistema y el “ backend-url “ con la dirección IP del servidor Sensu Backend.

En este ejemplo, agregaremos una máquina Debian con el nombre de host “ linux-host1 “ y disponible en el espacio de nombres “ default “. El servidor Sensu Backend aquí es “ 192.168.5.100 “ con el puerto de API WebSocket predeterminado de Sensu Backend “ 8081 “.

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

Cuando haya terminado, guarde y cierre el archivo.

A continuación, ejecute el siguiente comando para iniciar el servicio Sensu Agent y habilitarlo para que se ejecute automáticamente al inicio del sistema.

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

Ahora ejecute el siguiente comando para verificar y comprobar el servicio Sensu Agent. Debería ver que el Sensu Agent está en ejecución y habilitado.

sudo systemctl status sensu-agent

A continuación, regrese a su navegador web y seleccione el espacio de nombres “ default “. Y debería ver que la nueva entidad host “ linux-host1 “ está disponible.

También puede verificar desde la línea de comandos del terminal utilizando el comando “ sensuctl “ como a continuación. Debería ver que el agente “ linux-host1 “ se ha agregado a la solución de monitoreo Sensu.

sensuctl entity list --format tabular

Monitorear recursos del servidor con verificaciones

El Sensu Agent trabaja para proporcionar una forma para que el nodo agente o servidor objetivo se conecte al Sensu Backend a través de la API WebSocket. Para monitorear recursos del servidor como el uso de CPU, uso de ancho de banda y uso de disco, necesitará configurar “Suscripciones” y crear algunas “Verificaciones” sobre ello. Luego, puede agregar múltiples “Suscripciones” al Sensu Agent o al servidor objetivo.

Para monitorear recursos del servidor utilizando Sensu, necesitará realizar los siguientes pasos:

• Crear Suscripción
• Registrar Activos de Tiempo de Ejecución de Sensu
• Definir comandos de Verificaciones para verificar los recursos del sistema

Antes de continuar, ejecute el siguiente comando “sensuctl” para crear una nueva suscripción llamada “ system “ para la entidad “ linux-host1 “.

sensuctl entity update linux-host1

Se le pedirá que responda las siguientes preguntas:

• Para la “Clase de Entidad”, déjela como “ agente “ y presione ENTER.
• Para las “Suscripciones”, ingrese el nombre de la suscripción “ system “ y presione ENTER.

En Sensu, las “ Verificaciones “ básicamente solo definen un comando que se puede utilizar para monitorear recursos del servidor. Las “ Verificaciones “ son la línea de comandos que puede definir sobre los “Activos” y “Suscripciones” de Sensu para todas sus necesidades de monitoreo. Para crear “ Verificaciones “, configurará activos de tiempo de ejecución dinámicos a través del comando “sensuctl”. Todos los “Activos” de Sensu se pueden encontrar en https://bonsai.sensu.io/.

Ahora ejecute el comando “ sensuctl “ a continuación para crear y registrar “Activos” de Sensu para monitorear el uso de CPU. Debería ver el mensaje de salida como “added asset: sensu/check-cpu-usage:0.2.2”. En este ejemplo, también renombramos el nombre predeterminado del activo a “check-cpu-usage” con la opción “-r”.

sensuctl asset add sensu/check-cpu-usage:0.2.2 -r check-cpu-usage

Ahora ejecute el siguiente comando para verificar la lista de activos de Sensu. Debería ver que el activo “ check-cpu-usage “ está disponible en Sensu.

sensuctl asset list

A continuación, ejecute el siguiente comando para crear el comando de “ Verificaciones “ para monitorear el uso de CPU. En este ejemplo, creará un nuevo comando de verificación llamado “ check_cpu “ que estará disponible en la suscripción “system” y basado en el activo “ check-cpu-usage “. También puede cambiar el parámetro aquí en la opción “–command”. Y debería obtener el mensaje de salida como “ Creado “.

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

Ejecute el siguiente comando “ sensuctl “ para verificar y comprobar el “ check_cpu “. Debería ver los detalles de las “ Verificaciones “ del “ check_cpu “ que acaba de crear.

sensuctl check info check_cpu --format yaml

Ahora puede verificar el monitoreo del evento “ check_cpu “ utilizando el siguiente comando. Debería ver que el monitoreo del uso de CPU para “ linux-host1 “ está configurado y terminado.

sensuctl event list --format tabular

Ahora muévase al panel de administración de Sensu y seleccione el espacio de nombres “ default “. En el menú “ Entidad “, debería ver que el agente “ linux-host1 “ se ha agregado al sistema de monitoreo Sensu.

Ahora, si hace clic en los detalles del agente “ linux-host1 “, verá las “ Verificaciones “ de monitoreo “ check_cpu “ que acaba de crear.

A continuación, puede agregar y crear más “Verificaciones” para su sistema de monitoreo.

Conclusión

Ahora ha realizado la instalación de la solución de monitoreo Sensu en el servidor Debian 11. También ha aprendido el uso básico del comando Sensuctl para gestionar el backend de Sensu. Además, ha monitoreado con éxito la máquina host Linux a través de Sensu Agent y ha configurado “verificaciones” para monitorear su servidor objetivo.