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 apareceCausaO que fazer
sem resposta de connector.flowbix.com:443O 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çãoProxy com senha.Use http://usuário:senha@proxy:porta.
certificado não confiável em connector.flowbix.comProxy 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á … foraRelógio desajustado.sudo timedatectl set-ntp true.
token recusadoO 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 erroO 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 erroA 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ÇOPorta 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 ZabbixCaminho errado.Use o endereço do frontend (ex.: http://10.0.0.5/zabbix).
o Zabbix recusou o tokenToken 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.
O Connector se recupera sozinho. Queda de internet, reinício do Sentrya ou do Zabbix: o serviço reconecta sozinho, esperando de 1 segundo a 5 minutos entre as tentativas. Enquanto ele está offline, o Sentrya não coleta daquele Zabbix e mostra o servidor com erro; a coleta volta ao reconectar.

Veja também