Como Instalar a Solução de Monitoramento Sensu no Debian 11

Sensu é um sistema de monitoramento de infraestrutura e aplicativos 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 aplicativos e serviços, e enviar notificações de alerta para múltiplos destinos com integração de terceiros.

Neste tutorial, você aprenderá como instalar o software de monitoramento Sensu no servidor Debian 11. Você também aprenderá como configurar o Sensu CLI para gerenciar o Sensu. Finalmente, você aprenderá como configurar o monitoramento do servidor com o Sensu através do Sensu Agent.

Pré-requisitos

Para esta implantação do Sensu, você precisará dos seguintes requisitos:

• Um servidor Debian 11 com 4 GB de RAM e 2 CPUs. Este requisito depende muito do seu ambiente de infraestrutura.
• Um usuário não-root com privilégios de sudo/administração.
• Uma máquina Linux será usada como alvo para monitorar.

Adicionando o Repositório Sensu

Para começar com a instalação do Sensu, você precisará adicionar o repositório de pacotes Sensu a todos os seus sistemas, tanto o Sensu Backend quanto os servidores-alvo.

O repositório Sensu está disponível em packagecloud.io, que pode ser adicionado ao seu sistema manualmente ou via o script bash fornecido pelo packagecloud.io.

Antes de adicionar o repositório Sensu, execute o comando apt abaixo para instalar as dependências básicas do pacote. Pressione Y e Enter quando solicitado para confirmar a instalação.

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

Agora execute o seguinte comando para adicionar o repositório Sensu. Este script bash adicionará automaticamente o repositório Sensu e a chave GPG aos seus servidores Debian.

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

Se você quiser adicionar manualmente o repositório Sensu, siga estas etapas:

Crie um diretório de keyring para armazenar a chave GPG do repositório Sensu.

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

Adicione o repositório Sensu usando o seguinte comando. Este repositório é para o Debian 11 Bullseye e a versão estável mais recente do Sensu.

cat <

Agora você pode atualizar e atualizar seu índice de pacotes Debian usando o seguinte comando apt.

sudo apt update

Instalando o Sensu Backend

O coração principal da solução de monitoramento Sensu é um “Sensu Backend”, que fornece uma API HTTP que pode ser usada por um administrador via o comando “sensuctl”. API WebSocket que será usada pelo “Sensu Agent” para monitoramento, e também fornece um painel de controle da interface web para gerenciar o Sensu.

Além disso, o Sensu usa “ etcd “ para armazenar dados, especialmente em grandes implantações de Cluster Sensu.

Para instalar o Sensu Backend, execute o comando apt abaixo. A instalação começará automaticamente.

sudo apt install sensu-go-backend

Após a instalação ser concluída, baixe o exemplo de configuração do backend do Sensu para “/etc/sensu/backend.yml”. Em seguida, edite o arquivo “/etc/sensu/backend.yml” usando o seguinte 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 a seguinte configuração.

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

Quando terminar, salve e feche o arquivo.

Em seguida, execute o seguinte comando systemctl para iniciar o serviço Sensu Backend e habilitá-lo. E o serviço Sensu Backend será executado automaticamente na inicialização do sistema.

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

Verifique e verifique o serviço Sensu backend usando o comando abaixo. Você deve ver que o serviço Sensu Backend está atualmente em execução e habilitado.

sudo systemctl status sensu-backend

Após o Sensu backend estar em execução, você agora inicializará a instalação e configuração do Sensu Backend. Isso pode ser feito usando a linha de comando “sensu-backend init”, que é fornecida pelo pacote Sensu Backend.

Além disso, durante a inicialização do Sensu Backend, você configurará o usuário admin e a senha para sua Solução de Monitoramento Sensu.

Execute o seguinte comando para criar novas variáveis de ambiente do sistema para o usuário admin do Sensu e a senha. Neste exemplo, você criará um novo usuário admin do Sensu “ adminsensu “ com a senha “ SensuRocks “.

export SENSU_BACKEND_CLUSTER_ADMIN_USERNAME=adminsensu  
export SENSU_BACKEND_CLUSTER_ADMIN_PASSWORD=SensuRocks

Agora comece a inicializar o Sensu backend usando o comando abaixo. Você deve ver o processo de inicialização e o Sensu armazenará dados dentro do armazenamento de dados “etcd”.

sensu-backend init

Para verificar e validar sua instalação do Sensu backend, você fará a verificação de saúde do Sensu via o comando curl para a API HTTP do Sensu que está rodando na porta padrão “8080”.

