Skip to content
Vai integrar o Zarv Agent (on-premise) com ajuda de IA? Copie a instrução que aponta o modelo para esta documentação.
Ver a instrução
Você vai integrar o Zarv Agent (on-premise). Use a documentação oficial como fonte da verdade.

- Página desta integração: https://developers.zarv.com/agent/configuration
- Instalação: https://developers.zarv.com/agent/installation
- Registro: https://developers.zarv.com/agent/enrollment
- Configuração: https://developers.zarv.com/agent/configuration
- Índice da documentação em markdown: https://developers.zarv.com/llms.txt
- Documentação completa em um arquivo: https://developers.zarv.com/llms-full.txt

O agente é um software instalado em máquina do cliente, não uma API que você chama: siga os passos de instalação, registro e configuração na ordem documentada, e use os arquivos e comandos exatamente como aparecem nas páginas.

Antes de escrever qualquer código, leia a página desta integração. Siga exatamente os nomes de campos, endpoints, callbacks e formatos que estiverem documentados — não invente parâmetros nem endpoints, e não deduza comportamento a partir de outras APIs que você conhece. Se algo de que você precisa não estiver na documentação, diga que não está em vez de supor.

Minha tarefa: [ex.: instalar, registrar e configurar o agente no meu ambiente]

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.

Nomes antigos (EDGE_AGENT_*)

Em versões anteriores todas as variáveis começavam com EDGE_AGENT_. Os nomes antigos continuam funcionando por mais uma versão, tanto no ambiente quanto no config.env; a interface de Configurações regrava o arquivo com os nomes novos na próxima vez que você salvar. Atualize seus arquivos e automações para ZARV_AGENT_*.

Após editar, reinicie o serviço:

sh
sudo systemctl restart zarv-agent

Destino do tráfego ​

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

collector.zarv.com.

VariávelPadrãoDescrição
ZARV_AGENT_DEBUGfalseUso interno da Zarv. Mantenha false (ou ausente).

TIP

Não é preciso configurar URLs de upstream manualmente: o agente já envia tudo para collector.zarv.com.

Variáveis de infraestrutura ​

VariávelPadrãoDescrição
ZARV_AGENT_DATA_DIR/var/lib/zarv-agentDiretório de estado: banco SQLite, blobs, config.env.
ZARV_AGENT_HTTP_LISTEN0.0.0.0:8088Endereço da interface local de gerenciamento. Use 127.0.0.1:8088 para restringir ao host.
ZARV_AGENT_MODELS_DIR/opt/zarv/modelsDiretório dos modelos ONNX (embutidos no pacote).
ZARV_AGENT_LOG_LEVELinfoNível de log: debug, info, warn, error.
ZARV_AGENT_LOG_FORMATjsonFormato de log: json ou text.
ZARV_AGENT_HEARTBEAT_INTERVAL_SECONDS60Cadência do heartbeat para a Zarv.
ZARV_AGENT_PING_TARGETS1.1.1.1,1.0.0.1,8.8.8.8,8.8.4.4Servidores usados para saber se o link está de pé (ping, com TCP 443 de reserva) e para medir o tempo de resposta de DNS exibido na interface. Lista separada por vírgulas; só endereços IP entram na medição de DNS.
ZARV_AGENT_SPEEDTEST_TIME04:00Horário local (HH:MM, 24 horas) do teste de velocidade diário. O agente também mede uma vez ao iniciar.
ZARV_AGENT_FRAME_WIDTH_METERS10Largura real, em metros, do campo de visão da câmera na profundidade alvo. Define a conversão para km/h na linha do tempo e nos eventos.
ZARV_AGENT_PPROF_LISTEN(desativado)Endereço do endpoint de profiling (por exemplo 127.0.0.1:6060). Vazio desativa. Restringir ao localhost é responsabilidade de quem opera.

Provisionamento e atualização ​

VariávelExemploDescrição
ZARV_AGENT_ENROLLMENT_TOKEN(chave)Token de acesso do workspace para registro automático no primeiro boot. Veja Registro.
ZARV_AGENT_UPDATE_WINDOW03:00-04:00Janela de manutenção para aplicar atualizações. Veja Atualizações.
ZARV_AGENT_UPDATE_TIMEZONEAmerica/Sao_PauloFuso (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 ​

sh
# Estado persistente.
ZARV_AGENT_DATA_DIR=/var/lib/zarv-agent

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

# Teste de velocidade diário às 4h (horário local do dispositivo).
ZARV_AGENT_SPEEDTEST_TIME=04:00

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