Come installare Grafana su Saplo (dashboard e monitoraggio)

Grafana Cloud con un piano a pagamento può costare ben oltre 100 € al mese, ancora prima di collegare la prima fonte di dati, perché il conteggio dipende dal numero di serie di metriche e dalla durata della loro conservazione. Grafana OSS è esattamente lo stesso motore open source per grafici e alert, che installi sul tuo Box in un'unica soluzione, senza una fattura mensile che dipende da quante metriche raccogli. Qui sotto, passo dopo passo, come installare Grafana su Saplo.

Perché Grafana sul tuo Box invece di Grafana Cloud

I piani a pagamento di Grafana Cloud hanno due caratteristiche che risultano particolarmente problematiche quando si monitorano molti progetti contemporaneamente:

• un costo che cresce con il numero di metriche e il loro tempo di conservazione - più server e applicazioni monitori e più a lungo vuoi conservare lo storico, più alta sarà la fattura mensile,
• il limite del piano gratuito, che prima o poi verrà superato - il piano gratuito è sufficiente per un piccolo progetto, non per gestire più clienti contemporaneamente.

Grafana OSS è lo stesso motore che installi sul tuo Box. Nessun costo legato al numero di metriche, i dati di telemetria rimangono sulla tua infrastruttura e l'aspetto e la logica per creare dashboard sono identici a quelli della versione cloud.

Requisiti

Per installare Grafana su Saplo, ti servono:

• Box con Docker attivo (il motore lo avvia automaticamente durante l'installazione dal Catalogo delle applicazioni, è necessario il nesting nel container, che Saplo include per impostazione predefinita),
• almeno 512 MB di RAM disponibili sul Box e 2 GB di spazio su disco per il database interno,
• domini o sottodomini *.saploapp.pl inclusi nel prezzo di ogni piano.

Vale la pena distinguere subito cosa sia e cosa non sia Grafana. Di per sé, Grafana non raccoglie alcuna metrica: è esclusivamente un motore di grafici, dashboard e alert. La sorgente dati, ad esempio Prometheus che raccoglie metriche dai server, InfluxDB con dati temporali o un normale database MySQL o Postgres con tabelle da analizzare, la colleghi manualmente dopo il primo avvio, nella scheda Connections. Grafana su Saplo conserva i propri dati, cioè dashboard salvati, account utente e configurazione delle sorgenti, in un database SQLite separato all'interno del volume dei dati, quindi per l'installazione stessa non ti serve alcun database esterno.

Installazione passo dopo passo

1. Nel Pannello Saplo accedi al Catalogo delle applicazioni e seleziona Grafana (categoria "Dati").
2. Indica su quale Box installarla e il dominio o sottodominio sotto cui l'applicazione sarà disponibile.
3. Conferma l'installazione. Il motore avvia un container Docker con l'immagine ufficiale grafana/grafana-oss, prepara un volume per i dati, genera un account amministratore casuale e pubblica il pannello sul dominio indicato tramite nginx con SSL gratuito.
4. Il motore attende che Grafana risponda effettivamente alla richiesta di controllo dello stato di salute prima di considerare completata l'installazione, quindi, se l'immagine non si avvia, vedrai un errore invece di un dominio non funzionante.
5. Al termine, nel Catalogo delle applicazioni della Box troverai il file GRAFANA-SETUP.txt con il login e la password generata per il pannello.

Prima configurazione

Grafana, proprio come MinIO o Vaultwarden, genera automaticamente un account amministratore durante l'installazione, invece di chiederne uno tramite una procedura guidata.

1. Accedi al Pannello con i dati presenti nel file GRAFANA-SETUP.txt e cambia la password in Administration -> Users, prima di fare qualsiasi altra cosa, soprattutto se condividi l'accesso con il team.
2. Aggiungi la prima sorgente dati in Connections -> Data sources. Grafana supporta, tra gli altri, Prometheus, InfluxDB, MySQL, PostgreSQL, Elasticsearch e Loki. L'elenco delle sorgenti supportate è disponibile nella documentazione ufficiale di Grafana.
3. Dopo aver collegato una sorgente, crea il primo dashboard in Dashboards -> New, oppure importa un modello pronto dalla galleria di Grafana, se stai monitorando un servizio popolare, ad esempio un server nginx o un database Postgres.
4. Configura gli alert in Alerting, se vuoi ricevere una notifica quando una metrica supera una soglia prestabilita, ad esempio quando l'utilizzo del disco supera il 90 percento.

Grafana su Saplo contro Grafana Cloud

Domande frequenti

Grafana raccoglie da sola le metriche o serve qualcos'altro? Grafana non raccoglie nulla di per sé, è soltanto un motore di grafici e avvisi. Le metriche vengono fornite da una fonte dati separata, per esempio Prometheus o un database SQL, che colleghi manualmente dopo l'installazione nella scheda Connections.

Quali fonti dati posso collegare? Grafana supporta, tra gli altri, Prometheus, InfluxDB, MySQL, PostgreSQL, Elasticsearch e Loki. L'elenco completo dei plugin è disponibile nel pannello quando aggiungi una nuova fonte dati.

Posso monitorare il Box su cui è in esecuzione Grafana? Sì, ma serve un'applicazione separata che raccoglie le metriche di sistema, per esempio Prometheus con l'exporter appropriato, e che colleghi come fonte dati. La sola installazione di Grafana non raccoglie queste metriche.

I dati in Grafana vengono automaticamente salvati come backup? Dipende dal piano Box acquistato. Il backup funziona a livello dell'intero Box, come per le altre applicazioni del catalogo, e non è una funzione separata di Grafana.

Posso avere più di una dashboard e più utenti? Sì, il numero di dashboard e di account utente non è limitato da Grafana OSS. L'unico limite sono le risorse del piano Box acquistato.

Se hai domande mentre installi Grafana sul tuo Box o colleghi la prima fonte dati, scrivici: ti aiuteremo con la configurazione iniziale.