Partager via


Configurer Grafana pour visualiser les métriques émises à partir du cluster d’instance managée

Lorsque vous déployez une instance managée Azure pour un cluster Apache Cassandra, le service provisionne metrics Collector pour le logiciel de l’agent Apache Cassandra sur chaque nœud de données. Prometheus consomme les métriques et elles sont visualisées via Grafana. Cet article explique comment configurer Prometheus et Grafana pour visualiser les métriques émises à partir du cluster Managed Instance.

Les tâches suivantes sont nécessaires pour visualiser les métriques :

  • Déployez une machine virtuelle Ubuntu à l’intérieur du réseau virtuel Azure où l’instance managée est présente.
  • Installez les tableaux de bord Prometheus sur la machine virtuelle.

Avertissement

Prometheus et Grafana sont des logiciels open source et ne sont pas pris en charge dans le cadre d’Azure Managed Instance pour Apache Cassandra. La visualisation des métriques décrites dans cet article vous oblige à héberger et à gérer une machine virtuelle en tant que serveur pour Prometheus et Grafana. Les instructions de cet article ont été testées uniquement pour Ubuntu Server 18.04. Il n’existe aucune garantie qu’ils fonctionnent avec d’autres distributions Linux.

En suivant cette approche, vous devez prendre en charge tous les problèmes qui peuvent survenir, tels que l’épuisement de l’espace ou la disponibilité du serveur. Pour une expérience de métriques entièrement prise en charge et hébergée, envisagez d’utiliser des métriques Azure Monitor ou des intégrations de partenaires Azure Monitor.

Déployer un serveur Ubuntu

  1. Connectez-vous au portail Azure.

  2. Accédez au groupe de ressources où se trouve votre cluster d’instances managées. Sélectionnez Ajouter et rechercher l’image Ubuntu Server 18.04 LTS .

    Capture d’écran montrant la recherche de l’image du serveur Ubuntu à partir du portail Azure.

  3. Sélectionnez l’image, puis sélectionnez Créer.

  4. Dans le volet Créer une machine virtuelle , entrez des valeurs pour les champs suivants. Vous pouvez conserver les valeurs par défaut pour d’autres champs :

    • Nom de la machine virtuelle : entrez un nom pour votre machine virtuelle.
    • Région : sélectionnez la même région que celle où votre réseau virtuel est déployé.

    Capture d’écran montrant le remplissage du formulaire pour créer une machine virtuelle avec l’image du serveur Ubuntu.

  5. Sous l’onglet Mise en réseau, sélectionnez le réseau virtuel dans lequel votre instance managée est déployée.

    Capture d’écran montrant la configuration des paramètres réseau du serveur Ubuntu.

  6. Enfin, sélectionnez Vérifier + créer pour créer votre serveur de métriques.

Installer des tableaux de bord Prometheus

  1. Tout d’abord, vérifiez que les paramètres réseau de votre serveur Ubuntu nouvellement déployé ont des règles de port entrantes qui autorisent les ports 9090 et 3000. Ces ports sont requis ultérieurement pour Prometheus et Grafana, respectivement.

    Capture d’écran montrant les ports autorisés.

  2. Connectez-vous à votre serveur Ubuntu à l’aide d’Azure CLI ou de votre outil client préféré pour vous connecter via Secure Shell.

  3. Après vous être connecté à la machine virtuelle, installez le logiciel collecteur de métriques. Tout d’abord, téléchargez et décompressez les fichiers :

     #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. Ensuite, accédez au répertoire Prometheus et utilisez vi pour modifier le tg_mcac.json fichier :

     cd */prometheus
     vi tg_mcac.json    
    
  5. Ajoutez les adresses IP de chaque nœud dans votre cluster targets, chacune avec le port 9443. Votre tg_mcac.json fichier doit ressembler à l’exemple suivant :

     [
       {
         "targets": [
           "10.9.0.6:9443","10.9.0.7:9443","10.9.0.8:9443"
         ],
         "labels": {
    
         }
       }
     ]  
    
  6. Enregistrez le fichier. Ensuite, modifiez le fichier prometheus.yaml dans le même répertoire. Recherchez la section suivante :

     file_sd_configs:
       - files:
         - 'tg_mcac.json'
    
  7. Directement sous cette section, ajoutez l’extrait de code suivant. Cette étape est requise, car les métriques sont exposées via HTTPS.

     scheme: https
     tls_config:
             insecure_skip_verify: true
    
  8. Le fichier doit maintenant ressembler à l’exemple suivant. Vérifiez que les onglets de chaque ligne correspondent à l’exemple :

     file_sd_configs:
       - files:
         - 'tg_mcac.json'
     scheme: https
     tls_config:
             insecure_skip_verify: true
    
  9. Enregistrez le fichier. Vous pouvez maintenant démarrer Prometheus et Grafana. Commencez par installer 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. Installez docker-composeensuite :

    sudo apt install docker-compose
    
  11. Accédez maintenant au répertoire de niveau supérieur où docker-compose.yaml se trouve l’application et démarrez l’application :

    cd ..
    sudo docker-compose up
    
  12. Prometheus doit être disponible au niveau du port 9090 et des tableaux de bord Grafana sur le port 3000 sur votre serveur de métriques.

    Affichez les métriques d’instance managée Cassandra dans le tableau de bord.

Dans cet article, vous avez appris à configurer des tableaux de bord pour visualiser les métriques dans Prometheus à l’aide de Grafana. Explorez plus en détail Azure Managed Instance pour Apache Cassandra avec les articles suivants :