Execute o comando curl abaixo para fazer a verificação de saúde da sua instalação do Sensu backend. Você deve ver a mensagem de saída na tela do seu terminal, como “ health: OK “.

curl http://127.0.0.1:8080/health

Você também pode visitar o painel da interface web do Sensu via a porta TCP “ 3000 “. Abra seu navegador e visite o endereço IP do seu servidor seguido da porta 3000 (ou seja: http://192.168.5.100:3000). E você deve ver a página de login do Sensu.

Insira o usuário admin “ adminsensu “ com a senha “ SensuRocks “. Em seguida, clique em “ SIGN-IN “ para fazer login no painel da interface web do Sensu.

Agora você deve ver o painel de administração web do Sensu.

Instalando o Comando Sensuctl

No Sensu, o administrador pode gerenciar a Solução de Monitoramento Sensu através do painel de administração da interface web do Sensu e via terminal de linha de comando usando “ sensuctl “.

O “ sensuctl “ é uma ferramenta de linha de comando para gerenciar recursos do Sensu. É usado uma API HTTP para se comunicar com o Sensu Backend, o que permite criar, ler e excluir recursos, eventos e entidades.

O “ sensuctl “ pode ser instalado em vários sistemas operacionais, como Linux, Windows e macOS. A função do “sensuctl” é semelhante ao painel da interface web do Sensu, e você pode instalá-lo em sua estação de trabalho local ou no servidor “bastion” seguro da sua infraestrutura.

Para sistemas baseados em Debian/Ubuntu, execute o seguinte comando apt abaixo para instalar a ferramenta de linha de comando “ sensuctl “. A instalação começará automaticamente.

sudo apt install sensu-go-cli

Após a instalação ser concluída, execute o seguinte comando “ sensuctl “ para começar a configurar e conectar à API do servidor Sensu Backend.

sensuctl configure

Você será solicitado com as seguintes configurações:

• Para o método de autenticação, selecione “nome de usuário/senha”.
• Insira a URL da API do Sensu Backend do seu servidor. Neste exemplo, configuraremos “sensuctl” no mesmo servidor, então o host será localhost ou “127.0.0.1”. E a porta padrão para a API HTTP do Sensu é “8080” - http://127.0.0.1:8080.
• Para a configuração do namespace, selecione “default”.
• Para o formato de saída, você pode selecionar o estilo “tabular” ou usar o formato de saída “yaml”.
• Por último, insira o usuário admin e a senha para seu Sensu Backend.

Agora você completou a configuração básica do “ sensuctl “ e se conectou ao servidor API do Sensu Backend.

Execute o seguinte comando “ sensuctl “ abaixo para verificar sua configuração. Você deve ver as configurações detalhadas da API do “ sensuctl “.

sensuctl config view

Além disso, o “sensuctl” também fornece um recurso de autocompletar para seu shell. Se você estiver usando bash, precisará instalar o pacote “bash-completion” e adicionar algumas configurações ao arquivo de configuração “ ~/.bashrc “.

Execute o seguinte comando apt para instalar o pacote “bash-completion”.

sudo apt install bash-completion

Agora edite a configuração “~/.bashrc” usando o seguinte comando.

sudo nano ~/.bashrc

Adicione a seguinte configuração ao arquivo.

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)

Quando terminar, salve e feche o arquivo.

Em seguida, recarregue a sessão atual do seu shell usando o comando abaixo.

source ~/.bashrc

Por último, insira o comando “ sensuctl “ e pressione o botão TAB para obter todas as opções de comando disponíveis. Você deve obter todas as opções disponíveis do comando “ sensuctl “.

sensuctl TAB

Instalando o Sensu Agent

Para monitorar o host ou máquina usando o Sensu, você deve instalar o pacote Sensu Agent em todos os seus hosts. O Sensu Agent está disponível para quase todas as distribuições Linux e Windows.

Para instalar o Sensu Agent em um sistema Linux, certifique-se de que o repositório Sensu está adicionado.

Para sistemas baseados em Debian/Ubuntu, execute o seguinte comando apt para instalar o pacote Sensu Agent. Agora a instalação começará.

sudo apt install sensu-go-agent

Após a instalação ser concluída, baixe a configuração do Sensu Agent para “ /etc/sensu/agent.yml “. Em seguida, edite a configuração “ /etc/sensu/agent.yml “ usando o comando abaixo.

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 as seguintes configurações. Certifique-se de alterar o “nome” aqui para o nome do host do sistema e o “ backend-url “ com o endereço IP do servidor Sensu Backend.

