Installation du tableau de bord de surveillance bêta

Edge for Private Cloud v. 4.17.05

Configuration requise

Vous devez installer apigee-telegraf sur tous les nœuds Edge pour collecter les données du tableau de bord. Par conséquent, la configuration système requise pour apigee-telegraf est la même que pour le nœud Edge sur lequel vous l'installez.

Vous pouvez installer apigee-grafana sur un nœud distinct ou réutiliser l'un des nœuds Edge existants, tels que le serveur de gestion ou le nœud de l'interface utilisateur Edge.

Pour apigee-influxdb, vous pouvez l'installer sur un nœud Edge existant, tel que le nœud du serveur de gestion ou le nœud de l'interface utilisateur Edge, sans modifier la configuration système requise.

Si vous décidez d'installer apigee-influxdb sur son propre nœud pour des raisons de performances, le nœud doit répondre aux exigences suivantes :

• Processeur à 2 cœurs
• 4 Go de RAM
• 250 Go d'espace disque (les données de surveillance sont purgées après un mois)
• 1 000 IOPS ou plus

Pour en savoir plus, consultez la documentation InfluxData.

Exigences de port pour apigee-influxdb

Les ports 8086 et 8183 doivent être ouverts sur les nœuds de données apigee-influxdb pour permettre l'accès par le nœud exécutant apigee-grafana et apigee-telegraf.

Fichiers de configuration pour l'installation des composants du tableau de bord

Pour installer les composants apigee-telegraf et apigee-grafana, vous devez transmettre un fichier de configuration à l'utilitaire apigee-service. Stockez ces fichiers dans un répertoire accessible par l'utilisateur "apigee", tel que /opt/apigee/customer/application, et faites en sorte qu'ils appartiennent à l'utilisateur "apigee".

Paramètres de configuration pour apigee-telegraf

Définissez ces propriétés dans un fichier texte que vous transmettez à la commande setup d'apigee-telegraf. Par exemple, définissez-les dans un fichier texte nommé sa_telegraf.txt :

http://192.168.0.1:8086

Paramètres de configuration pour apigee-grafana

Définissez ces propriétés dans un fichier texte que vous transmettez à la commande apigee-grafana setup. Par exemple, définissez-les dans un fichier texte nommé sa_grafana.txt :

192.168.0.1

Instructions d'installation

Suivez les instructions ci-dessous pour installer les composants du tableau de bord dans l'ordre suivant :

• apigee-influxdb (sur un nœud central)
• apigee-telegraf (sur chaque nœud)
• apigee-grafana (sur un serveur central)

Installer apigee-influxdb sur un seul nœud Edge ou un nœud autonome

Sur un nœud autonome ou un nœud Edge exécutant le serveur de gestion ou l'interface utilisateur Edge :

1. Installez apigee-influxdb :
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
2. Configurez la base de données apigee-influxdb :
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
3. Démarrez apigee-influxdb :
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

Installer apigee-telegraf sur chaque nœud Edge

Sur chaque nœud de votre installation Edge :

1. Sur votre premier nœud Edge, installez apigee-telegraf :
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
2. Créez un fichier de configuration pour apigee-telegraf nommé sa_telegraf.txt. En règle générale, vous stockez ce fichier dans un répertoire accessible par l'utilisateur "apigee", tel que /opt/apigee/customer/application, et vous le rendez accessible par l'utilisateur "apigee".
   
   Définissez la propriété suivante dans le fichier pour spécifier l'URL du nœud apigee-influxdb, y compris le port 8086 :
   INFLUXDB_URL=http://influx_IP:8086
3. Remplacez le propriétaire par "apigee" :
   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
4. Configurez apigee-telegraf :
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
5. Redémarrez apigee-telegraf :
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
6. Répétez cette procédure sur tous les nœuds Edge.

Installer apigee-grafana sur un seul nœud Edge

Sur un seul nœud de votre installation Edge, tel que le nœud de l'UI Edge :

1. Sur votre premier nœud Edge, installez apigee-grafana :
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
2. Créez un fichier de configuration pour apigee-grafana nommé sa_grafana.txt. En règle générale, vous stockez ce fichier dans un répertoire accessible par l'utilisateur "apigee", tel que /opt/apigee/customer/application, et vous le rendez accessible par l'utilisateur "apigee".
   
   Définissez les propriétés suivantes dans le fichier. Ces propriétés sont décrites ci-dessus :
   INFLUXDB_HOST=192.168.56.101
   INFLUXDB_PORT=8086
   GRAFANA_USERNAME=admin
   GRAFANA_PASSWORD=admin
3. Remplacez le propriétaire par "apigee" :
   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
4. Configurez apigee-grafana à l'aide du fichier de configuration :
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
5. Redémarrez apigee-grafana :
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

Pour accéder au tableau de bord, ouvrez l'URL suivante dans un navigateur :

http://grafana_IP_or_DNS:3000

