====== Grafana: installation ======

Si vous êtes ici c'est que vous savez ce qu'est grafana: une solution de présentation graphique de métrique supervisé. Ici on ne va traiter que de l'aspect installation… pas de son utilisation.

Je suppose qu'on utilise une base Debian comme serveur et qu'on fait au plus simple!

===== Installation des paquets =====

[[https://grafana.com/docs/grafana/latest/setup-grafana/installation/debian/|https://grafana.com/docs/grafana/latest/setup-grafana/installation/debian/]]

Après un update du repository ave apt
<code>

sudo apt update

</code>

On installe les prérequis avec

<code>
sudo apt-get install -y apt-transport-https software-properties-common wget

</code>

On ajoute la key pour ajouter le dépôt de grafana

<code>
sudo mkdir -p /etc/apt/keyrings/
wget -q -O - https://apt.grafana.com/gpg.key | gpg --dearmor | sudo tee /etc/apt/keyrings/grafana.gpg> /dev/null

</code>

On ajoute le dépôt de la version stable dans apt
<code>

echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list

</code>

On récupère les paquets didponibles du dépôt de grafana
<code>

sudo apt-get update

</code>

Et enfin on installe la version Entreprise de grafana (version complète et recommandée)

<code>
sudo apt-get install grafana-enterprise

</code>

===== Démarrage du service grafana =====

[[https://grafana.com/docs/grafana/latest/setup-grafana/start-restart-grafana/|https://grafana.com/docs/grafana/latest/setup-grafana/start-restart-grafana/]]

On lance le service
<code>

sudo systemctl daemon-reload
sudo systemctl start grafana-server

</code>

On controle que le service est au vert et a bien démarré.

<code>
sudo systemctl status grafana-server

</code>

Si c'est bon on peut activer le démarrrage automatique à chaque reboot de la machine.

<code>
sudo systemctl enable grafana-server.service

</code>

Et voilà, grafana est installé ! Connectez vous sur le serveur grafana sur le port par défaut 3000 en http avec votre navigateur web préféré.

[[http://mon_serveur:3000|http://mon_serveur:3000]]

===== Bonus =====

https://grafana.com/tutorials/run-grafana-behind-a-proxy/

Si comme moi vous avez sur le même serveur grafana,icinga et nagvis et que vous voulez avoir la meme forme d'url pour vous conneter au application sous la forme:

[[https://mon_serveur/inciga|https://mon_serveur/inciga]]

[[https://mon_serveur/nagvis|https://mon_serveur/nagvis]]

[[https://mon_serveur/grafana|https://mon_serveur/grafana]]

alors voici la méthode pour ne pas à modifier le port d'écoute par défaut.

Activation du sub path dans /etc/grafana/grafana.ini
<code>

root_url = %(protocol)s://%(domain)s:%(http_port)s/grafana

</code>

Mis en place du reverse proxy en créant un fichier VirtualHost

<code>
vi /etc/apache2/sites-available/apache2-grafana.conf

</code>

On y met:

<code>
<VirtualHost *:80>
    ServerName monServeurName

    RewriteEngine On
    RewriteCond %{HTTPS} off
    RewriteRule ^/grafana/(.*) https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>

<VirtualHost *:443>
    ProxyPreserveHost On
    ProxyPass /grafana http://127.0.0.1:3000
    ProxyPassReverse /grafana http://127.0.0.1:3000

    SSLEngine On

    SSLCertificateFile /etc/ssl/certs/ssl-cert-snakeoil.pem
    SSLCertificateKeyFile /etc/ssl/private/ssl-cert-snakeoil.key
</VirtualHost>

</code>