Como Instalar a Solução de Monitoramento Sensu no Ubuntu 22.04

Sensu é um sistema de monitoramento de infraestrutura e aplicações de código aberto projetado para monitoramento de contêineres e não contêineres e infraestrutura multi-nuvem.

Sensu é uma solução de monitoramento escalável, segura e integrada para sua tecnologia e infraestrutura de servidores. Pode ser usado para monitorar servidores, saúde de aplicações e serviços, e enviar notificações de alerta para múltiplos destinos com integração de terceiros.

Neste guia, você configurará a Solução de Monitoramento Sensu em um servidor Ubuntu 22.04. Você também instalará e configurará o cliente sensu-go que será usado para gerenciar o Sensu. E, por último, você instalará o Sensu Agent no host de destino para monitorar e configurar verificações do Sensu para monitoramento básico do sistema.

Pré-requisitos

Para completar este guia, você precisará dos seguintes requisitos:

• Dois servidores Ubuntu 22.04 - O primeiro servidor será usado para instalar a Solução de Monitoramento Sensu, e o segundo servidor é o servidor de destino a ser monitorado.
• Um usuário não-root com privilégios de administrador sudo/root.

Abaixo estão os detalhes do servidor que serão usados para este guia:

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

Agora vamos pular para a instalação.

Adicionando o Repositório Sensu

Sensu é uma solução de monitoramento segura e escalável que pode ser instalada em múltiplos sistemas operacionais, como Linux, macOS, Windows e FreeBSD. O Sensu fornece seu próprio repositório, especialmente para distribuições baseadas em RHEL e Debian. Os pacotes sensu são entregues via o repositório packagecloud.io.

Para este primeiro passo, você configurará o repositório Sensu em ambos os sistemas, o servidor Sensu e o sistema de monitoramento de destino.

Para começar, execute o comando apt abaixo para atualizar o índice de pacotes e instalar alguns pacotes básicos em seu sistema.

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

Quando solicitado, digite y para confirmar e pressione ENTER.

Em seguida, execute o comando abaixo para adicionar o repositório estável do Sensu aos seus sistemas. Isso fará o download do script bash que configurará e configurará automaticamente o repositório Sensu para seus sistemas Ubuntu.

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

Você receberá uma saída semelhante a esta.

Após o repositório sensu ser adicionado, você estará pronto para iniciar a instalação do Sensu Go no Servidor Sensu e do Sensu Agent no Monitoramento de Destino.

Instalando e Configurando o Sensu Go Backend

O Sensu Go Backend é o principal componente da Plataforma de Monitoramento Sensu. Ele fornece um painel de administração web e uma API HTTP que permite gerenciar o Sensu via linha de comando, e também fornece os WebSockets que serão usados para máquinas/agentes de destino se conectarem.

Antes de começar, certifique-se de que você execute todos os seguintes comandos no Servidor Sensu. Neste exemplo, o hostname do servidor é ‘sensugo-server’.

Para começar, execute o comando apt abaixo para instalar o backend do Sensu Go.

sudo apt install sensu-go-backend

Agora a instalação deve começar.

Após o Sensu Go Backend ser instalado, faça o download da configuração de exemplo via o comando wget abaixo para o ‘/etc/sensu/backend.yml’. Em seguida, abra o arquivo usando o comando do 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

Descomente as seguintes linhas no arquivo.

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

Salve o arquivo e saia do editor quando terminar.

Em seguida, execute o comando utilitário systemctl abaixo para iniciar e habilitar o serviço Sensu Go Backend ‘ sensu-backend ‘.

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

O ‘ sensu-backend ‘ deve agora estar em execução e habilitado. Além disso, o serviço será executado automaticamente na inicialização.

Verifique o status do serviço ‘sensu-backend’ via o seguinte comando systemctl.

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

Você receberá uma saída semelhante a esta - O serviço ‘ sensu-backend ‘ está habilitado e agora está em execução.

Com o Sensu Go Backend em execução, você irá inicializar o Sensu Go Backend configurando a senha do administrador e gerando algumas configurações.

Para inicializar a instalação do Sensu Go Backend, execute o comando abaixo para criar novas variáveis de ambiente que serão usadas para configurar o usuário e a senha do administrador do Sensu.

Este exemplo usará ‘ sensuadmin ‘ como o usuário e ‘ sensupassword ‘ como a senha. Portanto, certifique-se de alterar o usuário e a senha do administrador.

export SENSU_BACKEND_CLUSTER_ADMIN_USERNAME=sensuadmin  
export SENSU_BACKEND_CLUSTER_ADMIN_PASSWORD=sensupassword

Agora execute o seguinte comando ‘sensu-backend’ para inicializar a instalação do Sensu Go Backend.