Connectez-vous à l'aide des identifiants que vous avez spécifiés dans le fichier de configuration pour apigee-grafana. Dans l'exemple ci-dessus, le nom d'utilisateur/mot de passe est admin/admin.

Résoudre les problèmes d'installation

Si aucune donnée n'apparaît dans le tableau de bord, suivez la procédure ci-dessous pour résoudre les problèmes d'installation :

1. Pour vous assurer qu'apigee-telegraf collecte les données :
   1. Exécutez la commande apigee-service apigee-telegraf setup (elle est idempotente), recherchez les erreurs et les dépendances manquantes, puis corrigez-les.
   2. Redémarrez apigee-telegraf et vérifiez si des erreurs sont présentes dans /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log.
2. Pour vous assurer que apigee-influxdb reçoit des données :
   1. Assurez-vous que les ports TCP suivants sont ouverts sur les nœuds de données apigee-influxdb : 8086 et 8183.
   2. Utilisez l'URL suivante pour ouvrir l'interface utilisateur d'influxdb dans un navigateur :
      http://influxdb_IP_or_DNS:8183
      1. Dans le champ "Requête", saisissez "show databases".
         Assurez-vous que les bases de données suivantes ont été créées : system, application, events, _internal.
      2. Dans le champ "Query" (Requête), saisissez "show servers".
         Assurez-vous que les nœuds apigee-influxdb sont listés.
3. Vérifiez les sources de données du tableau de bord :
   1. Sélectionnez Sources de données dans le menu principal. Les icônes de trois sources de données devraient s'afficher.
   2. Pour chaque source de données, sélectionnez l'icône.
   3. Sur la page d'informations de la source de données, sélectionnez le bouton Enregistrer et tester.
   4. Si la source de données est correctement configurée, un message s'affiche sous la forme :
      Réussite
      La source de données fonctionne

Mettre à jour le tableau de bord de surveillance bêta

Utilisez l'une des deux procédures ci-dessous en fonction de la version d'Edge à partir de laquelle vous effectuez la mise à niveau :

• Les versions 4.16.09 et 4.17.01 utilisent la même procédure
• La version 4.16.05 nécessite la désinstallation d'apigee-collectd dans le cadre de la mise à jour.

Mise à jour depuis la version 4.16.09 ou 4.17.01

Si vous avez installé la version bêta du tableau de bord de surveillance Apigee dans la version 4.16.09 ou 4.17.01, vous pouvez la mettre à jour vers la version bêta de la version 4.17.05.

Pour mettre à jour le tableau de bord de surveillance bêta :

1. Mettez à jour Edge vers la version 4.17.05 comme décrit dans les sections Mettre à jour Apigee Edge 4.17.01 vers la version 4.17.05, Mettre à jour Apigee Edge 4.16.09 vers la version 4.17.05 et Mettre à jour Apigee Edge 4.16.01/4.16.05 vers la version 4.17.05.
2. Mettez à jour apigee-influxdb sur le nœud du serveur de gestion :
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   où configFile est le fichier de configuration que vous avez utilisé pour installer apigee-influx.
   
   Si vous avez également installé apigee-grafana sur le nœud du serveur de gestion, cette étape met également à jour apigee-grafana. Sinon, mettez à jour apigee-granfana comme indiqué à l'étape suivante.
3. Si vous n'avez pas installé apigee-grafana sur le nœud du serveur de gestion, mettez à jour apigee-grafana sur le nœud où vous l'avez installé :
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. Mettez à jour apigee-telegraf sur le nœud 1 :
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
5. Répétez l'étape 4 pour chaque nœud.

Mise à jour depuis la version 4.16.05

La version 4.16.05 du tableau de bord utilisait apigee-collectd au lieu de apigee-telegraf. Lors de la mise à jour vers la version 4.17.05, vous désinstallez apigee-collectd et installez apigee-telegraf.

Pour mettre à jour le tableau de bord de surveillance bêta :

1. Mettez à jour Edge vers la version 4.17.05 comme décrit dans les sections Mettre à jour Apigee Edge 4.17.01 vers la version 4.17.05, Mettre à jour Apigee Edge 4.16.09 vers la version 4.17.05 et Mettre à jour Apigee Edge 4.16.01/4.16.05 vers la version 4.17.05.
2. Mettez à jour apigee-influxdb sur le nœud du serveur de gestion :
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   où configFile est le fichier de configuration que vous avez utilisé pour installer apigee-influx.
   
   Si vous avez également installé apigee-grafana sur le nœud du serveur de gestion, cette étape met également à jour apigee-grafana. Sinon, mettez à jour apigee-granfana comme indiqué à l'étape suivante.
3. Si vous n'avez pas installé apigee-grafana sur le nœud du serveur de gestion, mettez à jour apigee-grafana sur le nœud où vous l'avez installé :
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. Installez apigee-telegraf sur le nœud 1 :
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd stop
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd uninstall
5. Répétez l'étape 4 pour chaque nœud.