Pular para conteúdo

Coletor remoto

Para sites e filiais atrás de firewall, o coletor roda em um host Linux local e envia tudo por HTTPS (443) à plataforma.

Pré-requisitos

  • Host Linux com Docker (2 vCPU / 2 GB para até ~10 dispositivos).
  • Saída 443 até o endereço público da plataforma (QV_PUBLIC_URL / general.base_url).
  • Acesso às portas de gerência dos dispositivos do site (Portas).
  • Token do coletor: Administração › Coletores › Registrar coletor (transporte HTTPS).

Opção 1 — comando Docker

Copie o comando exibido ao registrar o coletor:

docker run -d --name quantix-collector --restart unless-stopped \
  -e QV_API_URL=https://quantix.empresa.local -e QV_COLLECTOR_TOKEN=qvc_... \
  -e QV_COLLECTOR_NAME=coletor-sp -e QV_COLLECTOR_TRANSPORT=https \
  quantix/quantix-vision-backend:8.3.0 collector

Com CA corporativa: monte o certificado e defina SSL_CERT_FILE (-v /etc/pki/ca.crt:/etc/quantix/ca.crt:ro -e SSL_CERT_FILE=/etc/quantix/ca.crt).

Opção 2 — Ansible

# host_vars/coletor-sp.empresa.local/vault.yml: vault_collector_token_sp: qvc_...
cd deploy/ansible
ansible-playbook collector.yml --ask-vault-pass --limit coletor-sp.empresa.local

Gera /opt/quantix-collector/.env e um compose com container somente leitura, cap_drop: ALL, tmpfs e limites de CPU/memória. collector_ca_bundle_src monta a CA.

Opção 3 — assistente “Instalar em host remoto” (recomendada)

Em Administração › Coletores, clique em Instalar em host remoto (ou na ação de mesmo nome na linha do coletor). O assistente registra ou reaproveita o coletor, pede host/IP, usuário SSH e a credencial SSH (tipo chave ou usuário/senha) e dispara a implantação via SSH, acompanhando o progresso em tempo real — tudo pela interface, sem docker run manual no host remoto. Por baixo, ele cria um job do runbook Implantar coletor remoto (abaixo). Detalhes em Manual do administrador › Coletores.

Opção 4 — runbook “Implantar coletor remoto” (Automação)

Em Automação, execute Implantar coletor remoto informando host/IP, usuário SSH, credencial SSH (do tipo chave ou senha), o coletor registrado e o transporte. O runbook instala o Docker (Debian/Ubuntu ou RHEL), remove um coletor anterior e sobe o container. Um novo token é gerado para o coletor e entregue somente ao host de destino. Exige aprovação (risco médio).

Verificação

Em até 30 s o coletor aparece Online com versão e host. Atribua os dispositivos do site a ele. Problemas: Troubleshooting › Coleta.