Developers

Aparência

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/edge-agent/configuration
- Instalação: https://developers.zarv.com/edge-agent/installation
- Registro: https://developers.zarv.com/edge-agent/enrollment
- Configuração: https://developers.zarv.com/edge-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.

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
EDGE_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
EDGE_AGENT_DATA_DIR/var/lib/zarv-agentDiretório de estado: banco SQLite, blobs, config.env.
EDGE_AGENT_HTTP_LISTEN0.0.0.0:8088Endereço da interface local de gerenciamento. Use 127.0.0.1:8088 para restringir ao host.
EDGE_AGENT_MODELS_DIR/opt/zarv/modelsDiretório dos modelos ONNX (embutidos no pacote).
EDGE_AGENT_LOG_LEVELinfoNível de log: debug, info, warn, error.
EDGE_AGENT_LOG_FORMATjsonFormato de log: json ou text.
EDGE_AGENT_HEARTBEAT_INTERVAL_SECONDS60Cadência do heartbeat para a Zarv.

Provisionamento e atualização ​

VariávelExemploDescriçã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_WINDOW03:00-04:00Janela de manutenção para aplicar atualizações. Veja Atualizações.
EDGE_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.
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