Installation du tableau de bord Monitoring (bêta)

Edge pour Private Cloud v4.18.01

Configuration requise

Vous devez installer apigee-telegraf sur tous les nœuds périphériques pour collecter des données de tableau de bord. Par conséquent, la configuration système requise pour apigee-telegraf est identique à celle d'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 le Document InfluxData pour en savoir plus.

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, comme /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 à 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 à 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 apigee-influxdb setup

3. Lancez apigee-influxdb :

   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

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

Sur chaque nœud de votre installation Edge:

1. Sur votre premier nœud périphérique, installez apigee-telegraf:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install

2. Créez un fichier de configuration nommé apigee-telegraf pour ce fichier. sa_telegraf.txt Généralement, vous stockez ce fichier dans un répertoire accessible par "apigee" utilisateur, comme /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. Changez le propriétaire sur "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 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 périphérique, 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. Généralement, vous stockez ce fichier dans un répertoire accessible par le utilisateur, comme /opt/apigee/customer/application, et la définir comme propriété de "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. Changez le propriétaire sur "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 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 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 apigee-service apigee-telegraf setup, qui est idempotent. Recherchez les dépendances manquantes et les résoudre.
   2. Redémarrez apigee-telegraf et vérifiez /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log pour les éventuelles erreurs
2. Pour vous assurer que apigee-influxdb reçoit les 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: system, application, events, _internal.
      2. Dans le champ "Requête", saisissez "show servers". Vérifiez que les apigee-influxdb nœud est répertorié.
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 versions 4.16.09 et 4.17.0x 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.0x

Si vous avez installé la version bêta du tableau de bord Apigee Monitoring dans 4.16.09 ou 4.17.0x, vous pouvez le mettre à jour vers la version bêta pour 4.18.01.

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

1. Mettez à jour Edge vers 4.18.01 comme décrit dans Mettre à jour Apigee Edge 4.17.01/4.17.05 vers 4.17.09, Mise à jour d'Apigee Edge 4.16.09 vers 4.17.09 et Mise à jour d'Apigee Edge 4.16.01/4.16.05 vers la version 4.17.09.
2. Mettre à 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 dans l'application Nœud de serveur, 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 de serveur de gestion, mettez à jour apigee-grafana sur le nœud où l'avez installée:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

4. Mettre à jour apigee-telegraf sur 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.18.01, 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 4.18.01 comme décrit à l’adresse Mettre à jour Apigee Edge 4.16.01/4.16.05 vers 4.17.01 et Mise à jour d'Apigee Edge 4.16.09 vers 4.17.01.
2. Mettre à 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 dans l'application Nœud de serveur, 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 de serveur de gestion, mettez à jour apigee-grafana sur le nœud où l'avez installée:

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