Installation du tableau de bord de surveillance bêta

Edge pour Private Cloud version 4.17.05

Configuration système requise

Vous devez installer apigee-telegraf sur tous les nœuds périphériques pour collecter les données du tableau de bord. Par conséquent, la configuration système requise pour apigee-telegraf est identique à celle du nœud périphérique 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, tel que le nœud de serveur de gestion ou l'interface utilisateur Edge.

Pour apigee-influxdb, vous pouvez l'installer sur un nœud périphérique existant, tel que le nœud Management Server ou le nœud d'interface utilisateur Edge, sans 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, celui-ci doit remplir les conditions 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

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 que le nœud exécutant apigee-grafana et apigee-telegraf puisse y accéder.

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

Pour installer les composants apigee-telegraf et apigee-grafana, transmettez 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 la propriété de 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 apigee-telegraf setup. Par exemple, définissez-les dans un fichier texte nommé sa_telegraf.txt:

Propriété

Description

INFLUXDB_URL

Spécifiez l'URL du nœud "apigee-influxdb", y compris le port 8086.

Exemple :

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:

Propriété

Description

INFLUXDB_HOST

Indiquez l'adresse IP ou le nom DNS du nœud InfluxDB.

Par exemple :

192.168.0.1

INFLUXDB_PORT

Port d'API InfluxDB utilisé par la source de données Grafana. Indiquez 8086.

GRAFANA_USERNAME

Nom d'utilisateur Grafana pour se connecter à l'interface utilisateur du tableau de bord.

GRAFANA_PASSWORD

Mot de passe Grafana pour la connexion à l'interface utilisateur du tableau de bord.

Instructions d'installation

Suivez les instructions ci-dessous pour installer les composants du tableau de bord dans cette séquence:

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

Installer apigee-influxdb sur un nœud périphérique unique ou un nœud autonome

Sur un nœud autonome, ou sur 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 configuration
  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. Généralement, vous stockez ce fichier dans un répertoire accessible par l'utilisateur "apigee", tel que /opt/apigee/customer/application et vous le faites appartenir à 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 configuration -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 Edge

Sur un nœud unique de votre installation Edge, tel que le nœud d'interface utilisateur 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. Généralement, ce fichier est stocké dans un répertoire accessible par l'utilisateur "apigee", tel que /opt/apigee/customer/application, et vous le faites en sorte qu'il appartienne à 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. Changez 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 ne s'affiche dans le tableau de bord, procédez comme suit pour résoudre les problèmes d'installation:

  1. Pour vous assurer que apigee-telegraf collecte les données :
    1. Exécutez la configuration d'apigee-service apigee-telegraf. Elle est idempotente, vous permet de rechercher les erreurs et les dépendances manquantes, et de les résoudre.
    2. Redémarrez apigee-telegraf et recherchez /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log pour vérifier qu'il n'y a pas d'erreur.
  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 "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".
        Assurez-vous que les nœuds apigee-influxdb sont répertoriés.
  3. Consultez les sources de données dans le tableau de bord :
    1. Sélectionnez Sources de données dans le menu principal. Les icônes de trois sources de données doivent s'afficher.
    2. Sélectionnez l'icône pour chaque source de données.
    3. Sur la page d'informations de la source de données, sélectionnez le bouton Save & Test (Enregistrer et tester).
    4. Si la source de données est correctement configurée, un message de ce type doit s'afficher:
      Opération réussie
      La source de données fonctionne

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

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

  • 4.16.09 et 4.17.01 utilisent la même procédure
  • 4.16.05 exige que vous désinstallez 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 de surveillance Apigee dans la version 4.16.09 ou 4.17.01, vous pouvez la mettre à jour vers la version bêta pour 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 4.17.05, Mettre à jour Apigee Edge 4.16.09 vers 4.17.05 et Mettre à jour Apigee Edge 4.16.01/4.16.05 vers 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
    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 Management Server, 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/teleapigee/apigee-service/bin/apigee-service
  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 a utilisé apigee-collectd au lieu de apigee-telegraf. Dans le cadre de la mise à jour vers la version 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 la version 4.17.05, comme décrit dans les sections Mettre à jour Apigee Edge 4.17.01 vers 4.17.05, Mettre à jour Apigee Edge 4.16.09 vers 4.17.05 et Mettre à jour Apigee Edge 4.16.01/4.16.05 vers 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
    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 Management Server, 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:
    apigee-telegraf

    configFile
  5. Répétez l'étape 4 pour chaque nœud.