Configuração

A maior parte da configuração operacional do agente (câmeras, tuning de inferência, política de atualização) é gerenciada centralmente pela Zarv — você não precisa mexer no dispositivo. O arquivo local serve apenas para parâmetros de infraestrutura e para apontar/provisionar o agente.

Onde fica

Variáveis de ambiente do serviço ficam em /etc/default/zarv-agent (um conffile: suas edições sobrevivem a upgrades). O agente também lê <DataDir>/config.env, escrito pela própria interface de Configurações; valores ali têm precedência sobre o arquivo de defaults.

Após editar, reinicie o serviço:

sudo systemctl restart zarv-agent

Ambiente (produção / staging)

Toda a saída do agente — registro, configuração, heartbeat, eventos, telemetria e atualizações (OTA) — vai para um único host:

• Produção: collector.zarv.com (padrão).
• Staging (dev): collector.zarv.dev, ativado com EDGE_AGENT_DEBUG=true.

Variável	Padrão	Descrição
EDGE_AGENT_DEBUG	false	true envia todo o tráfego para o ambiente de staging (collector.zarv.dev). Apenas para rigs de laboratório/teste.

TIP

Não é preciso configurar URLs de upstream manualmente: o destino é derivado de EDGE_AGENT_DEBUG. Deixe false (ou ausente) em produção.

Variáveis de infraestrutura

Variável	Padrão	Descrição
EDGE_AGENT_DATA_DIR	/var/lib/zarv-agent	Diretório de estado: banco SQLite, blobs, config.env.
EDGE_AGENT_HTTP_LISTEN	0.0.0.0:8088	Endereço da interface local de gerenciamento. Use 127.0.0.1:8088 para restringir ao host.
EDGE_AGENT_MODELS_DIR	/opt/zarv/models	Diretório dos modelos ONNX (embutidos no pacote).
EDGE_AGENT_LOG_LEVEL	info	Nível de log: debug, info, warn, error.
EDGE_AGENT_LOG_FORMAT	json	Formato de log: json ou text.
EDGE_AGENT_HEARTBEAT_INTERVAL_SECONDS	60	Cadência do heartbeat para a Zarv.

Provisionamento e atualização

Variável	Exemplo	Descrição
EDGE_AGENT_ENROLLMENT_TOKEN	(chave)	Chave de enrollment para registro automático no primeiro boot. Consumida e removida em seguida. Veja Registro.
EDGE_AGENT_UPDATE_WINDOW	03:00-04:00	Janela de manutenção para aplicar atualizações. Veja Atualizações.
EDGE_AGENT_UPDATE_TIMEZONE	America/Sao_Paulo	Fuso (IANA) da janela. Vazio = hora local do dispositivo.

WARNING

Parâmetros de inferência, tuning e throttling não devem ser definidos localmente: eles são geridos pela Zarv para preservar qualidade de detecção e volume de eventos. A interface local de Configurações expõe apenas os ajustes de infraestrutura acima.

Exemplo de /etc/default/zarv-agent

# Estado persistente.
EDGE_AGENT_DATA_DIR=/var/lib/zarv-agent

# Interface de gerenciamento (restrita ao host).
EDGE_AGENT_HTTP_LISTEN=127.0.0.1:8088

# Janela de manutenção para atualizações (madrugada, horário de São Paulo).
EDGE_AGENT_UPDATE_WINDOW=03:00-04:00
EDGE_AGENT_UPDATE_TIMEZONE=America/Sao_Paulo