Configurare Grafana per visualizzare le metriche generate dal cluster dell'istanza gestita

Articolo
10/26/2023

Quando si distribuisce un Istanza gestita di Azure per un cluster Apache Cassandra, il servizio effettua il provisioning del software agente di Raccolta metriche per Apache Cassandra in ogni nodo dati. Le metriche possono essere usate da Prometheus e visualizzate tramite Grafana. Questo articolo descrive come configurare Prometheus e Grafana per visualizzare le metriche generate dal cluster di istanza gestita.

Per visualizzare le metriche sono necessarie le attività seguenti:

Distribuire una macchina virtuale Ubuntu all'interno del Rete virtuale di Azure in cui è presente l'istanza gestita.
Installare i dashboard di Prometheus nella macchina virtuale.

Avviso

Prometheus e Grafana sono software open source e non sono supportati come parte del servizio Azure Istanza gestita per Apache Cassandra. La visualizzazione delle metriche nel modo descritto di seguito richiederà di ospitare e gestire una macchina virtuale come server sia per Prometheus che per Grafana. Le istruzioni seguenti sono state testate solo per Ubuntu Server 18.04, non c'è alcuna garanzia che funzionino con altre distribuzioni linux. Seguendo questo approccio sarà necessario supportare eventuali problemi che possono verificarsi, ad esempio l'esaurimento dello spazio o la disponibilità del server. Per un'esperienza di metriche completamente supportata e ospitata, è consigliabile usare le metriche di Monitoraggio di Azure o in alternativa le integrazioni dei partner di Monitoraggio di Azure.

Distribuire un server Ubuntu

Accedere al portale di Azure.
Passare al gruppo di risorse in cui si trova il cluster dell'istanza gestita. Selezionare Aggiungi e cercare l'immagine Ubuntu Server 18.04 LTS:
Selezionare l'immagine e selezionare Crea.
Nel pannello Crea una macchina virtuale immettere i valori per i campi seguenti, è possibile lasciare i valori predefiniti per gli altri campi:
- Nome macchina virtuale: immettere un nome per la macchina virtuale.
- Area: selezionare la stessa area in cui è stata distribuita la Rete virtuale.
Nella scheda Rete selezionare il Rete virtuale in cui viene distribuita l'istanza gestita:
Infine, selezionare Rivedi e crea per creare il server Metriche.

Installare i dashboard di Prometheus

Verificare prima di tutto che le impostazioni di rete per il server Ubuntu appena distribuito dispongano di regole di porta in ingresso che consentono porte 9090 e 3000. Questi saranno necessari successivamente per Prometheus e Grafana rispettivamente.
Connessione al server Ubuntu usando Interfaccia della riga di comando di Azure o lo strumento client preferito per connettersi tramite SSH.

Dopo la connessione alla macchina virtuale, è necessario installare il software dell'agente di raccolta metriche. Prima di tutto, scaricare e decomprimere i file:

 #install unzip utility (if not already installed)
 sudo apt install unzip

 #get dashboards
 wget https://github.com/datastax/metric-collector-for-apache-cassandra/releases/download/v0.3.0/datastax-mcac-dashboards-0.3.0.zip -O temp.zip
 unzip temp.zip

Passare quindi alla directory prometheus e usare vi per modificare il tg_mcac.json file:
```
 cd */prometheus
 vi tg_mcac.json    
```
Aggiungere gli indirizzi IP di ogni nodo nel cluster in targets, ognuno con la porta 9443. Il tg_mcac.json file dovrebbe essere simile al seguente:
```
 [
   {
     "targets": [
       "10.9.0.6:9443","10.9.0.7:9443","10.9.0.8:9443"
     ],
     "labels": {

     }
   }
 ]  
```
Salvare il file. Modificare quindi il prometheus.yaml file nella stessa directory. Individuare la sezione seguente:
```
 file_sd_configs:
   - files:
     - 'tg_mcac.json'
```
Direttamente sotto questa sezione, aggiungere quanto segue. Questa operazione è necessaria perché le metriche vengono esposte tramite https.
```
 scheme: https
 tls_config:
         insecure_skip_verify: true
```

Il file dovrebbe ora essere simile al seguente. Verificare che le schede in ogni riga siano le seguenti.

 file_sd_configs:
   - files:
     - 'tg_mcac.json'
 scheme: https
 tls_config:
         insecure_skip_verify: true

Salvare il file. A questo punto si è pronti per avviare Prometheus e Grafana. Prima di tutto, installare Docker:

sudo apt install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu `lsb_release -cs` test"
sudo apt update
sudo apt install docker-ce

Installare quindi docker compose:
```
sudo apt install docker-compose
```
Passare ora alla directory di primo livello in cui docker-compose.yaml si trova e avviare l'applicazione:
```
cd ..
sudo docker-compose up
```
Prometheus deve essere disponibile nella porta 9090e i dashboard di Grafana sulla porta 3000 nel server delle metriche:

Passaggi successivi

In questo articolo si è appreso come configurare i dashboard per visualizzare le metriche in Prometheus usando Grafana. Altre informazioni su Azure Istanza gestita per Apache Cassandra con gli articoli seguenti:

Share via

Configurare Grafana per visualizzare le metriche generate dal cluster dell'istanza gestita

Distribuire un server Ubuntu

Installare i dashboard di Prometheus

Passaggi successivi

Risorse aggiuntive