Usando o painel
O painel é o cockpit da operação. O acesso é por login, e cada pessoa vê só os hosts que o seu escopo permite. Todas as telas estão em português, com números no formato brasileiro.
Menu
| Tela | Para que serve |
|---|---|
| Visão geral | Saúde dos hosts, agentes online/offline, comunicação atrasada e alertas críticos. |
| Dashboards | Painéis salvos estilo Grafana, modelos prontos e modo TV. |
| Hosts | Lista e detalhe do host: gráficos, filesystems, serviços, containers, virtualização, rede, saturação, verificações recentes. |
| Clusters | Docker Swarm e Kubernetes: nós, serviços, workloads, alertas, eventos e atividade da IA. |
| Bancos de dados | Saúde, replicação, topologia, consultas, capacidade e configuração de cada instância. |
| Agentes | Agentes instalados e o estado de comunicação de cada um. |
| Alertas | Alertas com filtros e o painel de alerta. |
| Remediações | Planos de correção, aprovações e resultados. |
| Serviços, Logs, Runbooks, Notificações | Serviços monitorados, Log Explorer, procedimentos e histórico de envios. |
| Cerberus, Segurança, Integridade do host | Eventos de segurança, vulnerabilidades (CVE) e integridade. |
| Painel administrativo | Usuários, regras de acesso, host groups, projetos/sites, agentes e tokens, notificações, agentes de IA (provedor, modelo e limites), retenção e disco. |
Alertas
Cada alerta é um problema deduplicado: o mesmo host, recurso e regra atualizam o mesmo alerta em vez de abrir outro.
A lista tem filtros por severidade, estado, host e texto; /alerts?alert_id=N abre um alerta direto.
Painel do alerta
O painel lateral é o mesmo em Alertas, no detalhe do host (ao clicar numa verificação com alerta aberto) e na página do cluster (alertas do cluster, containers, serviços degradados e tasks presas ou com falha). Ele mostra:
- mensagem com a saída real do agente, Impacto e Causa provável (específicos para Docker e Swarm: falha de pull de imagem, quorum com número par de managers, crash loop, task presa em
created…); - Evidências e o Runbook da regra;
- Histórico de remediação e, quando há um plano esperando, Aprovar correção / Rejeitar correção;
- a seção Análise IA (causa raiz), com o botão Analisar com IA nos tipos de alerta suportados;
- as ações Reconhecer, Resolver e Arquivar.
Pressão de recursos (PSI)
Com a pressão estendida ligada no agente, o detalhe do host ganha o card Pressão de recursos (PSI): escopo host, pod ou containers do pod, período e média de 10 s, 60 s ou 300 s. O card diz quando o kernel não tem PSI, quando os dados estão desatualizados ou indisponíveis desde certo horário, quando o histórico está fora e quando o agente reduziu a coleta para proteger o host.
Um episódio de pressão agrupa nós e pods de um cluster (ou um host) em pressão ao mesmo tempo. O alerta do episódio mostra a pressão observada, o impacto confirmado (OOMKilled, eviction, probe falhando), os workloads possivelmente associados com o nível de confiança e a linha do tempo do Kubernetes. Ações como drain, eviction ou restart aparecem só como recomendação, com os pré-requisitos.
Ver erro e correção
O botão Ver erro e correção abre um pop-up largo com o erro completo, o impacto, a causa provável, o plano de correção (para aprovar ou rejeitar ali mesmo) e a análise da IA lado a lado. Depois da revisão, o painel recarrega com o novo estado.
Clusters
- Docker Swarm: quorum, managers, leader, serviços e réplicas, containers com problema, serviços degradados e tasks presas ou com falha. Cada item com alerta abre o painel do alerta. O bloco Recursos mostra memória e CPU por serviço (todas as tasks em todos os nós) e por nó, atualizado a cada 30 s.
- Kubernetes: nós, workloads e pods com erro, alertas do cluster, Eventos do cluster (clique para ver o evento completo; Analisar com IA nos eventos
Warning) e o feed Agente IA.
Detalhes de coleta em Containers, clusters e VMs.
Dashboards
Painéis no estilo Grafana, montados numa grade de 24 colunas.
- Novo (em branco) ou Usar modelo: NOC, Infraestrutura, Bancos, Capacidade e APM.
- Editar: arraste pelo cabeçalho e redimensione pelo canto ou pelas bordas. Em Tamanho há atalhos (1/4, 1/3, 1/2, 2/3, inteira) e largura/altura exatas.
- Painéis de um host: escolha um host e o editor adiciona um conjunto pronto (CPU, memória, disco e alertas; histórico de CPU e memória; rede ao vivo; disco em pizza e por volume; lista de alertas). O campo Hosts restringe qualquer painel a hosts específicos.
- Salvar grava uma versão nova; o Histórico permite restaurar versões anteriores.
- Compartilhar com a organização, usuários ou grupos (ver ou editar); Exportar/Importar em JSON.
- Modo TV:
/dashboards/<id>/tv, ou rotação entre vários com/dashboards/tv?uids=a,b&interval=60. Use um usuário somente leitura dedicado por TV.
| Painel | Mostra |
|---|---|
| Número (stat) e medidor | Um valor, com o host do máximo/mínimo e limites de alerta. |
| Série temporal | Os hosts com maior valor; linha, área ou empilhado; limiares; rede recebida e enviada em bit/s. |
| Pizza | Disco usado × livre, por volume ou por host; estado dos hosts; alertas por severidade. |
| Tabela | Valor atual por host, ou um volume de disco por linha. |
| Grade de estado, lista de alertas, mapa de serviços | Estado dos hosts, alertas abertos, topologia de replicação dos bancos e composição dos clusters. |
| Logs | Linhas de log mais recentes dos hosts, com filtro por texto, severidade e serviço. |
| Serviços APM | Serviços instrumentados com chamadas, % de erro e p95, ordenados por volume, erros ou lentidão. |
| Texto | Markdown seguro. |
A opção Tempo real (gráficos, indicadores, tabelas e logs) faz o painel se atualizar a cada 10 s nos últimos 15 min, inclusive no modo TV. Cada painel mostra sempre os dados do escopo de quem está vendo, nunca do dono.
Tabelas configuráveis
As tabelas de Alertas, Serviços e do detalhe do host (serviços, verificações, filesystems, interfaces) podem ser ajustadas por cada usuário; a de eventos do cluster aceita o ajuste de largura:
- Colunas: mostrar/ocultar e reordenar (arrastando ou pelas setas).
- Largura: arraste a divisória entre cabeçalhos; duplo clique ajusta ao conteúdo. Coluna ajustada mostra o texto inteiro, quebrando linha.
- As escolhas ficam salvas por usuário. Restaurar padrão volta ao original.
Atualização automática
Cada tela escolhe o intervalo (sem, 5 s, 15 s, 30 s, 60 s); o padrão é sem atualização. Se o servidor falhar várias vezes seguidas, a atualização pausa e um aviso aparece no bloco afetado, sem apagar o último dado válido.
Administração
- Usuários: Novo usuário com senha temporária (mostrada uma vez, troca obrigatória no primeiro login); editar nome, papel, ativo e grupos; Gerar nova senha para quem esqueceu (encerra as sessões abertas); Ver escopo mostra os hosts que cada regra concede. Um admin não pode desativar nem rebaixar o próprio usuário.
- Papéis:
viewer(leitura),operator(reconhecer, resolver, aprovar correção, pedir análise de IA, criar dashboards) eadmin. - Regras de acesso e Host groups: grupos estáticos ou dinâmicos (por empresa, site, ambiente, tag, SO, serviço ou banco). Um host novo que casa a regra entra sozinho, em até cerca de 1 minuto.
- Projetos/Sites e Add Node: perfil do site e comando de instalação (veja Perfil do site).
- Agents / Arquivos: comandos gerados, agentes de cada token e revogação.
- Notificações: canais, destinos, grupos e roteamento (veja Notificações).
- Retenção & Disco: quanto tempo cada tipo de dado é guardado e o uso de disco.