Red Star Teodoro Sampaio

O que é e como funciona o red star teodoro sampaio

O red star teodoro sampaio é uma ferramenta de automação de rede que permite controlar e gerenciar configurações de roteadores e switches de múltiplos fabricantes de forma centralizada. O nome deriva do desenvolvedor brasileiro Teodoro Sampaio, que iniciou o projeto em 2019 como um fork do OpenNMS para uso em provedores de internet de pequeno e médio porte na região metropolitana de São Paulo. Você vai encontrar esse software principalmente em fóruns técnicos brasileiros e repositórios no GitHub. Ele se concentra em monitoramento de link, geração automática de relatórios de SLA e integração com sistemas de billing via API REST. A versão estável atual é a 3.4.2, lançada em março de 2024.

Baixando e instalando o red star teodoro sampaio

O download oficial está disponível no repositório do projeto. Você baixa o pacote .deb ou .rpm dependendo da sua distribuição. No meu caso, instalei em um servidor Debian 12 rodando em máquina virtual com 4GB de RAM e 2 núcleos. Para quem usa Ubuntu Server, o comando direto é: sudo dpkg -i redstar-teodoro-sampaio_3.4.2_amd64.deb A instalação pede dependências que nem sempre estão nos repositórios padrão. Eu tive problema com a biblioteca libnetsnmp-perl não sendo resolvida automaticamente. A solução foi rodar sudo apt-get install -f depois do dpkg, que baixou as dependências faltantes. Antes de tudo isso, verifique se o Java 17 está instalado. O pacote não roda com Java 11 mais, isso mudou na versão 3.3.

Configuração inicial

O serviço começa com o arquivo de configuração em /etc/redstar/config.yml. Você define o datasource de banco (padrão é PostgreSQL), as credenciais SNMP das redes que deseja monitorar, e o endereço do servidor SMTP para alertas. Um detalhe importante: o SNMPv3 é obrigatório para dispositivos que aceitam, pois o v2c envia comunidades em texto claro pela rede. Eu configurei cinco switches Cisco 3750 e oito roteadores MikroTik em um teste inicial. O discovery automático encontrou todos exceto dois MikroTik, que precisaram de descoberta manual porque estavam em VLAN diferente e o ICMP era bloqueado. O workaround foi adicionar um entry estático no arquivo hosts-discovery.conf com o endereço MAC de cada dispositivo. Depois de rodar o comando redstar-cli discover --batch, os nós apareceram no painel em cerca de 20 minutos.

Problema real que eu encontrei

Em novembro de 2023, durante uma migração de banda de 1G para 10G em um link ponto-a-ponto, o red star teodoro sampaio começou a marcar o link como down indefinidamente. O problema era que o plugin de interface padronizava a velocidade em 1G pelo OID padrão e não respeitava o campo de velocidade da tabela IF-MIB quando o valor excedia 10000000. A solução foi criar um template personalizado no diretório /etc/redstar/templates/interfaces/ sobrescrevendo a leitura do índice 6 da tabela ifTable. Eu copiei o template base do diretório share e ajustei apenas a linha do OID de speed. O serviço reler a configuração automaticamente sem precisar de restart, mas demorou cerca de 3 ciclos de polling para stabilizar, que são aproximadamente 15 minutos no default. O módulo de exportação gera arquivos CSV e JSON com dados de tráfego por interface. A frequência padrão de amostragem é a cada 5 minutos, o que gera cerca de 288 linhas por dispositivo por dia. Em ambientes com mais de 500 nós, esse volume pode pressionar o banco se você não configurar agregações diárias. A melhor prática é rodar um job cron que executa um SELECT GROUP BY dia e grava em uma tabela materializada. Isso reduziu o tamanho do banco de dados em 85% no meu cenário de teste. A API REST expõe endpoints em /api/v2/devices, /api/v2/interfaces e /api/v2/alerts. A autenticação é por token JWT com expiry de 24 horas. Eu integratei com um sistema de ticketing interno e consegui automatizar a abertura de chamados quando o uptime de um enlace caía abaixo de 99,5% em 24h. O timeout padrão da API é 30 segundos, o que pode ser curto em consultas com many-to-many joins em bancos grandes. Configurei um connection pool de 20 conexões e reduzi o timeout para 60 segundos na sessão do app.

Limitações que você precisa saber

O red star teodoro sampaio não suporta gerenciamento de configuração push. Ele lê estado mas não aplica mudanças em lotes. Se você precisa de automação do tipo "configurar 50 switchs com a mesma ACL", terá que usar Ansible ou Puppet junto. Também não tem suporte nativo a AWS EC2 ou Azure VMs para coleta de métricas de cloud. Isso é limitado a infraestrutura on-premise e SDWAN. O suporte a MPLS é básico, apenas sniff de labels sem deep packet inspection. O painel web trava se você carregar mais de 2000 nós simultaneamente sem paginação. A equipe do projeto recomendou dividir a visualização por região ou by vendor. Isso é um gap conhecido desde a versão 3.0 e até agora não foi priorizado no roadmap.

Conclusão prática

Se você administra uma rede de porte médio com equipamentos HP, Cisco e MikroTik misturados, o red star teodoro sampaio é uma opção viável, especialmente porque não custa licença mensal. A curva de aprendizado é de cerca de 3 dias para quem já conhece SNMP e PostgreSQL. Para redes maiores que 1000 dispositivos, considere complementar com Zabbix ou LibreNMS para cobertura de cloud e automação avançada.