Relatórios
O ION Guard permite gerar relatórios detalhados sobre a operação de segurança, disponibilidade de dispositivos e atividade nos sites.
Acesso
Caminho de acesso: Menu lateral → Administração → Relatórios
A página de Relatórios está disponível para Platform Admin, Tenant Master, Tenant Admin e Operador (permissão Ver relatórios). Já gerar um relatório exige a permissão Gerar relatórios, restrita a Platform Admin, Tenant Master e Tenant Admin. Além disso, cada tipo de relatório tem um perfil mínimo próprio — por isso o Operador pode abrir a página, mas nem sempre encontra relatórios disponíveis para o seu perfil.
Tipos de relatório
| Relatório | Descrição |
|---|---|
| Resposta a Alertas (SLA) | Tempos de resposta, reconhecimento e resolução de alertas no período |
| Disponibilidade de Beacons | Uptime e downtime de cada beacon — identifica dispositivos problemáticos |
| Saúde de Antenas | Status e disponibilidade das antenas por zona |
| Ocupação de Zonas | Métricas de presença por zona — quantas pessoas/ativos em cada período |
| Incidentes de Segurança | Resumo consolidado de alertas, escalações e resoluções |
| Trilha de Auditoria | Log de todas as alterações feitas no sistema |
| Atividade de Dispositivos | Log detalhado de sinais e movimentações de beacons |
| Entrada em Zona Restrita | Registro de todas as entradas detectadas em zonas restritas |
| Conformidade de Câmara Fria | Tempo de exposição e conformidade de turnos — requer o módulo Câmara Fria |
A lista acima é o catálogo de tipos de relatório previstos na plataforma. Os relatórios efetivamente disponíveis na sua tela dependem de três fatores:
- Seu perfil — cada relatório tem um perfil mínimo (por exemplo, "Trilha de Auditoria" exige Tenant Master).
- Módulos habilitados no site — relatórios como "Disponibilidade de Beacons" e "Saúde de Antenas" requerem o módulo Synapsys; "Conformidade de Câmara Fria" requer o módulo Câmara Fria.
- Handlers implementados na versão instalada — a plataforma exibe apenas os tipos com processamento disponível na sua versão.
Gerar um relatório
- Na página de Relatórios, selecione o tipo de relatório
- Defina o período:
- Data início — Padrão: 30 dias atrás
- Data fim — Padrão: hoje
- Selecione o formato de exportação. Cada tipo de relatório declara os formatos que aceita — a tela mostra apenas esses. Os relatórios do núcleo da plataforma exportam em CSV; formatos como XLSX e PDF são oferecidos por relatórios entregues pelos módulos que os suportam:
- CSV — Ideal para importação em planilhas e análise de dados
- XLSX — Planilha Excel formatada
- PDF — Documento para impressão e compartilhamento
- Clique em "Gerar"
Além do período, alguns relatórios oferecem filtros adicionais (por exemplo, por zona ou por tipo de dispositivo). Esses campos aparecem dinamicamente conforme o tipo escolhido.
Processamento
Relatórios são gerados de forma assíncrona — a geração é enviada para uma fila de processamento e não bloqueia a interface.
| Status | Significado |
|---|---|
| Pendente | Na fila, aguardando processamento |
| Processando | Sendo gerado |
| Concluído | Pronto para download |
| Falhou | Erro na geração — a mensagem de erro é exibida |
A página faz polling automático a cada 5 segundos enquanto houver relatórios pendentes ou em processamento.
Download
Quando o status é Concluído, a coluna de ações exibe o botão de download (envio direto do arquivo pelo servidor) e um botão de Visualizar, que abre o relatório para conferência.
Apenas o usuário que solicitou o relatório (ou um Platform Admin) pode baixá-lo.
Histórico
A página exibe o histórico dos relatórios que você gerou para o site atual (paginado, 15 por página), incluindo:
- Tipo do relatório
- Período (data início — data fim)
- Formato (CSV, XLSX, PDF)
- Status atual
- Total de linhas (quando concluído)
- Data da solicitação
Limpeza automática
Relatórios antigos são removidos automaticamente pelo job CleanupOldReportsJob para liberar espaço em disco. A retenção segue a política configurada pelo administrador.