Sonda remota

01Quando usar

A sonda da nuvem do evobits coleta tudo o que tem endereço na internet. Precisa de uma sonda remota quando o alvo só existe dentro da sua rede: switches, roteadores, servidores internos, impressoras, câmeras, bancos de dados sem acesso externo.

A sonda remota não abre nenhuma porta para entrada. Ela liga para o evobits, e as leituras e os comandos de coleta trafegam por essa conexão. Se a conexão cair, ela guarda as leituras em disco (até 200 MB por padrão) e envia quando voltar, sem perder o histórico.

02Requisitos

Escolha uma máquina que fique ligada o tempo todo e tenha acesso de rede aos equipamentos que vai medir: uma máquina virtual pequena basta. Não use um computador de uso pessoal que desliga à noite.

03Instalar no Linux

1. 1No painel, Configuração > Sondas > Adicionar sonda. Dê um nome (por exemplo, o do escritório ou do datacenter).
2. 2O painel mostra o token de instalação e os comandos prontos. Ele aparece uma única vez, vale 24 horas e só pode ser usado uma vez. Copie agora.
3. 3Na máquina, rode o comando de instalação como root.

curl -fsSL https://app.evobits.com.br/downloads/sonda/instalar.sh | sudo sh -s -- --token evi_SEU_TOKEN

O instalador detecta a arquitetura, baixa o pacote estável, confere o checksum SHA-256, instala em /opt/evobits-sonda, cria o usuário de sistema evobits-sonda, instala o fping se faltar, registra a sonda com o token e sobe o serviço evobits-sonda (reinicia sozinho em qualquer falha e a cada boot).

Em poucos segundos a sonda aparece como Conectada em Configuração > Sondas.

04Instalar com Docker

O painel mostra também o comando de Docker, já com o endereço e o token da sua conta:

docker run -d --name evobits-sonda --cap-add NET_RAW \
  -e SONDA_URL=https://app.evobits.com.br \
  -e SONDA_TOKEN_INSTALACAO=evi_SEU_TOKEN \
  -v evobits-sonda-dados:/var/lib/evobits-sonda \
  evobitstecnologia/sonda:estavel

Na primeira subida o contêiner se registra sozinho e guarda a identidade no volume evobits-sonda-dados. Reiniciar o contêiner nunca registra de novo, por isso mantenha o volume. O --cap-add NET_RAW é obrigatório: sem ele o ping falha e todas as leituras de ping aparecem como sonda indisponível.

05Usar a sonda

Ao criar ou editar um dispositivo, escolha a sonda no campo Sonda (o padrão é a nuvem evobits). A partir daí todos os sensores do dispositivo são coletados pela sonda remota. Trocar de sonda ou voltar para a nuvem é só editar o dispositivo.

Em Configuração > Sondas você vê o estado de cada sonda e, no menu de cada linha, as ações: Nova instalação (gera outro token para reinstalar), Atualizar, Trocar token, Revogar e Remover.

06Atualizar

No Linux, use Atualizar no menu da sonda em Configuração > Sondas. Quando há versão nova, o botão mostra as duas (por exemplo, 1.0.1 para 1.0.2). A sonda baixa o pacote, confere o checksum, troca a versão e reinicia.

Se a versão nova não conseguir subir ou não conseguir conectar ao evobits em 5 minutos, a sonda volta sozinha para a versão anterior e não tenta a mesma de novo por conta própria. Você pode pedir Atualizar de novo quando quiser.

Com Docker não há Atualizar: para atualizar, baixe a imagem nova e recrie o contêiner mantendo o volume.

docker pull evobitstecnologia/sonda:estavel
docker rm -f evobits-sonda
docker run -d --name evobits-sonda --cap-add NET_RAW \
  -e SONDA_URL=https://app.evobits.com.br \
  -v evobits-sonda-dados:/var/lib/evobits-sonda \
  evobitstecnologia/sonda:estavel

Como a sonda já está registrada no volume, o token de instalação não é necessário na recriação.

07Requisitos de rede

Para falar com o evobits a sonda só precisa de saída na porta 443 (HTTPS e WebSocket seguro) para app.evobits.com.br. Não há porta de entrada, nem redirecionamento no roteador, nem IP fixo. Se existe proxy ou firewall com lista de destinos, libere esse nome.

08Diagnóstico

No Linux:

sudo systemctl status evobits-sonda
sudo journalctl -u evobits-sonda -n 100 --no-pager
curl -sI https://app.evobits.com.br | head -n 1

Com Docker:

docker ps --filter name=evobits-sonda
docker logs --tail 100 evobits-sonda

Enquanto uma sonda está desconectada, os dispositivos dela aparecem como Sonda offline, e não como equipamento fora do ar. Se o ping mostra sonda indisponível em todos os dispositivos, falta a capacidade NET_RAW (veja o passo de Docker).

09Remover

Para tirar a sonda de uma máquina Linux:

curl -fsSL https://app.evobits.com.br/downloads/sonda/instalar.sh | sudo sh -s -- --desinstalar

Isso apaga o serviço, o usuário e os diretórios da máquina, mas não o cadastro no painel. Em Configuração > Sondas, revogue a sonda para invalidar a identidade e, sem dispositivos ligados a ela, remova a linha. Com Docker, apague o contêiner e o volume.