Installation du tableau de bord de surveillance bêta

Edge pour Private Cloud version 4.17.05

Configuration requise

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

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

Pour apigee-influxdb, vous pouvez : l'installer sur un nœud périphérique existant, tel que le nœud de serveur de gestion ou le nœud d'interface utilisateur Edge, avec aucune modification de 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 avoir les exigences suivantes:

• Processeur à 2 cœurs
• 4 Go de RAM
• 250 Go d'espace disque (données de surveillance supprimées définitivement au bout d'un mois)
• 1 000 IOPS ou plus

Consultez les dans 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 que le service nœud exécutant apigee-grafana et apigee-telegraf.

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

Pour installer apigee-telegraf et apigee-grafana, vous transmettez un fichier de configuration à l'utilitaire apigee-service. Stocker ces fichiers dans un répertoire accessible par l'environnement "apigee" utilisateur, tel que /opt/apigee/customer/application, et les faire appartenir au « apigee » utilisateur.

Paramètres de configuration pour apigee-telegraf

Définissez ces propriétés dans un fichier texte que vous transmettez à la commande apigee-telegraf setup. 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 cet ordre:

• 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 périphérique ou un nœud autonome

Sur un nœud autonome ou un nœud périphérique 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 configuration apigee-influxdb
3. Démarrez apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service démarrage apigee-influxdb

Installer apigee-telegraf sur chaque nœud périphérique

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 installer
2. Créez un fichier de configuration pour apigee-telegraf nommé sa_telegraf.txt. Généralement, vous stockez ce fichier dans un répertoire accessible par le utilisateur, tel que sous la forme /opt/apigee/customer/application, et la faire appartenir au « apigee » utilisateur.
   
   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 configuration -f /opt/apigee/customer/application/sa_telegraf.txt
5. Redémarrez apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf redémarrer
6. Répétez ce processus sur tous les nœuds périphériques.

Installer apigee-grafana sur un seul nœud périphérique

Sur un nœud unique de votre installation Edge, tel que le nœud Edge UI:

1. Sur votre premier nœud Edge, installez apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana installer
2. Créez un fichier de configuration pour apigee-grafana nommé sa_grafana.txt. Généralement, vous stockez ce fichier dans un répertoire accessible par le service "apigee" utilisateur, tel que /opt/apigee/customer/application, et la faire appartenir au « apigee » utilisateur.
   
   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. Configurer apigee-grafana à l'aide du fichier de configuration:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana configuration -f /opt/apigee/customer/application/sa_grafana.txt
5. Redémarrez apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service redémarrer apigee-grafana

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 vous ne voyez pas de données s'afficher dans le tableau de bord, procédez comme suit pour résoudre le problème votre installation:

1. Pour garantir apigee-telegraf collecte les données <ph type="x-smartling-placeholder">
   </ph>
   1. Exécutez le service apigee-service configuration apigee-telegraf, est idempotente, vérifie les erreurs et les dépendances manquantes. et les résoudre.
   2. Redémarrez apigee-telegraf. et consultez /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log dans votre compte. pour les éventuelles erreurs
2. Pour garantir que apigee-influxdb reçoit des données: <ph type="x-smartling-placeholder">
   </ph>
   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 influxdb dans un navigateur:
      http://influxdb_IP_or_DNS:8183
      .
      1. Dans le champ "Requête", saisissez "afficher les bases de données".
         Assurez-vous que les bases de données suivantes ont été créées: système, application, événements, _internal.
      2. Dans le champ "Requête", saisissez "show servers".
         Assurez-vous que les nœuds apigee-influxdb sont dans la liste.
3. Vérifiez les sources de données dans le tableau de bord: <ph type="x-smartling-placeholder">
   </ph>
   1. Sélectionnez Sources de données dans le menu principal. Vous devriez voir des icônes pour trois sources de données affichées.
   2. Pour chaque source de données, sélectionnez l'icône correspondante.
   3. Sur la page d'informations de la source de données, cliquez sur le bouton Enregistrer et Tests .
   4. Si la source de données est correctement configurée, un message doit s'afficher sous la forme:
      Opération réussie
      La source de données fonctionne

Mise à jour du tableau de bord de surveillance bêta

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

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

Mettre à jour à partir de la version 4.16.09 ou 4.17.01

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

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

1. Mettez à jour Edge vers 4.17.05 comme décrit dans Mettre à jour Apigee Edge 4.17.01 à 4.17.05, Mettre à jour Apigee Edge 4.16.09 à 4.17.05 et Update Apigee Edge de 4.16.01/4.16.05 à 4.17.05
2. Mettre à jour apigee-influxdb sur le nœud du serveur de gestion:
   &gt; /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 panneau de gestion Nœud de serveur, cette étape met également à jour apigee-grafana. Sinon, mettez à jour apigee-granfana comme indiqué dans la l'étape suivante.
3. Si vous n'avez pas installé apigee-grafana sur le de serveur de gestion, mettez à jour apigee-grafana sur le nœud où vous l'avez installée:
   &gt; /opt/apigee/apigee-setup/bin/update.sh -c pp -f fichier de configuration
4. Mettre à jour apigee-telegraf sur Nœud 1:
   &gt; /opt/apigee/apigee-service/bin/apigee-service mise à jour apigee-telegraf
   &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf configuration -f configFile
   &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf redémarrer
5. Répétez l'étape 4 pour chaque nœud.

Mettre à jour à partir de la version 4.16.05

La version 4.16.05 du tableau de bord utilisait apigee-collectd au lieu de apigee-telegraf. Dans le cadre de la mise à jour 4.17.05 : désinstallez apigee-collectd et installez apigee-telegraf.

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

1. Mettez à jour Edge vers 4.17.05 comme décrit dans Mettre à jour Apigee Edge 4.17.01 à 4.17.05, Mettre à jour Apigee Edge 4.16.09 à 4.17.05 et Update Apigee Edge de 4.16.01/4.16.05 à 4.17.05
2. Mettre à jour apigee-influxdb sur le nœud du serveur de gestion:
   &gt; /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 panneau de gestion Nœud de serveur, cette étape met également à jour apigee-grafana. Sinon, mettez à jour apigee-granfana comme indiqué dans la l'étape suivante.
3. Si vous n'avez pas installé apigee-grafana sur le de serveur de gestion, mettez à jour apigee-grafana sur le nœud où vous l'avez installée:
   &gt; /opt/apigee/apigee-setup/bin/update.sh -c pp -f fichier de configuration
4. Installez apigee-telegraf sur le nœud 1:
   &gt; /opt/apigee/apigee-service/bin/apigee-service arrêt apigee-collectd
   &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf installer
   &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf configuration -f configFile
   &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf redémarrage
   &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-collectd désinstaller
5. Répétez l'étape 4 pour chaque nœud.