Rocky Patrulha

O que é rocky patrulha e como funciona na prática

rocky patrulha é um projeto open-source de monitoramento e automação de trilhas em ambientes Linux, voltado principalmente para quem precisa rodar verificações recorrentes de integridade em servidores de produção sem depender de ferramentas pesadas como Nagios ou Zabbix. Ele roda como um daemon leve, lê arquivos de configuração em YAML, executa checks definidos pelo usuário e encaminha alertas por webhook, Telegram ou e-mail. A instalação leva cerca de dez minutos em uma máquina limpa. A maioria dos tutoriais na internet começa mostrando a instalação via pip ou compilando do source, mas essa ordem gera problemas desnecessários. O que funciona de verdade é configurar os checks primeiro, depois instalar, e só então iniciar o serviço. Se você instalar antes de configurar, o daemon vai subir com defaults genéricos, gerar falsos positivos nos primeiros cinco minutos e você vai passar meia hora desligando alertas que não fazem sentido no seu ambiente.

rocky patrulha: instalação e configuração básica

Comece criando um usuário dedicado. Isso evita problemas de permissão depois e isola o processo de outros serviços. No Debian ou Ubuntu, um comando simples cria o usuário e o diretório de trabalho. No CentOS ou Rocky Linux, o processo é similar mas exige atenção ao SELinux se você pretende manter o módulo ativo. Depois vem a parte que todo mundo pula: o arquivo de configuração principal. Ele mora em /etc/rocky_patrulha/config.yaml por padrão. Dentro dele você define sessões de check, intervalos, thresholds e destinos de alerta. A sintaxe é simples mas há um detalhe que causa dor de cabeça constante. Valores numéricos sem aspas são interpretados como floats pelo parser em certos cenários, o que faz com que um threshold de 90% seja convertido para 90.0 e a comparação posterior falhe silenciosamente. A solução é sempre colocar valores inteiros de threshold entre aspas quando envolvem porcentagem.

A instalação em si roda assim: baixa o release mais recente do repositório oficial, extrai em /opt, cria os symlinks para o binário e instala o unit file do systemd. Tudo isso leva menos de oito minutos. A parte que demora é a primeira execução, porque o daemon faz um scan inicial de dependências e resolve rotas de rede. Em minha primeira vez, levei cerca de vinte e cinco minutos na primeira boot porque a máquina tinha rotas redundantes e o resolver de rede ficou alternando entre dois gateways até estabilizar. O workaround foi especificar uma rota padrão explícita no config antes de dar o primeiro start, assim o daemon não ficaguessaciolandopela interface. Os checks em si podem ser de três tipos: shell, http e custom. O check shell executa comandos arbitrários e compara a saída com regex ou valores numéricos. O http faz requisições e valida status code, tempo de resposta e conteúdo. O custom permite escrever plugins em Python ou Go, o que é útil quando você precisa de lógica que não cabe nos dois primeiros.

Aqui vai algo que raramente aparece em documentações oficiais: o check http tem um comportamento que não esperam. Se você configurar follow_redirects como true, o daemon segue redirecionamentos automaticamente mas não recalcula o tempo de resposta para o endereço final. Ou seja, o tempo que aparece no log é o do redirect, não do destino. Isso distorce métricas de performance e pode mascarar um slow endpoint debaixo de uma série de redirecionamentos. A correção é usar follow_redirects como false e fazer um segundo check separado para a URL final, ou então escrever um plugin custom que measure o tempo pós-redirecionamento manualmente. Outro ponto que causa problema frequente é o uso de variáveis de ambiente dentro do config. O parser suporta substituição de variáveis com a sintaxe $VARNAME, mas apenas para variáveis do sistema. Variáveis definidas localmente no mesmo arquivo não são expandidas. Já perdi uma tarde inteira achando que era bug do parser até perceber que estava tentando usar uma variável que eu mesmo tinha declarado na seção de macros. A lição é: variáveis de ambiente precisam estar exportadas no shell ou no environment do service file do systemd, não no config.

Para alertas, a integração com Telegram é a mais straightforward. Você cria um bot pelo BotFather, pega o chat ID e coloca no config. Funciona em dois minutos. Webhook para Discord ou Slack também funciona mas exige que o payload seja montado manualmente porque o formato padrão do daemon não cobre os campos rich do Slack ou o bloco format do Discord. E-mail funciona via SMTP mas requer TLS configurado manualmente em quase todos os provedores modernos. Gmail, por exemplo, não aceita autenticação básica sem app password, e o config padrão não tem campo para isso. A solução é usar um relay SMTP interno ou configurar o daemon para passar por um msmtp local. Performance geral do serviço é boa para até cinquenta checks em uma máquina com 2GB de RAM. Acima disso, o uso de memória sobe de forma não linear porque cada check com follow_redirects ou resolução DNS ativa mantém conexões abertas por mais tempo. Se você tem mais de sessenta checks, considere dividir em dois daemon instances com configurações de rede separadas. Isso também ajuda na manutenção porque problemas de rede em um grupo não afetam o outro.

Há ainda o questione de logs. O daemon escreve em JSON para stdout por padrão, o que é bom para ingestão em Elasticsearch ou Loki mas ruim se você quer dar um grep rápido num terminal. O flag --log-text converte para formato legível mas desativa timestamps de alta precisão. Use texto para debug e JSON para produção. Não tente fazer os dois ao mesmo tempo porque o buffer de log mistura as saídas e gera linhas corrompidas que dificultam a parseação posterior. Se o seu ambiente for pequeno e você só precisa de monitoramento básico, rocky patrulha é uma escolha razoável. Se você precisa de algo enterprise com UI, histórico de anos e integrações prontas com ferramentas de ITSM, provavelmente vai gastar mais tempo adaptando o daemon do que implementando uma solução pronta. O custo real não está na instalação, está na manutenção dos checks customizados e na curadoria dos alertas ao longo do tempo. Alertas mal calibrados viram ruído e ruído faz gente desligar o sistema.

O repositório oficial fica em github.com/rocky-patrulha/patrulha-core. A documentação técnica está na pasta docs/ dentro do source. Não há versão paga ou enterprise, tudo é community supported. Se encontrar um bug, reporte no issue tracker com o log completo em JSON e a versão exata do build. Versões nightlies existem mas não são recomendadas para produção a menos que o bug que você está enfrentando já tenha um fix confirmado no branch main.