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.
👉 Clique no botão abaixo para saber mais sobre o assunto!
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.
Integração com sistemas de billing
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.