Neste exemplo, adicionaremos uma máquina Debian com o nome do host “ linux-host1 “ e disponível no namespace “ default “. O servidor Sensu Backend aqui é “ 192.168.5.100 “ com a porta padrão da API WebSocket do Sensu Backend “ 8081 “.

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

Quando terminar, salve e feche o arquivo.

Em seguida, execute o seguinte comando para iniciar o serviço Sensu Agent e habilitá-lo para ser executado automaticamente na inicialização do sistema.

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

Agora execute o seguinte comando para verificar e validar o serviço Sensu Agent. Você deve ver que o Sensu Agent está em execução e habilitado.

sudo systemctl status sensu-agent

Em seguida, volte ao seu navegador e selecione o namespace “ default “. E você deve ver o novo host de entidade “ linux-host1 “ disponível.

Você também pode verificar a partir da linha de comando do terminal usando o comando “ sensuctl “ como abaixo. Você deve ver o agente “ linux-host1 “ adicionado à Solução de Monitoramento Sensu.

sensuctl entity list --format tabular

Monitorar Recursos do Servidor com Checks

O Sensu Agent funciona apenas para fornecer uma maneira para o nó agente ou servidor-alvo se conectar ao Sensu Backend através da API WebSocket. Para monitorar recursos do servidor, como uso de CPU, uso de largura de banda e uso de disco, você precisará configurar “Subscription” e criar alguns “Check” em cima disso. Então, você pode adicionar várias “Subscriptions” ao Sensu Agent ou ao servidor-alvo.

Para monitorar recursos do servidor usando o Sensu, você precisará seguir os seguintes passos:

• Criar Subscription
• Registrar Ativos de Tempo de Execução do Sensu
• Definir comandos de Checks para verificar recursos do sistema

Antes de prosseguir, execute o seguinte comando “sensuctl” para criar uma nova assinatura chamada “ system “ para a entidade “ linux-host1 “.

sensuctl entity update linux-host1

Você será solicitado com as seguintes perguntas:

• Para a “Classe da Entidade”, deixe como padrão “ agent “ e pressione ENTER.
• Para as “Subscriptions”, insira o nome da assinatura “ system “ e pressione ENTER.

No Sensu, “ Checks “ basicamente definem um comando que pode ser usado para monitorar recursos do servidor. “ Checks “ é a linha de comando que você pode definir em cima dos “Assets” e “Subscriptions” do Sensu para todas as suas necessidades de monitoramento. Para criar “ Checks “, você configurará ativos dinâmicos de tempo de execução via o comando “sensuctl”. Todos os “Assets” do Sensu podem ser encontrados em https://bonsai.sensu.io/.

Agora execute o comando “ sensuctl “ abaixo para criar e registrar os “Assets” do Sensu para monitorar o uso de CPU. Você deve ver a mensagem de saída como “added asset: sensu/check-cpu-usage:0.2.2”. Neste exemplo, também renomeamos o nome padrão do ativo para “check-cpu-usage” com a opção “-r”.

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

Agora execute o seguinte comando para verificar a lista de ativos do Sensu. Você deve ver o ativo “ check-cpu-usage “ disponível no Sensu.

sensuctl asset list

Em seguida, execute o seguinte comando para criar o comando “ Checks “ para monitorar o uso de CPU. Neste exemplo, você criará um novo comando de verificação chamado “ check_cpu “ que estará disponível na assinatura “system” e baseado no ativo “ check-cpu-usage “. Você também pode alterar o parâmetro aqui na opção “–command”. E você deve obter a mensagem de saída como “ Created “.

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

Execute o seguinte comando “ sensuctl “ para verificar e validar o “ check_cpu “. Você deve ver os detalhes dos “ Checks “ do “ check_cpu “ que você acabou de criar.

sensuctl check info check_cpu --format yaml

Agora você pode verificar o monitoramento do evento “ check_cpu “ usando o comando abaixo. Você deve ver o monitoramento do uso de CPU para “ linux-host1 “ configurado e finalizado.

sensuctl event list --format tabular

Agora vá para o painel de administração do Sensu e selecione o namespace “ default “. No menu “ Entity “, você deve obter o agente “ linux-host1 “ adicionado ao Sistema de Monitoramento Sensu.

Agora, se você clicar nos detalhes do agente “ linux-host1 “, verá o monitoramento de “ Checks “ “ check_cpu “ que você acabou de criar.

Em seguida, você pode adicionar e criar mais “Checks” para seu sistema de monitoramento.

Conclusão

Agora você realizou a instalação da Solução de Monitoramento Sensu no Servidor Debian 11. 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 “checks” para monitorar seu servidor-alvo.