Importare una dashboard
I file forniti includono una dashboardG configurata per avere a disposizione tutti i microservizi in esecuzione nella stessa macchina.
Tale dashboardG è automaticamente importata all'avvio del Sistema. Qualora non lo fosse, è possibile seguire questi passaggi.
Anzitutto recarsi nella sezione DashboardsG di GrafanaG, selezionando l'apposita opzione nella barra laterale sinistra, come mostrato in figura:
Procedere dunque ad importare la dаshboard caricando l'apposito file JSON che è possibile trovare in /containers/dashboards/json della cartella di installazione. La pagina di importazione è simile alla figura che segue:
Modificare una dashbоard
Selezionare anzitutto la dashboаrd appena importata come mostrato in figura:
A questo punto, è possibile aggiungere i log e le misurazioni del microservizio.
Attivare anzitutto la modifica della dаshboard corrente premendo il tasto Edit, come mostrato nella figura che segue:
Premere quindi il tasto Add e quindi Visualization
A questo punto il processo differisce in base all'aggiunta di log e misurazioni, per cui si consiglia di seguire i paragrafi successivi.
Aggiungere una finestra di log
Dalla finestra che si apre, selezionare, dal menu a tendina vicino la voce Data source, la voce Loki.
Selezionare ora il menu a tendina indicato dalla figura che segue:
Cercare e selezionare Logs.
Dalla Sezione Label filters, selezionare la voce Select label e, dal menu a tendina, la voce service_name.
Premere ora su Select value, quindi selezionare il servizio di interesse. Per una rapida individuazione, i nomi sono nella forma che segue:
github.com/alimitedgroup/MVP/srv/nome_servizio#servizio
dove
- nome_servizio è il nome del servizio;
- #servizio è l'id assegnato al servizio (vedere la Sezione relativa alla configurazione del Sistema).
Un esempio è riportato nella figura che segue:
Attenzione: il servizio potrebbe comparire nella solo nel momento in cui viene fornito il primo output.
Premere quindi Run query e Save dаshboard per sincronizzare i dati e salvare le modifiche.
Il pannello è stato aggiunto: premere Back to dashboаrd per visualizzarlo.
Aggiungere una misurazione
Dopo l'apertura del menu di aggiunta visualizzazione, il campo Data source presente nella parte inferiore dovrebbe essere già popolato con Prometheus: se così non fosse selezionarlo similmente a quanto fatto con Loki.
Premere quindi sul menu Select metric, quindi su Metrics explorer.
Cercare, nella finestra successiva, la metrica di interesse, quindi premere sul bottone mostrato in figura:
Attenzione: la metrica potrebbe non apparire se non è mai stata fatta una misurazione a riguardo.
Premere quindi su Select label e, nel menu che si apre, premere Job.
Premere ora su Select value e premere sul servizio di interesse. Per una rapida individuazione, i nomi sono nella forma che segue:
github.com/alimitedgroup/MVP/srv/nome_servizio#servizio
dove
- nome_servizio è il nome del servizio;
- #servizio è l'id assegnato al servizio (vedere la Sezione relativa alla configurazione del Sistema).
Un esempio è riportato nella figura che segue:
Attenzione: il servizio potrebbe comparire nella solo nel momento in cui viene fornita una prima misurazione.
Premere quindi Run query e Save dаshboard per sincronizzare i dati e salvare le modifiche.
Il pannello è stato aggiunto: premere Back to dashboаrd per visualizzarlo.