Visualizza wikitesto di Installazione e configurazione dashboard web grafana

== Installazione Automatica Completa ==

1) Recuperare l'installer la cartella completa "App" nel seguente percorso: "\\QVSERVER\__Projects\Grafana Dashboard"

2) Copiarla in "C:\qualivision"

3) eseguire il file install_complete.bat

4) seguire ciò che fa fare per l'installazione completa

In caso non vada a buon fine o ci sia qualcosa che non va seguire i passaggi manuali sottostanti

Se tutto va a buon fine si può procedere con [[#Accesso alla Dashboard Qualivision|Accesso alla Dashboard Qualivision]]


== Installazione Grafana ==

1) Recuperare l'installer Grafana dalla cartella SoftInstall.

2) Installare Grafana utilizzando le impostazioni predefinite.

3) Verificare che sia stata creata la cartella:

   C:\Program Files\GrafanaLabs\grafana

4) Verificare che sia presente il servizio Windows Grafana.



== Configurazione servizio Grafana ==

Se si utilizza autenticazione Windows verso SQL Server, configurare il servizio Grafana con l'utente Windows che dovrà accedere al database.

In alternativa lasciare il servizio con la configurazione predefinita ed utilizzare credenziali SQL direttamente nelle Data Source.

Dopo ogni modifica riavviare il servizio Grafana.



== Ripristino configurazione Grafana Qualivision ==

1) Arrestare il servizio Grafana.

2) Sostituire completamente la cartella:

   C:\Program Files\GrafanaLabs\grafana

   con quella fornita da Qualivision.

3) Riavviare il servizio Grafana.



== Installazione Dashboard Qualivision ==

1) Copiare la cartella dell'applicazione nel percorso desiderato.

   Esempio:

   C:\Qualivision\Dashboard

2) Verificare la presenza dei file principali:

   main.py
   requirements.txt
   install.bat
   config
   static

3) Eseguire install.bat come amministratore.

4) Attendere il completamento dell'installazione.

5) Al termine dell'installazione la Dashboard Qualivision viene avviata automaticamente in background.

6) Viene inoltre configurato l'avvio automatico della Dashboard all'avvio di Windows, attivabile e disattivabile dal pannello amministrativo



== Accesso alla Dashboard Qualivision ==

La Dashboard Qualivision è raggiungibile da:

   http://localhost:8000

Il pannello amministrativo è raggiungibile da:

   http://localhost:8000/admin


L'accesso a Grafana viene gestito tramite proxy dalla Dashboard Qualivision verso http://localhost:8000/dash-configurator/...



== Accesso alla configurazione Grafana ==

Per accedere alla configurazione Grafana utilizzare il pulsante:

   Dashboard Configurazione

presente nel pannello amministrativo della Dashboard Qualivision.

Da questa pagina è possibile accedere alla configurazione Grafana.



== Configurazione Data Source Grafana ==

Le Data Source devono essere configurate manualmente dopo il ripristino della configurazione Grafana.

1) Accedere al pannello amministrativo:

   http://localhost:8000/admin

2) Dashboard Configurazione

3) Accedere alla sezione connessioni, vedi datasources configurate di Grafana.

4) Creare o verificare le connessioni Microsoft SQL Server.

5) Configurare server, database e metodo di autenticazione.

6) Premere:

   Save & Test

7) Verificare che il test sia positivo.



== Funzionamento Dashboard Qualivision ==

La Dashboard Qualivision è una pagina web locale che mostra le dashboard Grafana all'interno della stessa interfaccia.

La Dashboard Qualivision non contiene direttamente i grafici, ma carica le dashboard create in Grafana tramite proxy.

La struttura è composta da:

- stazioni
- sottopagine
- dashboard Grafana associate
- parametri Grafana
- lingue
- impostazioni generali



== Configurazione Dashboard Qualivision ==

La configurazione della Dashboard Qualivision non deve essere modificata manualmente nei file JSON.

Tutte le modifiche devono essere effettuate dal pannello amministrativo:

   http://localhost:8000/admin

Dal pannello amministrativo è possibile configurare:

- stazioni
- sottopagine
- dashboard Grafana associate
- parametri Grafana
- indirizzo Grafana
- aggiornamento automatico
- lingue
- lingua di default



== Configurazione Stazioni ==

Una stazione rappresenta una voce principale nel menu laterale.

Per ogni stazione è possibile configurare:

- nome
- codice / id
- descrizione
- abilitazione
- sottopagina di default

Il nome è quello visualizzato nella Dashboard Qualivision.



== Configurazione Sottopagine ==

Una sottopagina rappresenta una tab nella parte alta della Dashboard Qualivision.

Per ogni sottopagina è possibile configurare:

- nome
- codice / id
- dashboard Grafana associata
- parametri Grafana
- abilitazione

Il nome è quello visualizzato nella tab.

La dashboard Grafana associata viene indicata tramite il codice della dashboard Grafana.



== Come ricavare il codice della dashboard Grafana ==

Il codice della dashboard Grafana deve essere ricavato dall'URL della dashboard.

1) Accedere alla configurazione Grafana dal pannello amministrativo.

2) Aprire la dashboard desiderata.

3) Osservare l'URL del browser.

Esempio:

   /dash-configurator/d/ad4n2j4/dashboard-statistiche

In questo caso il codice della dashboard è:

   ad4n2j4


== Configurazione Parametri Grafana ==

I parametri Grafana permettono di passare variabili alla dashboard.

Esempio:

   var-idStazione=1

Se sono necessari più parametri, separarli con punto e virgola.

Esempio:

   var-idStazione=1;var-linea=2

Se il nome della variabile su grafana è: "idStazione" la variabile si chiamerà "var-idStazione"



== Configurazione Lingue ==

Le lingue vengono configurate dal pannello amministrativo.

Per ogni lingua devono essere indicati:

- codice lingua
- descrizione visualizzata

Esempio:

   it - Italiano
   en - English
   fr - Francese

Il codice lingua deve corrispondere al codice utilizzato nel database.


La variabile lingua Grafana deve corrispondere alla variabile configurata nella dashboard Grafana.

Esempio:

   var-lang

In questo caso in Grafana deve esistere una variabile chiamata:

   lang



== Report PDF ==

La Dashboard Qualivision include la funzione di generazione report PDF.

Il report viene generato partendo dalla pagina Grafana attualmente visualizzata.

Se l'utente cambia tab, filtri, lingua o intervallo temporale, il PDF viene generato usando la vista attualmente selezionata.

La generazione PDF utilizza Playwright e Chromium installati tramite install.bat lato backend.



== Verifica finale ==

1) Aprire:

   http://localhost:8000

2) Verificare che la Dashboard Qualivision si apra correttamente.

3) Verificare la presenza delle stazioni.

4) Verificare la presenza delle sottopagine.

5) Verificare il caricamento delle dashboard Grafana.

6) Verificare le Data Source.

7) Verificare il cambio lingua, se previsto.

8) Verificare la generazione del report PDF.

9) Verificare il corretto aggiornamento automatico dei dati.