Truedoc

h1. Installare e configurare Grafana

Installare il pacchetto con prima aggiungendo una source list (ad esempio in @/etc/apt/sources.list.d/grafana.list@) come:

<pre>

deb https://packagecloud.io/grafana/stable/debian/ jessie main

</pre>

e poi eseguendo:

<pre>

apt-get install grafana

</pre>

verrà installato il programma, questo creerà le sue credenziali di accesso (il default è admin/admin) all'avvio, che deve essere eseguito esplicitamente, in particolare è necessario eseguire:

<pre>

systemctl daemon-reload

systemctl enable grafana-server

</pre>

per avviarlo: 

<pre>

systemctl start grafana-server

</pre>

se si vogliono cambiare le credenziali prima di avviarlo, occorre modificare @/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>

Inoltre conviene predisporre un reverse proxy, fare ascoltare grafana solo su localhost (il default è ovunque) 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>