sensu-backend init

Você receberá uma saída semelhante a esta - O Sensu Go Backend agora está inicializado e está rodando na porta padrão ‘ 3000 ‘.

Agora abra o navegador web e visite o endereço IP do servidor seguido da porta TCP 3000 (ou seja: http://192.168.5.100:3000). E você deve obter a página de login do Sensu.

Faça login com o nome de usuário e a senha durante o processo de inicialização e clique em ‘ SIGN-IN ‘.

Após fazer login, você deve ver o painel de administração do Sensu. Você agora terminou a instalação do Sensu Go Backend.

Além disso, você também pode verificar o status de saúde do seu servidor Sensu Go via a API do Sensu.

Instale o utilitário de pacote ‘ jq ‘ em seu sistema via o comando apt abaixo.

sudo apt install jq -y

Agora execute o comando curl abaixo para acessar a API do Servidor Sensu que roda na porta padrão ‘ 8080 ‘. Este comando verificará o status de saúde do seu servidor Sensu, então a saída será formatada como json, o que torna a saída legível.

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

Saída - Na saída a seguir, ‘Healthy: true’ e sem erro.

Instalando e Configurando sensuctl

Com o Sensu Go Backend instalado e configurado, você então instalará o Cliente Sensu Go no Servidor Sensu. O Cliente Sensu Go fornece um utilitário de linha de comando ‘sensuctl’ que permite gerenciar o Sensu via o terminal do servidor.

A forma como ‘sensuctl’ funciona é comunicando-se com o Servidor Sensu via API para criar, ler, atualizar e excluir recursos, eventos e entidades no Servidor Sensu.

Execute o comando apt abaixo para instalar o Cliente Sensu Go. A instalação deve agora começar.

sudo apt install sensu-go-cli

Após ‘ sensu-go-cli’ ser instalado, abra o arquivo ‘~ /.bashrc ‘ usando o comando do editor nano abaixo.

nano ~/.bashrc

Adicione as seguintes linhas ao final do arquivo. Esta configuração habilitará a autocompletação para o 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)

Salve o arquivo e saia quando terminar.

Em seguida, recarregue sua sessão atual recarregando o arquivo ‘ ~/.bashrc ‘. Então verifique usando o comando ‘sensuctl’.

source ~/.bashrc  
sensuctl TAB

Se você pressionar o botão TAB após o comando ‘ sensuctl ‘, você deve obter a lista de opções para esse comando.

Com o Cliente Sensu Go instalado, você agora começará a configurar a conexão com o Servidor Sensu.

Execute o comando ‘ sensuctl configure ‘ abaixo para adicionar o Servidor Sensu.

sudo sensuctl configure

Agora você será questionado sobre algumas configurações:

• Método de autenticação? username/password
• URL da API do Sensu Backend? A API do Sensu está rodando por padrão em http://127.0.0.1:8080
• Namespace? default
• Formato de saída preferido? Selecione o formato de saída que você deseja - este exemplo é tabular.
• Nome de usuário? usuário admin para sensu
• Senha? senha para o usuário admin do sensu

Após a configuração do ‘ sensuctl ‘ ser concluída, execute o comando abaixo para verificar os detalhes da configuração atual.

sudo sensuctl config view

Você receberá uma saída semelhante a esta - O Cliente Sensu Go agora está conectado ao Servidor Sensu via API HTTP que roda por padrão em localhost:8080.

Neste ponto, você terminou a configuração básica do Sensu Go Backend e do Cliente Sensu Go. No próximo passo, você monitorará a máquina de destino via o Sensu Agent.

Instalando o Sensu Agent na Máquina de Destino

O Sensu Agent é um cliente leve que roda em máquinas de destino que você deseja monitorar. Ele funciona comunicando-se via WebSockets com o Servidor Sensu com recursos como auto-registro, envio de mensagens de keepalive e execução de verificações de monitoramento.

Antes de começar, certifique-se de que o repositório Sensu foi adicionado. Além disso, certifique-se de que você execute os comandos abaixo na máquina de destino, este exemplo usa o servidor com hostname ‘ machine1 ‘.

Execute o comando apt abaixo para instalar o Sensu Agent em seu sistema. A instalação deve prosseguir automaticamente.

sudo apt install sensu-go-agent

Após o Sensu Agent ser instalado, faça o download do arquivo de configuração do Sensu Agent para ‘ /etc/sensu/agent.yml ‘ via o comando curl. Em seguida, abra o arquivo ‘/etc/sensu/agent.yml ‘ usando o comando do 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

Altere a configuração padrão com as seguintes linhas. Certifique-se de alterar o ‘name’ para o hostname da máquina de destino, e a URL do backend é o endereço WebSocket para o Servidor Sensu que roda na porta padrão ‘ 8081 ‘.

