01UniFi
Em Integrações → UniFi → Conectar UniFi, informe o endereço do controlador (UniFi OS ou UniFi Network 8 ou mais novo) e a chave de API, criada no controlador em Configurações → Integrações, só de leitura. Escolha quem executa: a nuvem evobits, quando o controlador responde pela internet (o endereço precisa resolver para um endereço público), ou uma sonda remota, quando ele só existe na rede do cliente. O Teste confere a versão e conta os sites e os pontos de acesso antes de ativar. Há um controlador por empresa.
Depois da primeira leitura, marque os sites que entram. Cada ponto de acesso dos sites marcados vira um dispositivo, no grupo UniFi e dentro de um grupo com o nome do site, com sensores de estado no controlador, clientes, sinal médio, retentativas em 2,4 e 5 GHz, CPU, memória e uplink. Retentativas acima de 15% ficam em atenção. Do cliente Wi-Fi guardamos só números: contagem, sinal médio, faixas de sinal e a contagem por rede (SSID). Nunca MAC, IP nem nome do aparelho ou da pessoa.
Se o controlador não responde, os sensores ficam sem dado (não "fora") e um aviso chega no sino. Trocar o endereço ou a sonda exige informar a chave de novo: a guardada nunca vai para outro servidor.
02Docker
Em Integrações → Docker → Conectar host, escolha a sonda remota que alcança o host. A API do Docker nunca fica exposta para a nuvem. Duas formas de conexão:
- Socket local: a sonda roda no mesmo host e o socket (/var/run/docker.sock) é montado só para leitura.
- TCP com TLS: outro host da rede, porta 2376, com certificado de cliente (cert.pem e key.pem, e o ca.pem se houver). Sem TLS não conecta. Os arquivos ficam guardados cifrados.
O host vira um dispositivo do tipo servidor (novo, ou um já cadastrado da mesma sonda) e cada container um sensor dele, que mede estado, CPU, memória e reinícios. Rodando e saudável é ok; reiniciando ou com o healthcheck sem responder é atenção; saiu com erro é fora; parado com código 0 (uma tarefa que terminou) fica sem dado e não alerta. Container novo aparece sozinho na leitura seguinte; o removido some depois de 24 horas sem aparecer. A aba Containers do dispositivo mostra a lista. O evobits acompanha até 100 containers por host.
03O que é lido e o que não é
As duas integrações só leem, de uma lista fechada de chamadas conferida antes de cada requisição. No UniFi: informações, sites, aparelhos, estatísticas, contagem de clientes e a lista de estações (para o sinal e o SSID agregados). No Docker: versão, informações, lista e inspeção dos containers e as estatísticas. O evobits nunca reinicia, configura, adota ou desconecta nada no UniFi, e nunca inicia, para, executa comando nem lê variáveis de ambiente ou o comando dos containers. A chave e os certificados ficam cifrados, não são exibidos depois de salvos e não aparecem em logs nem em auditoria.
04Plano e o que some
Cada ponto de acesso do UniFi conta como um dispositivo no plano; o host Docker conta um, e os containers são sensores, que não contam. O limite do plano é conferido antes de criar: o que não couber fica listado como não importado: limite do plano. O que some do controlador ou do host fica marcado, e nada é apagado sozinho. Desmarcar um site pausa os dispositivos dele, e você escolhe se apaga.