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

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.