V-Fire-Monitor/docs/GRAFANA_PLANTA_BAIXA.md

Grafana e Planta Baixa

Este guia cobre o uso do Grafana com o V-Fire Monitor para dashboards baseados em planta baixa.

Arquivos de apoio

• floorplan/floorplan-map.example.json
• tools/build_floorplan_bundle.py

O que o instalador ja deixa pronto

Na instalacao Debian 13:

• plugin Zabbix do Grafana instalado
• datasource Zabbix provisionado
• dashboard inicial V-Fire Floorplan Starter
• icones SVG servidos pelo proprio V-Fire Monitor

URLs dos icones

Substitua SEU_HOST pelo host do V-Fire Monitor.

• http://SEU_HOST:8088/static/grafana-icons/detector-smoke.svg
• http://SEU_HOST:8088/static/grafana-icons/detector-heat.svg
• http://SEU_HOST:8088/static/grafana-icons/module-input.svg
• http://SEU_HOST:8088/static/grafana-icons/siren.svg
• http://SEU_HOST:8088/static/grafana-icons/panel-nfs320.svg

Dashboard inicial

O instalador provisiona a pasta V-Fire no Grafana e um dashboard chamado:

• V-Fire Floorplan Starter

Esse dashboard serve como ponto de partida e lembra as URLs dos icones.

Formato versionavel da planta

Para nao depender apenas de arrastar elementos manualmente no Grafana, o repositorio agora inclui um formato JSON de mapa de planta.

Campos principais:

• title
• grafana_dashboard_uid
• background_image_url
• vfire_base_url
• zabbix_host
• items

Cada item descreve:

• id
• label
• item_key
• icon
• x
• y
• width
• height
• rotation

Gerar bundle normalizado

Exemplo:

python3 tools/build_floorplan_bundle.py floorplan/floorplan-map.example.json

Isso gera um arquivo .bundle.json com:

• URLs completas dos icones
• referencia do host do Zabbix
• referencias dos item_key
• coordenadas prontas para uso em futuras automacoes

Montando a planta baixa

Abordagem recomendada:

1. Abra o dashboard V-Fire Floorplan Starter
2. Crie ou edite um painel do tipo Canvas
3. Defina a imagem de fundo com a planta baixa do local
4. Adicione elementos visuais ou imagens representando cada ponto
5. Use os SVGs do V-Fire Monitor como base visual
6. Associe cada elemento ao item correspondente no datasource Zabbix

Como mapear itens

Os itens que o app envia ao Zabbix seguem chaves como:

• notifier.status[NomeDoPonto]
• notifier.comm[NomeDoPonto]
• node.status[NomeDaCentral]

Os nomes dos pontos sao descobertos automaticamente a partir do monitoramento.

Estrategia recomendada de planta baixa

• use a planta como imagem base
• posicione um icone por detector, modulo ou sirene
• use cor dinamica para refletir estado
• crie uma legenda simples com:
  • normal
  • incidente
  • ack
  • removido
  • offline

Observacao pratica

O instalador nao conhece a planta baixa real do cliente.

Por isso, ele consegue deixar:

• Grafana integrado
• datasource pronto
• dashboard inicial provisionado
• icones prontos
• formato versionavel da planta baixa
• bundle normalizado para futuras importacoes

Mas o posicionamento exato dos elementos na planta baixa ainda precisa ser feito conforme o layout real da instalacao.