Status, logs e diagnóstico
Quatro comandos respondem quase tudo sobre o Connector: status (como está agora), logs (o que aconteceu), logs --audit (o que o Sentrya pediu ao seu Zabbix) e doctor (por que não funciona).
Status
sudo sentrya-connector status
Mostra se o Connector está conectado ao Sentrya, o nome do conector e a empresa, a latência, cada Zabbix configurado (endereço, versão, hosts e se o ACK está ligado), uma linha tokens: por Zabbix com quantos tokens de pessoa estão guardados, quantos venceram ou vencem em até 30 dias e o próximo vencimento (nunca de quem nem o valor), o total de chamadas e erros, a política de atualização e o resultado da última atualização. Quando há problema, mostra o último erro e o horário da próxima tentativa. Para automação: --json (estado completo) e --quiet (código 0 se conectado).
Registros do serviço
sudo sentrya-connector logs # últimos 50 registros
sudo sentrya-connector logs -f # acompanha em tempo real (Ctrl+C sai)
sudo sentrya-connector logs -n 200 --since "1 hour ago"
Mostra, em linhas legíveis, a conexão com o Sentrya (conectou, caiu, reconectou), os erros e as atualizações — do serviço e do atualizador. Os registros ficam no journal do systemd; --raw mostra as linhas em JSON, como estão gravadas, e sudo journalctl -u sentrya-connector -f lê direto do journal.
Auditoria: o que o Sentrya pediu ao seu Zabbix
sudo sentrya-connector logs --audit
sudo sentrya-connector logs --audit -f
Cada chamada que passou pelo Connector fica registrada na máquina, em /var/lib/sentrya-connector/audit.log: horário, Zabbix (apelido), método, tempo de resposta, tamanho e resultado — ok ou o motivo da recusa. Parâmetros e respostas não são gravados. É a prova, do seu lado, de tudo o que o Sentrya fez no seu Zabbix.
Diagnóstico
sudo sentrya-connector doctor
Testa, em ordem: arquivos e permissões, DNS, saída 443, proxy, TLS e certificado, relógio, a identidade do conector, o aperto de mão com o Sentrya e, para cada Zabbix, o alcance, a credencial, cada método da lista e os "tokens de pessoa": desligados, ligados com o usuário do Connector Super admin, ou um aviso quando ele não é Super admin. Com sudo, mostra também quantos tokens de pessoa estão guardados e quando vencem, e avisa quando a guarda local deles não abre (por exemplo, a chave ou o arquivo com permissão mais aberta que 0600). Cada falha vem com a dica do que fazer. Para investigar só a parte local: --offline.
Pacote para o suporte
sudo sentrya-connector support-bundle
Gera sentrya-connector-suporte-MAQUINA-DATA.tar.gz na pasta atual, com versão, estado, diagnóstico, os últimos registros do journal, o status do systemd e a configuração. Tokens, senhas e a chave do conector são substituídos por marcadores antes de gravar. Envie o arquivo à equipe Flowbix quando ela pedir.
Problemas comuns
| O que aparece | Causa | O que fazer |
|---|---|---|
| sem resposta de connector.flowbix.com:443 | O firewall bloqueia a saída. | Libere a saída TCP 443 para connector.flowbix.com, ou use o proxy da empresa. |
| o nome connector.flowbix.com não resolve nesta máquina (DNS) | DNS da máquina. | Confira o DNS; se a rede só sai por proxy, informe o proxy. |
| o proxy pediu autenticação | Proxy com senha. | Use http://usuário:senha@proxy:porta. |
| certificado não confiável em connector.flowbix.com | Proxy com inspeção TLS. | Libere connector.flowbix.com da inspeção ou aponte a CA da empresa em sentrya.ca_file (o proxy passa a enxergar o conteúdo da conexão). |
| o relógio desta máquina está … fora | Relógio desajustado. | sudo timedatectl set-ntp true. |
| token recusado | O token de instalação venceu (24 h), já foi usado ou não existe. | Gere um token novo na página do Sentrya Connector (administrador da empresa). |
| no registro: "suspended: período de teste encerrado no Sentrya", "empresa suspensa no Sentrya" ou "empresa sem acesso ao Sentrya" | A empresa do token está sem acesso ao Sentrya (teste encerrado, suspensa ou cadastro não liberado), e o registro de um conector novo é recusado. O token não é consumido. | Resolva o acesso com a Flowbix. Depois, rode o setup de novo com o mesmo token, enquanto ele valer (24 h), ou com um novo. |
| conector não registrado (código 4) | A máquina tem o pacote, mas não foi registrada. | sudo sentrya-connector setup (o assistente pede o token). |
| versão abaixo da mínima (aguardando atualização) | A versão instalada está abaixo da mínima que o Sentrya aceita (o piso de segurança ou a versão mínima definida pela Flowbix), e o Sentrya recusa a conexão. | Com a política auto, o Connector instala a versão mínima sozinho, dentro da janela configurada (se houver). Com notify ou manual, rode sudo sentrya-connector update. Veja Atualizações. |
| empresa suspensa (coleta pausada; volta sozinha), com "período de teste encerrado no Sentrya" no último erro | O período de teste da empresa terminou. O Sentrya recusa a conexão e derruba a que estava aberta em até um minuto. | Fale com o comercial da Flowbix. Depois da contratação, o Connector reconecta sozinho na próxima tentativa (em até 10 minutos), sem reinstalar. |
| empresa suspensa (coleta pausada; volta sozinha), com "empresa suspensa no Sentrya" ou "empresa sem acesso ao Sentrya" no último erro | A empresa está bloqueada no Sentrya ou teve o cadastro recusado. | Fale com a Flowbix. Com o acesso liberado, o Connector reconecta sozinho. |
| conector REVOGADO no Sentrya (código 3) | O conector foi revogado (desinstalado em outra ocasião, empresa cancelada ou revogado pela Flowbix). | O serviço não reconecta. Para voltar, registre de novo com um token novo. |
| nada respondendo em ENDEREÇO | Porta errada ou frontend do Zabbix fora do ar. | Confira a porta (http = 80, https = 443) e o frontend. |
| o endereço respondeu, mas não é a API do Zabbix | Caminho errado. | Use o endereço do frontend (ex.: http://10.0.0.5/zabbix). |
| o Zabbix recusou o token | Token do Zabbix vencido ou desativado. | Gere outro em Tokens de API e troque o conteúdo de /etc/sentrya-connector/secrets/APELIDO.token (mantenha o apelido: é por ele que o Sentrya liga o Zabbix). Vale na próxima chamada; confira com sudo sentrya-connector zabbix test APELIDO. |
| o usuário não pode usar … | Faltam métodos no papel do Zabbix. | Veja Preparar o usuário no Zabbix. |