Progetto

Generale

Profilo

Grafana » Cronologia » Versione 2

Versione 1 (Simone Piccardi, 26-06-2018 12:40) → Versione 2/4 (Simone Piccardi, 26-06-2018 13:23)

h1. Installare e configurare Grafana 

 Grafana (https://grafana.com/) è una piattaforma molto avanzata per l'analsi e la visualizzazione di dati, quelle che seguono sono le istruzioni per installarla su una Debian (da jessie in poi). Si utilizzeranno i pacchetti forniti direttamente dal progetto, che mette a disposizione un repository specifico per Debian, continuamente aggiornato. Per installare Installare il pacchetto occorre con prima aggiungere la sorgente fornita dal progetto aggiungendo una source list (ad esempio in @/etc/apt/sources.list.d/grafana.list@) con contenuto: come: 

 <pre> 
 deb https://packagecloud.io/grafana/stable/debian/ stretch jessie main 
 </pre> 

 (si indichi la propria versione di Debian al posto di @stretch@); si dovrà inoltre caricare la chiave GPG che firma il repository (per evitare gli avvisi di APT) con: 

 <pre> 
 curl https://packagecloud.io/gpg.key | sudo apt-key add - 
 </pre> 

 inoltre perché il download abbia successo (i pacchetti sono forniti sotto https) è necessario che sia installato il pacchetto @apt-transport-https@.  

 Una volta completati i precedenti preliminari lo si potrà installare e poi eseguendo: 

 <pre> 
 apt-get update 
 apt-get install grafana 
 </pre> 

 Il programma viene soltanto installato, non viene avviato ne inserito nella sequenza di avvio. Inoltre Grafana verrà installato il programma, questo creerà le sue credenziali di accesso (il default è admin/admin) al primo avvio, all'avvio, che deve essere eseguito esplicitamente, pertanto per poterlo utilizzare in particolare è necessario eseguire: 

 <pre> 
 systemctl daemon-reload 
 systemctl enable grafana-server 
 </pre> 

 e per per avviarlo:  

 <pre> 
 systemctl start grafana-server 
 </pre> 

 Se se si vogliono cambiare le credenziali prima di avviarlo, occorre modificare il file di configurazione @/etc/grafana/grafana.ini@ cambiando le righe: 

 <pre> 
 # default admin user, created on startup 
 ;admin_user = admin 

 # default admin password, can be changed before first start of grafana, or in profile settings  
 ;admin_password = admin 
 </pre> 

 In questa maniera si potrà raggiungere il servizio collegandosi alla porta 3000, ma in genere Inoltre conviene predisporre un reverse proxy e proxy, fare ascoltare grafana solo su localhost (il default è ovunque) per e redirigere sullo stesso le connessioni usando un indirizzo pubblico gestito da un server web con gli opportuni virtual host, per questo occorre impostare:  

 <pre> 
 # The ip address to bind to, empty will bind to all interfaces 
 http_addr = 127.0.0.1 
 </pre> 

 inoltre per avere un indirizzo corretto inviato verso l'esterno si dovrà impostare la URL con cui si accede al servizio con: 

 <pre> 
 # The full public facing url you use in browser, used for redirects and emails 
 # If you use reverse proxy and sub path specify full url (with sub path) 
 ;root_url = http://localhost:3000 
 root_url = https://grafana.miosito.it 
 </pre> 


 Occorre poi configurare il reverse proxy, ad esempio con Nginx si può creare un virtual host sotto @/etc/nginx/sites-available/grafana@ con una configurazione del tipo: 

 <pre> 
 upstream grafana { 
         server 127.0.0.1:3000; 
 } 
 server { 
    listen 443 ssl; 
    server_name grafana.miosito.it; 
    root /var/www/html; 
    ssl_certificate /etc/ssl/certs/ssl-cert-snakeoil.pem; 
    ssl_certificate_key /etc/ssl/private/ssl-cert-snakeoil.key; 
    location / { 
       proxy_pass http://grafana; 
       client_max_body_size 20m; 
       proxy_http_version 1.1; 
       proxy_pass_header Server; 
       proxy_set_header Host $http_host; 
       proxy_redirect off; 
       proxy_set_header X-Real-IP $remote_addr; 
       proxy_set_header X-Scheme $scheme; 
       proxy_set_header X-Forwarded-Proto $scheme; 
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 
       } 
 } 
 </pre> 

 e per usarlo creare in link simbolico verso lo stesso su @/etc/nginx/sites-enabled/grafana@ e riavviare Ngnix con @service nginx restart@. 

 Per avere un corretto funzionamento delle notifiche per posta elettronica (usate per inviare gli inviti agli utenti) deve essere configurata la sezione @[smtp]@ del file di configurazione, definendo: 

 <pre> 
 enabled = true 
 host = localhost:25 
 from_address = admin@grafana.miosito.it 
 </pre>