Dashboards¶
Dashboards são painéis configuráveis de widgets em uma grade de 12 colunas. Ficam agrupados em Sistema (prontos, somente leitura), Meus dashboards, pastas próprias e Compartilhados comigo.

Dashboards de sistema¶
Criados e atualizados automaticamente no boot da API:
| Dashboard | Conteúdo típico |
|---|---|
| Visão executiva | capacidade usada, IOPS e latência dos arrays, riscos, mapa de saúde, insights, volumes com maior latência, previsão de esgotamento |
| Storage — performance | IOPS, latência, throughput e utilização de sistemas, controladoras, pools e volumes |
| SAN Fabric | tráfego, utilização, erros e slow drain de portas de switch |
| Virtualização | latência e IOPS de VMs, CPU de hipervisores, CPU ready, ocupação de datastores/containers |
| Capacidade | ocupação e previsão de arrays, pools e datastores |

Dashboards de sistema não podem ser editados nem excluídos. Use Duplicar para criar uma cópia editável em “Meus dashboards”.
Ver um dashboard¶
- Período: botões 1h · 6h · 24h · 7d · 30d · 90d no cabeçalho. Widgets configurados com o período
do dashboard (
$range) acompanham essa escolha. Cada dashboard tem um período padrão. - Clique em uma barra, linha ou bloco para abrir o objeto correspondente.
- Menu ⋯ do widget: Exportar CSV dos dados do widget (
POST /api/v1/metrics/export.csv, separador;, timestamps em UTC). - Imprimir / PDF (ícone de impressora): gera uma versão para impressão (sem menus e botões), com quebras de página entre widgets. Escolha “Salvar como PDF” no diálogo do navegador.
Criar e editar¶
- Dashboards › Novo dashboard: nome, descrição, pasta, período padrão e, com a permissão
dashboards.manage, Compartilhar com todos os usuários. - Clique em Editar. Arraste os widgets pelo título e redimensione pelo canto. Use + Widget para adicionar, Propriedades para nome/pasta/período, Salvar ou Descartar.

- O assistente de widget pede o tipo e depois a configuração:

Tipos de widget¶
Widgets com consulta pedem tipo de objeto, métrica (somente as aplicáveis ao tipo, conforme o catálogo), agregação (padrão do catálogo, média, máximo, p95, mínimo, soma ou último), limite e ordem, e opcionalmente objetos fixos. Sem objetos fixos, o widget mostra os maiores (ou menores) valores do tipo.
| Tipo | Modo da consulta | Mostra | Opções específicas |
|---|---|---|---|
| Indicador (com sparkline) | stat |
valor agregado de todas as entidades no período e a tendência | “Exibir total somado” (ex.: capacidade de todos os arrays) |
| Série temporal | timeseries |
uma linha por objeto. Sem objetos fixos, usa os top-N do período. Faixas de aviso/crítico quando a métrica tem threshold | máx. de séries |
| Top N (barras) | topn |
ranking dos objetos | limite, ordem |
| Mapa de calor | heatmap |
objetos × tempo, cor pela intensidade | máx. de séries |
| Distribuição (histograma) | distribution |
quantos objetos em cada faixa de valor (com p50/p95) | — |
| Medidor | stat |
valor agregado em um medidor com faixas de aviso/crítico | valor máximo (vazio = 100 para %, ou 1,5 × o limite crítico) |
| Tabela (último valor) | topn |
lista de objetos com o valor da métrica | limite, ordem |
| Mapa de saúde | — | blocos coloridos por saúde | tipos de objeto exibidos |
| Insights priorizados | — | achados abertos por prioridade | severidade, limite, “só contagem” |
| Achados (lista) | — | achados filtrados por severidade/categoria | severidade, limite |
| Previsão de capacidade | — | objetos mais próximos do esgotamento | quantidade |
| Texto / Markdown | — | anotações, links e instruções | conteúdo Markdown |
A API valida cada widget ao salvar: tipo conhecido, consulta válida contra o catálogo, até 60 widgets por dashboard.
Compartilhar e clonar¶
| Ação | Quem pode |
|---|---|
| Criar dashboard pessoal | qualquer usuário com view |
| Compartilhar / deixar de compartilhar | dono com dashboards.manage |
| Editar / excluir | dono, ou quem tem dashboards.manage |
| Duplicar | qualquer usuário, para dashboards visíveis (próprios, compartilhados ou de sistema). A cópia vai para “Meus dashboards”, não compartilhada |
Via API: GET/POST /api/v1/dashboards, PUT/DELETE /api/v1/dashboards/{id},
POST /api/v1/dashboards/{id}/clone (endpoints).