Edge for Private Cloud v4.18.01
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, comme le serveur de gestion ou le nœud d'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 modifier 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 répondre aux 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
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é à 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 |
---|---|
|
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 |
---|---|
|
Indiquez l'adresse IP ou le nom DNS du nœud InfluxDB. Par exemple : 192.168.0.1 |
|
Port d'API InfluxDB utilisé par la source de données Grafana. Indiquez 8086. |
|
Nom d'utilisateur Grafana pour se connecter à l'interface utilisateur du tableau de bord. |
|
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:
- Installer
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
- Configurez la base de données
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
- Démarrer
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:
- Sur votre premier nœud Edge, installez
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
- 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
- Remplacez le propriétaire par "apigee" :
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
- Configurez
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
- Redémarrez
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
- 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:
- Sur votre premier nœud Edge, installez
apigee-grafana
:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
- Créez un fichier de configuration nommé
sa_grafana.txt
pourapigee-grafana
. 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 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
- Remplacez le propriétaire par "apigee" :
> chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
- 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
- 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:
- Pour s'assurer que
apigee-telegraf
collecte les données :- Exécutez
apigee-service apigee-telegraf setup
. Il est idempotent, recherchez les erreurs et les dépendances manquantes, puis corrigez-les. - Redémarrez
apigee-telegraf
et recherchez d'éventuelles erreurs dans/opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log
- Exécutez
- Pour vous assurer que
apigee-influxdb
reçoit les données :- Assurez-vous que les ports TCP suivants sont ouverts sur les nœuds de données
apigee-influxdb
: 8086 et 8183. - Utilisez l'URL suivante pour ouvrir l'interface utilisateur d'influxdb dans un navigateur :
http://influxdb_IP_or_DNS:8183
- 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
. - Dans le champ Requête, saisissez "show servers". Assurez-vous que les nœuds
apigee-influxdb
sont répertoriés.
- 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:
- Assurez-vous que les ports TCP suivants sont ouverts sur les nœuds de données
- Consultez les sources de données dans le tableau de bord :
- Sélectionnez Sources de données dans le menu principal. Les icônes de trois sources de données doivent s'afficher.
- Sélectionnez l'icône pour chaque source de données.
- Sur la page d'informations de la source de données, sélectionnez le bouton Save & Test (Enregistrer et tester).
- 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.0x utilisent la même procédure
- 4.16.05 nécessite la désinstallation de
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 de surveillance Apigee dans la version 4.16.09 ou 4.17.0x, vous pouvez la mettre à jour vers la version bêta pour la version 4.18.01.
Pour mettre à jour le tableau de bord de surveillance bêta:
- Mettez à jour Edge vers la version 4.18.01, comme décrit dans les sections Mettre à jour Apigee Edge 4.17.01/4.17.05 vers 4.17.09, Mettre à jour Apigee Edge 4.16.09 vers 4.17.09 et Mettre à jour Apigee Edge 4.16.01/4.16.05 vers 4.17.05.
- Mettez à jour
apigee-influxdb
sur le nœud Management Server :> /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 à jourapigee-grafana
. Sinon, mettez à jourapigee-granfana
comme indiqué à l'étape suivante. - Si vous n'avez pas installé
apigee-grafana
sur le nœud du serveur de gestion, mettez à jourapigee-grafana
sur le nœud où vous l'avez installé :> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- 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
- 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
. Dans le cadre de la mise à jour vers la version 4.18.01, désinstallez apigee-collectd
et installez apigee-telegraf
.
Pour mettre à jour le tableau de bord de surveillance bêta:
- Mettez à jour Edge vers la version 4.18.01, comme décrit dans les sections Mettez à jour Apigee Edge 4.16.01/4.16.05 vers 4.17.01 et Mettez à jour Apigee Edge 4.16.09 vers 4.17.01.
- Mettez à jour
apigee-influxdb
sur le nœud Management Server :> /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 à jourapigee-grafana
. Sinon, mettez à jourapigee-granfana
comme indiqué à l'étape suivante. - Si vous n'avez pas installé
apigee-grafana
sur le nœud du serveur de gestion, mettez à jourapigee-grafana
sur le nœud où vous l'avez installé :> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- 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
- Répétez l'étape 4 pour chaque nœud.