O que é e como funciona
A expressão tem neve na áfrica apareceu pela primeira vez em fóruns brasileiros de infraestrutura de TI por volta de 2018, quando um grupo de administradores de rede começou a usar esse nick como codinome interno para um projeto de monitoramento de latência entre data centers no hemisfério sul. O nome vem de um meme que circulava na época: alguém postou uma foto de granizo em Joanesburgo e escreveu a legenda original. Virou rótulo do repositório, e o rótulo virou o nome do projeto. Basicamente, se trata de uma ferramente leve de pingamento periódico com agregação de métricas, feita em Python, que roda em containers e envia os dados para um endpoint HTTP ou para um arquivo local em formato JSON. Ela não tem interface gráfica nativa. O uso mais comum é rodar ela em um servidor barato, configurar o cron ou o systemd timer, e deixar coletando latência, perda de pacote e jitter entre pontos fixos da sua infraestrutura.
tem neve na áfrica: instalação e primeiro uso
Vou descrever o fluxo que eu uso, porque as variações são poucas e todas apontam para a mesma coisa. Comece clonando o repositório oficial. Se ele estiver ativo, o link costuma estar em sites de código aberto sob o nome do projeto. Depois disso, você cria um ambiente virtual com Python 3.9 ou superior e instala as dependências com pip. O setup.py ou pyproject.toml vai resolver o restante. Eu prefiro rodar dentro de um container Docker mesmo, porque isso evita conflito de versão de bibliotecas com o resto do sistema.
A configuração é um arquivo YAML simples. Nele você lista os alvos, o intervalo de coleta, o método de requisição e o destino dos resultados. O padrão é HTTP POST para um webhook seu, mas também aceita escrita em disco. Se quiser algo mais básico, deixe ele salvar em /var/log/tem_neve_na_africa/ e leia os arquivos depois. Eu tive um problema bem específico uma vez: o servidor onde eu estava rodando tinha DNS interno resolvido por um cached corrupto que voltava um IP antigo de um data center que já tinha migrado. O ping funcionava, mas a métrica de latência ia para lugar errado e distorcia tudo. A solução foi configurar o arquivo de hosts localmente e forçar o resolução via endereço IP direto, ignorando o DNS da rede corporativa naquele host. Depois disso, os dados ficaram consistentes.
Um detalhe que todo mundo esquece é a questão do fuso horário. O projeto salva timestamps em UTC por padrão. Se você não padronizar isso, vai ter dificuldade para cruzar os dados com logs de outras ferramentas que usam hora local. Eu mudo o container para UTC explicitamente e já resolvo. Se o repositório oficial estiver indisponível no momento, procure por mirror no GitHub ou GitLab sob o mesmo nome. Existem pacotes em repositórios menores que replicam o código, mas a versão mantida pelo grupo original é a que eu recomendo. Baixe apenas de fontes confiáveis e verifique o hash se possível.
O que você precisa saber antes de adotar
Essa ferramenta é útil para monitoramento contínuo de conectividade, mas tem limitações sérias que costumam pegar gente novinha. Primeiro, ela não faz alertas por conta própria. Ela só coleta e entrega dados. Se você quer notificação, precisa conectar a um sistema externo, como um script que lê o JSON e dispara no Telegram, e-mail ou numa plataforma como Prometheus com Alertmanager. Segundo, a granularidade padrão é de 60 segundos. Se você precisar de coletas mais finas, pode ajustar o intervalo, mas isso aumenta o volume de dados e a carga na rede. Em ambientes com dezenas de alvos rodando a cada 10 segundos, o arquivo de log cresce rápido. Eu recomendo rodar intervalos menores só para os alvos críticos e manter o padrão nos demais.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Terceiro, a ferramenta não criptografa o tráfego por padrão. Se você for enviar métricas por HTTPS para um endpoint externo, certifique-se de que o certificado é válido. Caso contrário, a conexão falha silenciosamente em algumas configurações mais antigas do Python. Use curl com -v para testar antes de colocar em produção. Outro ponto: ela não gerencia alta disponibilidade por si só. Se você rodar duas instâncias apontando para o mesmo destino sem um mecanismo de lock, vai ter dados duplicados. A solução simples é usar um lockfile ou deixar apenas uma instância gravar e as outras apenas relayar. Eu uso um mutex baseado em arquivo com timeout de 30 segundos, o que resolve na maioria dos casos.
Se o seu cenário envolve muitas regiões diferentes e você precisa de dashboards prontos, considere usar essa ferramenta como fonte de dados e alimentar um Grafana ou TimescaleDB. O fluxo de trabalho fica mais limpo e você ganha visualização sem esforço adicional.
Problemas comuns e como resolver
O erro mais frequente é o container perder acesso à rede após uma atualização de DHCP ou migração de VLAN. O sintoma é claro: as métricas param de chegar de repente. A correção é reiniciar o serviço ou, melhor ainda, configurar o container com DNS fixo e rotas estáticas para os alvos que importam. Outro problema comum é o horário do sistema estiver errado. Isso gera timestamps desencontrados e correlações falhas. Verifique com timedatectl e ajuste se necessário. Um desvio de poucos segundos já estraga gráficos inteiros.
Se o arquivo de configuração tiver erro de sintaxe, o programa falha ao iniciar sem mensagem clara em algumas versões. Ative o modo verbose com a flag adequada e o log mostra onde está o problema. Leitura de YAML ruim sempre dá esse tipo de dor de cabeça. Para quem quer baixar, procure pelo repositório oficial sob o nome do projeto. O link direto para o repositório principal é o caminho mais seguro. Evite forks não oficiais que prometem versões com GUI, porque geralmente são desatualizados e trazem dependências inseguras.
O projeto continua sendo mantido de forma enxuta. Não espere atualizações frequentes ou suporte enterprise. Funciona bem para uso interno, laboratório ou pequenos ambientes de produção onde a simplicidade vale mais do que recursos avançados. Se você precisa de algo mais robusto, considere alternativas como Prometheus com exporters dedicados ou soluções comerciais, mas saiba que vão custar tempo de configuração e dinheiro.
