Referência de comandos

Todos os comandos do Sentrya Connector, do systemd e do gerenciador de pacotes, com o que cada um faz. Rode-os como root (sudo) na máquina do Connector.

Ajuda na própria máquina. sentrya-connector help lista os comandos e sentrya-connector COMANDO -h mostra todas as opções de um comando.

O dia a dia

sudo sentrya-connector status
Situação atual: conectado ou não, conector e empresa, latência, cada Zabbix (versão, hosts, ACK), os tokens de pessoa guardados (só quantos e quando vencem), chamadas feitas, política e última atualização, último erro.
sudo sentrya-connector logs
Últimos registros do serviço (conexão com o Sentrya, erros, atualizações), legíveis. -f acompanha em tempo real; -n 200 mostra mais linhas; --since "1 hour ago" filtra por tempo.
sudo sentrya-connector logs --audit
A auditoria local: cada chamada que o Sentrya pediu ao seu Zabbix, com método, tempo, tamanho e resultado. Aceita -f e -n.
sudo sentrya-connector doctor
Diagnóstico completo: DNS, saída 443, proxy, TLS, relógio, identidade, conexão com o Sentrya, cada Zabbix e as permissões. --offline pula a rede; --json para automação.
sentrya-connector version
Versão instalada, versão do protocolo e chaves embutidas.

Configuração

sudo sentrya-connector setup
O assistente completo (conexão, registro, Zabbix, atualizações e serviço). Rode de novo quando quiser revisar a configuração ou adicionar um Zabbix.
sudo sentrya-connector zabbix add
Adiciona um Zabbix, testando endereço, credencial e permissões antes de gravar.
sudo sentrya-connector zabbix list
Lista os Zabbix configurados.
sudo sentrya-connector zabbix test [apelido]
Testa um Zabbix (ou todos): alcance, credencial e cada método.
sudo sentrya-connector zabbix remove APELIDO
Tira um Zabbix do Connector. No Sentrya, esse Zabbix passa a aparecer como inalcançável.
sudo systemctl reload sentrya-connector
Relê o arquivo de configuração depois de editá-lo à mão.

Opções úteis do setup e do zabbix add: --zabbix-url, --zabbix-token-file, --zabbix-user, --zabbix-password-file, --ref, --no-ack, --no-history, --no-user-tokens (sem tokens de pessoa), --zabbix-ca-file (Zabbix com certificado próprio) e --non-interactive. O setup também aceita --token-file (o token de instalação num arquivo, para automação), --proxy, --update-policy, --update-window, --channel, --no-start e --force-enroll. Sem token por opção, o setup pede o token na tela, com a digitação mascarada: nunca passe o token na linha de comando, onde ele fica no histórico e na lista de processos.

Atualização

sudo sentrya-connector update --check
Só consulta: mostra a versão instalada e a indicada pelo Sentrya.
sudo sentrya-connector update
Instala agora a versão indicada pelo Sentrya (confere a assinatura e a saúde do serviço; volta sozinho se falhar).
sudo sentrya-connector update --version X.Y.Z
Instala uma versão assinada específica, inclusive uma anterior, até o piso de segurança da versão instalada. Uma versão abaixo da mínima que vale no Sentrya não conecta, e o atualizador volta sozinho para a anterior.

Detalhes em Atualizações.

Registro e remoção

sudo sentrya-connector enroll --token-file ARQUIVO
Só registra a máquina (sem configurar o Zabbix), com o token de instalação lido do arquivo. Para registrar respondendo na tela, use o setup.
sudo sentrya-connector setup --force-enroll
Registra a máquina de novo com chave nova (o assistente pede o token novo); o conector anterior é revogado e a coleta dos Zabbix desta máquina para até eles serem movidos para o conector novo (o mesmo servidor continua, com ouvintes e histórico). Leia Desinstalar, registrar de novo e trocar de máquina antes.
sudo sentrya-connector deregister
Revoga este conector no Sentrya e apaga a identidade local (pede confirmação; --yes não pergunta).
sudo apt purge sentrya-connector / sudo dnf remove sentrya-connector
Desinstala e apaga tudo. Veja Desinstalar.

Suporte

sudo sentrya-connector support-bundle
Gera um .tar.gz para o suporte com versão, estado, diagnóstico, registros do journal, status do systemd e a configuração — com tokens, senhas e a chave do conector removidos. -o ARQUIVO escolhe o nome; --offline não testa a rede.

Serviço (systemd)

sudo systemctl status sentrya-connector
Estado do serviço. A linha Status resume a conexão (ex.: "conectado como NOC-01 · Sua Empresa · 1 Zabbix (7.0.31)").
sudo systemctl restart sentrya-connector
Reinicia o serviço.
sudo systemctl stop sentrya-connector / start
Para e inicia. Parado, o Sentrya mostra o conector como offline e a coleta pausa.
sudo systemctl disable --now sentrya-connector
Para e não inicia mais com o sistema (sem desinstalar).
sudo journalctl -u sentrya-connector -f
Registros crus do serviço (JSON), direto do journal.

Arquivos

/etc/sentrya-connector/connector.yaml
Configuração (domínio do Sentrya, proxy, atualização, Zabbix). Permissão 0640.
/etc/sentrya-connector/secrets/
Tokens e senhas do Zabbix, um arquivo por Zabbix (0640, dono root, grupo do serviço).
/var/lib/sentrya-connector/identity.key
Chave privada do conector (Ed25519). Nunca sai da máquina.
/var/lib/sentrya-connector/identity.json
Identidade pública: id, nome, empresa e domínio do registro.
/var/lib/sentrya-connector/state.json
Estado atual (o que o status mostra).
/var/lib/sentrya-connector/audit.log
Auditoria de cada chamada ao Zabbix; gira em até 5 arquivos de 10 MB.
/var/lib/sentrya-connector/update-result.json
Resultado da última atualização.
/var/lib/sentrya-connector/user-tokens.enc e user-tokens.key
Tokens de API das pessoas da equipe, cifrados, e a chave deles (os dois 0600). Veja Segurança do Sentrya Connector.
/var/log/sentrya-connector-install.log
Saída do apt/dnf durante a instalação.

Códigos de saída

0
Tudo certo.
1
Erro (a mensagem diz qual).
2
Uso incorreto (opção inválida, configuração inválida, faltou informação).
3
Conector revogado no Sentrya: o serviço não tenta reconectar.
4
Máquina ainda não registrada: rode sudo sentrya-connector setup (o assistente pede o token). O systemd mostra esse código como 4/NOPERMISSION, que é só o nome padrão dele para o código 4.

sentrya-connector status --quiet não imprime nada e sai com 0 quando conectado — útil em monitoramento e healthcheck.