Condividi tramite


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

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

  1. Accedere al portale di Azure.

  2. 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:

    Trovare l'immagine del server Ubuntu dal portale di Azure.

  3. Selezionare l'immagine e selezionare Crea.

  4. 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.

    Compilare il modulo per creare una macchina virtuale con l'immagine del server Ubuntu.

  5. Nella scheda Rete selezionare il Rete virtuale in cui viene distribuita l'istanza gestita:

    Configurare le impostazioni di rete del server Ubuntu.

  6. Infine, selezionare Rivedi e crea per creare il server Metriche.

Installare i dashboard di Prometheus

  1. 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.

    Consenti porte

  2. Connettersi al server Ubuntu usando l'interfaccia della riga di comando di Azure o lo strumento client preferito per connettersi tramite SSH.

  3. 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
    
  4. Passare quindi alla directory prometheus e usare vi per modificare il tg_mcac.json file:

     cd */prometheus
     vi tg_mcac.json    
    
  5. 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": {
    
         }
       }
     ]  
    
  6. Salvare il file. Modificare quindi il prometheus.yaml file nella stessa directory. Individuare la sezione seguente:

     file_sd_configs:
       - files:
         - 'tg_mcac.json'
    
  7. 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
    
  8. 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
    
  9. 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
    
  10. Installare quindi docker compose:

    sudo apt install docker-compose
    
  11. Passare ora alla directory di primo livello in cui docker-compose.yaml si trova e avviare l'applicazione:

    cd ..
    sudo docker-compose up
    
  12. Prometheus deve essere disponibile nella porta 9090e i dashboard di Grafana sulla porta 3000 nel server delle metriche:

    Visualizzare le metriche dell'istanza gestita di Cassandra nel dashboard.

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: