Navegar na documentação

Primeira coleta

Um servidor recém-conectado não começa a coletar sozinho. Você dispara a primeira coleta, revisa quantos problemas já estavam abertos e confirma — só então o Sentrya passa a acompanhar e a notificar.

Por que existe uma primeira coleta

Um Zabbix em produção costuma ter dezenas ou milhares de problemas abertos antes de você conectar o Sentrya. Se a primeira coleta tratasse todos como incidentes novos, cada um geraria uma notificação: uma tempestade de push com alertas que já existiam. Por isso o servidor nasce com status Conectado, mas "nunca sincronizado", e espera você iniciar a coleta pelo botão Fazer primeira coleta.

Os problemas importados entram como um resumo inicial: aparecem na aba Incidentes depois da confirmação, mas não disparam notificação por cada um.

Fazer a primeira coleta

  1. Abra Ajustes → Servidores Zabbix No card do servidor, toque em Fazer primeira coleta. Só Admin e Operador podem iniciar, confirmar ou descartar; qualquer papel pode acompanhar o progresso.
  2. Acompanhe a folha "Primeira coleta" Ela mostra "Preparando a coleta…" enquanto o total ainda não é conhecido e depois "Coletando problemas…" com a barra coletados de total. Você pode fechar a folha: "Pode fechar — a coleta continua em segundo plano." Ao voltar à tela, o card mostra o botão Coletando problemas… para reabrir.
  3. Revise o resultado Ao terminar, a folha muda para Coleta concluída com "N problemas encontrados" e o texto "Confirme para começar a acompanhar, ou descarte se não quiser importar."
  4. Confirme ou descarte Confirmar e acompanhar transforma o resumo em incidentes normais e coloca o servidor na coleta contínua. Descartar apaga tudo o que foi coletado e devolve o servidor ao estado inicial — a folha pede confirmação: "Descartar a coleta? Tudo que foi coletado será apagado. Você pode fazer a primeira coleta de novo depois."
A coleta travou? Enquanto está coletando, a folha oferece Recomeçar. O Sentrya sinaliza o recomeço ("Recomeçando…"), o coletor apaga o que já havia gravado e a coleta reinicia do zero automaticamente. Se a API do Zabbix falhou no meio, a coleta fica parada em "coletando" com o erro registrado no servidor — use Recomeçar.

Estados do servidor

A primeira coleta é um eixo separado do status de conexão (Conectado/Erro). Enquanto ela não é confirmada, o servidor não entra no ciclo normal de coleta.

EstadoO que o app mostraO que acontece por trás
pending_import (coleta pendente)Card com "nunca sincronizado" e o botão Fazer primeira coleta.Servidor cadastrado e verificado. Nenhum problema foi lido ainda.
importing (coletando)Folha "Primeira coleta" com progresso; no card, o botão Coletando problemas… reabre a folha.O coletor lê o problem.get inteiro, filtra triggers monitoradas, resolve hosts e grupos e grava tudo marcado como resumo inicial, sem notificar.
imported (aguardando confirmação)Folha Coleta concluída com a contagem e os botões Confirmar e acompanhar / Descartar.Os problemas estão gravados, mas escondidos da aba Incidentes até a confirmação.
aborting (recomeçando)Folha com "Recomeçando…".Você tocou em Recomeçar: o coletor apaga o lote e volta o servidor para pendente; o app dispara a nova coleta sozinho.
confirmed (confirmado)Card normal com Verificar conexão e "sincronizado há …".Coleta contínua ligada: problemas novos geram incidentes e notificações; problemas que somem viram Resolvido.

O que muda depois de confirmar

  • Os problemas importados passam a aparecer na aba Incidentes como incidentes ativos, com Recorrências já semeadas a partir dos últimos 30 dias de eventos do Zabbix (veja Recorrências).
  • O servidor entra no ciclo de coleta contínua. A partir daí, cada problema novo no Zabbix vira um incidente e passa pelos seus ouvintes (veja O que é o Modo Ouvinte).
  • Os problemas do resumo inicial nunca geram push retroativo. Se um deles for resolvido e voltar, a volta conta como recorrência e pode notificar.
"Verificar conexão" não substitui a primeira coleta. Enquanto o servidor não for confirmado, verificar a conexão só testa a URL e a credencial; nenhuma coleta é agendada por esse caminho. O único jeito de ler os problemas pela primeira vez é o botão Fazer primeira coleta.

Detalhes úteis

  • Tocar duas vezes em Fazer primeira coleta não inicia duas coletas: o servidor reabre a folha no estado atual.
  • Descartar remove os incidentes, as identidades de recorrência e os grupos de host gravados pelo lote. O servidor continua cadastrado; basta fazer a primeira coleta de novo.
  • O total exibido na barra é o número de problemas depois do filtro de paridade com o painel do Zabbix (problemas suprimidos por manutenção e triggers desabilitadas ficam de fora — veja O que o Sentrya coleta do Zabbix).
  • No painel web, o mesmo fluxo acontece dentro do card do servidor em Servidores Zabbix, com os mesmos botões.

Veja também