Neste exemplo, o hostname da máquina de destino é ‘ machine1 ‘ e o endereço IP do Servidor Sensu é ‘ 192.168.5.100 ‘.

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

Salve o arquivo e saia do editor quando terminar.

Em seguida, execute o comando utilitário systemctl abaixo para iniciar e habilitar o serviço ‘ sensu-agent ‘. O serviço deve agora estar em execução e habilitado, o que significa que o serviço será iniciado automaticamente na inicialização.

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

Agora verifique o ‘sensu-agent’ serviço via o comando abaixo para garantir que o serviço está em execução.

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

Você receberá uma saída como a seguinte - O serviço ‘ sensu-agent ‘ está habilitado e o status atual é em execução.

Por último, volte ao terminal do Servidor Sensu e execute o comando ‘sensuctl’ abaixo para verificar se a máquina de destino ‘machine1’ está disponível no Servidor Sensu.

sensuctl entity list --format tabular

Você receberá uma saída semelhante a esta - A máquina de destino ‘ machine1 ‘ foi adicionada ao Servidor Sensu via o Sensu Agent.

Agora que a máquina de destino ‘machine1’ foi adicionada ao Servidor Sensu, você irá configurar verificações para monitoramento básico do sistema.

Configurando Verificações para Monitoramento do Sistema

No Sensu, as verificações são onde você define o que deseja monitorar. Exemplos de verificações incluem monitoramento de uso de CPU, uso de memória, uso de disco e muito mais. As verificações são parte dos Assets, que são tempos de execução dinâmicos que são compartilháveis e reutilizáveis.

Neste passo, você criará novas verificações para monitorar uso de CPU, uso de memória e uso de disco. Essas verificações serão usadas para monitorar a máquina de destino ‘ machine1 ‘.

Para começar, execute o comando sensuctl abaixo para atualizar a entidade ou máquina de destino ‘ machine1 ‘.

sensuctl entity update machine1

A classe deve ser ‘ agent ‘ e a assinatura deve ser ‘ System ‘.

Agora execute o comando utilitário sensuctl abaixo para adicionar assets ao seu Servidor Sensu. Você pode obter outro asset do Sensu no hub de assets do 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

Você receberá uma saída semelhante a esta.

Adicionando asset de tempo de execução ‘ sensu/check-cpu-usage ‘

Adicionando asset de tempo de execução ‘ sensu/check-memory-usage ‘.

Adicionando asset de tempo de execução ‘ sensu/check-disk-usage ‘.

Em seguida, verifique a lista de assets no Servidor Sensu via o comando sensuctl abaixo. Você deve ver esses assets de tempo de execução adicionados ao Servidor Sensu.

sensuctl asset list

Com os assets do Sensu adicionados, você então criará verificações com base nos assets que você adicionou.

Execute o comando abaixo para criar uma verificação ‘check_cpu’ com a assinatura como ‘ system ‘ e usar o asset de tempo de execução ‘ sensu/check-cpu-usage ‘. Você pode ajustar as configurações na opção ‘ command ‘.

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

Execute o comando abaixo para criar uma verificação ‘ check_mem ‘ com a assinatura como ‘system’ e usar o asset de tempo de execução ‘ sensu/check-memory-usage ‘. Você pode ajustar as configurações na opção ‘ command ‘.

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

Execute o comando abaixo para criar uma verificação ‘check_disk’ com a assinatura como ‘ system ‘ e usar o asset de tempo de execução ‘sensu/check-disk-usage ‘. Você pode ajustar as configurações na opção ‘ 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

Agora verifique a lista de verificações no Servidor Sensu via o comando ‘sensuctl’ abaixo. Você verá as três verificações que você criou, check_cpu, check_mem e check_disk.

sensuctl check list

Agora volte ao navegador web e visite o painel de administração do Sensu. Certifique-se de que você está no namespace ‘ default ‘, então clique em ‘ Entities ‘.

Você deve ver que a máquina de destino ‘ machine1 ‘ foi adicionada com o status OK.

Clique em ‘ machine1 ‘ para obter detalhes de monitoramento. E você deve obter a página como a seguinte - todas as verificações que você criou estão executadas e em execução.

Você agora criou e configurou assets e verificações para monitoramento do sistema no Servidor Sensu.

Conclusão

Você agora instalou a Solução de Monitoramento Sensu no Servidor Ubuntu 22.04. Você também aprendeu o uso básico do comando Sensuctl para gerenciar o backend do Sensu. Além disso, você monitorou com sucesso a máquina host Linux via o Sensu Agent e configurou “assets” e “verificações” para monitorar servidores de destino.