Histórico do item
No detalhe de um incidente vindo do Zabbix, o Sentrya mostra o gráfico do item da trigger: como o valor se comportou antes, durante e depois do problema. Os valores são lidos na hora da API do seu Zabbix e não ficam guardados no Sentrya.
Onde aparece
- Minigráfico no detalhe Ao abrir um incidente do Zabbix, aparece um cartão com o primeiro item numérico da trigger, a última hora e o valor atual. Se o Zabbix não responder, o cartão simplesmente não mostra o gráfico: o resto do detalhe continua igual.
- Ver histórico Tocar no cartão abre o Histórico, enquadrado no incidente. Dá para trocar o item da trigger e o período: Incidente, 1 h, 6 h, 24 h, 7 d e 30 d. Logo abaixo dos itens aparecem o nome inteiro do item escolhido e a chave dele; toque para copiar.
- Pelo Explorar No app, o detalhe de um item no Explorar tem Ver gráfico, que abre o mesmo gráfico sem a faixa do incidente, com os períodos 1 h, 6 h, 24 h, 7 d e 30 d.
- Olhar de perto No painel web, passe o mouse para ver a hora, a média e a faixa de cada ponto, ou use as setas do teclado com o gráfico em foco. Arraste sobre o gráfico para ver um trecho de perto; Voltar desfaz o zoom. No app, arraste o dedo na horizontal sobre o gráfico (ou toque, segure e arraste): aparecem a linha e um balão com a hora e o valor, e o celular dá um toque leve ao passar pelo início do incidente e um mais forte ao passar pelo pico.
- Escolher o período O botão de calendário ao lado dos períodos (Escolher período, no painel web) deixa escolher qualquer trecho dos últimos 30 dias, com pelo menos 10 minutos. No app, arraste as alças da régua dos 30 dias para mudar o início e o fim, ou arraste o meio para deslizar o período inteiro; o início e o fim exatos se ajustam no seletor de data e hora do iPhone, ou nos botões de dia e de 15 minutos no Android. No painel web, use os campos de data e hora. Há atalhos para o dia do incidente (só no gráfico de um incidente), ontem e os últimos 3 dias. Um período escolhido não se atualiza sozinho; para voltar, toque no × do período (app) ou em Voltar (web).
- Compartilhar a imagem O botão de compartilhar (no topo do Histórico, no app; Compartilhar imagem, no painel web) gera uma imagem com o item, o período, o valor atual, o gráfico, os números e o resumo. Junto vai o link Abrir no Sentrya daquele histórico: quem abre o link entra na própria conta e vê o mesmo gráfico, no mesmo item e no mesmo período, no app ou no painel web. No iPhone e no navegador, a imagem e o link vão na mesma mensagem; no Android, o link é copiado ao compartilhar, para você colar na legenda da imagem. No app, precisa da versão 1.3.0 ou mais nova. Quando as Conversas estão habilitadas no seu ambiente, o botão pergunta antes o que fazer: Enviar numa conversa (veja abaixo) ou Imagem e link, que é este compartilhamento.
Enviar o gráfico numa conversa
Quando as Conversas estão habilitadas no seu ambiente, dá para mandar o gráfico que você está vendo para um grupo ou um contato. A mensagem leva um card de histórico: cada pessoa da conversa vê o gráfico de verdade, lido na hora do Zabbix com a permissão dela, e não uma foto.
- Compartilhar No Histórico (de um incidente ou do Explorar), toque no botão de compartilhar e escolha Enviar numa conversa. No painel web, a opção fica no compartilhar do Histórico, junto da imagem.
- Escolha a conversa Aparece a lista das suas conversas; as salas de incidente não entram nela. Ao escolher, a mensagem sai com o card do item, no período que estava na tela.
- Olhe o card O card mostra o nome do item, o host e o servidor, o último valor com a unidade (ou a disponibilidade, nos itens de estado) e um gráfico compacto. No app, arraste o dedo na horizontal sobre o gráfico para ver a hora e o valor de cada ponto; fora do gráfico, arrastar a mensagem para responder e segurar para abrir o menu funcionam como em qualquer mensagem. No painel web, passe o mouse ou use as setas do teclado; no card não há zoom por arraste.
- Abra o histórico completo Tocar no cabeçalho do card abre o Histórico completo, no mesmo item e no mesmo período.
| Período usado no envio | Como o card abre |
|---|---|
| Uma faixa: Incidente, 1 h, 6 h, 24 h, 7 d ou 30 d | Começa Ao vivo: mostra a mesma faixa até agora e se atualiza a cada 60 segundos, só com a conversa aberta e visível. O botão Como foi enviado troca para o trecho exato que estava na tela de quem enviou, que não se mexe; assim um pico que já saiu da faixa continua à vista. |
| Um período escolhido no calendário | Sempre fixo no trecho enviado, com o rodapé Fixo e as datas e horas do início e do fim. |
- Só itens numéricos e de estado de servidores Zabbix da sua empresa; itens de texto não oferecem o envio.
- Um gráfico por mensagem. A notificação da conversa mostra 1 gráfico.
- Se a pessoa usa uma versão do app sem o card de histórico, a mensagem aparece como o card do host do item.
O que o gráfico mostra
- A média de cada ponto, na cor de destaque que você escolheu, com a faixa entre o mínimo e o máximo em volta.
- A faixa do incidente, na cor da severidade, do alerta até o fim (ou até agora).
- O pico e o mínimo do período, com valor e hora, e a linha pontilhada da média do período.
- Trechos sem dados hachurados: a linha quebra ali, nada é inventado.
- Os blocos Pico, Mínimo, Média, p95, Último e Cobertura. Tocar em Pico, Mínimo ou Último leva o cursor até o ponto.
- Um Resumo em uma ou duas frases, como "Durante o incidente a média ficou 3,1× acima da hora anterior."
O pico e o mínimo são calculados sobre as amostras originais, não sobre os pontos do desenho: um pico de uma amostra só continua aparecendo mesmo quando o período é longo. A comparação com a hora anterior usa sempre a hora antes do alerta, qualquer que seja o período escolhido.
Itens de estado
Itens 0/1 ou com mapa de valores (como icmpping ou o estado de uma interface) aparecem como uma faixa de trechos, em verde e vermelho, com Disponível, Quedas, Maior queda e Última queda.
Bruto e médias por hora
| Período | Fonte | Observação |
|---|---|---|
| Até 24 h | Histórico bruto do Zabbix (history.get) | Até 10.000 amostras por consulta. Se o período tiver mais, o gráfico mostra as mais recentes e avisa para escolher um período menor. |
| Acima de 24 h | Médias por hora do Zabbix (trend.get) | A hora em andamento vem do bruto. Não há p95, porque as médias por hora não permitem calcular. |
Se o item não guarda histórico bruto (retenção 0 no Zabbix) ou se o período é mais antigo que a retenção do item, o Sentrya usa as médias por hora mesmo em períodos curtos. O rodapé do gráfico diz qual das duas fontes está na tela.
O que o Sentrya guarda
Nenhum valor de item é gravado no banco do Sentrya. As respostas do Zabbix ficam na memória do serviço de histórico por pouco tempo, para várias pessoas olhando o mesmo gráfico não gerarem várias consultas: 30 segundos quando o período chega até agora, 30 minutos quando é um período passado e 60 segundos para a lista de itens. Os registros do serviço guardam só empresa, servidor, item, método, duração e tamanho, nunca os valores. A imagem de compartilhamento é gerada no seu aparelho e vai só para onde você escolher: o Sentrya não guarda nem envia a imagem. O card de histórico enviado numa conversa guarda só a referência: o servidor, o item, o incidente (quando saiu de um), o nome do host e do item e o período; os valores são lidos de novo por quem abre a conversa.
Proteções para o seu Zabbix
| Proteção | Como funciona |
|---|---|
| Consultas simultâneas | No máximo 2 por servidor Zabbix, somando todas as pessoas da empresa (1 quando o servidor está atrás do Sentrya Connector). Quem passa disso espera até 1,5 s e depois vê "O Zabbix está ocupado". |
| Tempo de resposta | Cada consulta tem até 7 segundos. |
| Zabbix lento ou fora do ar | Depois de 3 falhas seguidas, o Sentrya para de consultar aquele servidor por 60 segundos e depois tenta uma vez. |
| Tamanho | Até 10.000 amostras de bruto ou 2.200 horas de médias por consulta, e um item por vez. |
| Atualização automática | A cada 60 segundos, só com a tela aberta e visível. |
| Por pessoa | Até 60 gráficos e 30 listas de itens por minuto. |
Papel de API no Zabbix
O usuário do Zabbix que o Sentrya usa precisa poder chamar item.get, history.get e trend.get e ter leitura nos grupos de hosts do incidente. Se o papel de API do usuário tiver uma lista de métodos permitidos, inclua os três. Sem isso, o histórico mostra "O usuário do Zabbix usado pelo Sentrya não pode ler histórico"; a coleta de incidentes continua funcionando.
Ligar e desligar por servidor
O administrador da empresa liga ou desliga o Histórico ao vivo de cada servidor. Desligado, o Sentrya não lê valores de itens daquele Zabbix e o incidente mostra "O histórico foi desligado pelo administrador para este servidor".
- No painel web: Ajustes → Servidores Zabbix → Histórico ao vivo, no cartão do servidor.
- No painel de administração: Conexões → Zabbix, coluna Histórico.
Operadores e visualizadores veem o estado, mas só o administrador muda. Em servidores atrás do Sentrya Connector, o mesmo lugar diz se o conector libera o histórico, se precisa ser atualizado ou se o histórico foi desligado na máquina do conector.
Mensagens
| Mensagem | O que fazer |
|---|---|
| O Zabbix está ocupado. Tentando de novo… | Nada: o Sentrya tenta de novo sozinho até 3 vezes. Se continuar, use Tentar agora daqui a pouco. |
| Atualize o Sentrya Connector para ver o histórico | O conector deste servidor é de uma versão sem histórico. Veja Atualizações do Sentrya Connector. |
| O histórico foi desligado no Sentrya Connector deste servidor | A TI desligou o histórico na máquina do conector (allow_history: false). |
| O histórico foi desligado pelo administrador para este servidor | O administrador da empresa desligou o Histórico ao vivo do servidor. |
| O usuário do Zabbix usado pelo Sentrya não pode ler histórico | Libere history.get e trend.get no papel de API e confira a leitura nos grupos do host. |
| Sem dados neste período | O item não tem amostras no período. Escolha um período maior. |
| Itens de texto não têm gráfico | Itens de texto e de log aparecem na lista, sem gráfico. |