Cette page a été traduite par l'API Cloud Translation.

Surveillance

Edge pour Private Cloud version 4.16.09

Ce document décrit les techniques de surveillance des composants compatibles avec un déploiement sur site d'Apigee Edge.

Activer JMX

JMX est activé par défaut pour Cassandra et désactivé par défaut pour tous les autres composants Edge. Vous devez donc activer JMX individuellement pour chaque composant.

Chaque composant est compatible avec JMX sur un port différent. Le tableau suivant répertorie le port JMX et le fichier que vous modifiez pour activer JMX sur ce port:

Composant	Port JMX	Fichier
Serveur de gestion	1099	/opt/apigee/edge-management-server/bin/start
Processeur de messages	1101	/opt/apigee/edge-mesage-processor/bin/start
QPID	1102	/opt/apigee/edge-qpid-server/bin/start
Postgres	1103	/opt/apigee/edge-postgres-server/bin/start

Par exemple, pour activer JMX sur le serveur de gestion, ouvrez /opt/apigee/edge-management-server/bin/start dans un éditeur. La ligne suivante doit s'afficher pour démarrer le serveur de gestion:

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts -Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path 
-Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

Modifiez cette ligne pour ajouter ce qui suit:

-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

Notez que cette ligne spécifie le numéro de port JMX 1099 pour le serveur de gestion. Définissez le numéro de port de chaque composant, tel que défini dans le tableau ci-dessus. Exemple :

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts 
-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false 
-Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path -Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

Enregistrez le fichier, puis redémarrez le composant. Par exemple, pour redémarrer le serveur de gestion:

> /opt/apigee/apigee-service/bin/ apigee-service edge-management-server restart

Activer l'authentification JMX et définir le mot de passe JMX

Le processus de surveillance du serveur de gestion, du processeur de messages, de Qpid et de Postgres utilise tous JMX. JMX est activé par défaut et l'accès à distance JMX ne nécessite pas de mot de passe.

Pour activer l'authentification JMX, chaque composant dispose d'une action change_jmx_auth qui vous permet d'activer ou de désactiver l'authentification et de définir les identifiants JMX.

Pour activer l'authentification JMX, utilisez la commande suivante:

>  /<inst_root>/apigee/apigee-service/bin/apigee-service comp change_jmx_auth optionsOrConfigFile

où :

comp est edge-management-server, Edge-message-processor, Edge-qpid-server ou Edge-postgres-server.
Les options sont les suivantes :
- -u: nom d'utilisateur
- -p: mot de passe
- -e: y (activer) ou n (dsiable)
Le fichier de configuration inclut les éléments suivants :
- JMX_USERNAME=nom d'utilisateur
- JMX_ACTIVÉ=o/n
- JMX_PASSWORD=password (s'il n'est pas défini ou n'est pas transmis avec -p, vous êtes invité à le faire)

Par exemple, pour utiliser les options sur la ligne de commande:

> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -u foo -p bar -e y

Si vous disposez d'un fichier de configuration:

> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -f configFile

Si vous exécutez Edge sur plusieurs nœuds, exécutez cette commande sur tous les nœuds, en spécifiant les mêmes nom d'utilisateur et mot de passe.

Pour désactiver ultérieurement l'authentification JMX, utilisez la commande suivante:

> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -e n

Serveur de gestion

Surveiller la vérification de l'état du système et les informations de traitement à l'aide de JConsole

Utilisez JConsole (un outil conforme à JMX) pour gérer et surveiller les vérifications d'état et les statistiques de processus. À l'aide de JConsole, vous pouvez utiliser les statistiques JMX exposées par Management Server (ou tout serveur) et les afficher dans une interface graphique. Pour en savoir plus sur l'utilisation de JConsole, consultez la page http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html.

Utilisez JConsole et l'URL de service suivante pour surveiller les attributs JMX (MBeans) proposés via JMX.

service:jmx:rmi:///jndi/rmi://<ip address>:<port>/platform

où <ip address> est l'adresse IP du serveur de gestion (ou du serveur correspondant). Par défaut, le port est 1099 pour le serveur de gestion.

Le tableau suivant présente les statistiques JMX génériques:

JMX MBeans	Attributs JMX
Mémoire	HeapMemoryUsage
	NonHeapMemoryUsage
	Utilisation
Remarque:Les valeurs d'attribut s'affichent dans quatre valeurs : "commit", "init", "max" et "used".

Utiliser les vérifications de l'API Edge Application

Vous pouvez effectuer une vérification de l'API sur le serveur de gestion (ou tout autre serveur) en appelant la commande CURL suivante:

curl http://<host>:8080/v1/servers/self/up

Où <host> est l'adresse IP du serveur de gestion.

Cet appel renvoie les valeurs "true" et "false". Si la valeur est "true", cela signifie que le nœud est opérationnel et que le service Java est en cours d'exécution.

Si vous ne recevez pas de réponse HTTP 200 (OK), Edge ne peut pas répondre aux requêtes sur le port 8080.

Dépannage

Connectez-vous au serveur et exécutez la commande suivante:
/<inst_root>/apigee/apigee-service/bin/apigee-service Edge-management-server status
Si le service n'est pas en cours d'exécution, démarrez-le:
/<inst_root>/apigee/apigee-service/bin/apigee-service Edge-management-server start

Utilisation d'une application de périphérie : vérifications des utilisateurs, de l'organisation et du déploiement

Management Server joue un rôle essentiel pour rassembler tous les autres colis dans chaque installation sur site. Vous pouvez vérifier l'état de l'utilisateur, de l'organisation et du déploiement sur le serveur de gestion à l'aide des commandes suivantes:

curl -u userEmail:password http://localhost:8080/v1/users
curl -u userEmail:password http://localhost:8080/v1/organizations
curl -u userEmail:password http://localhost:8080/v1/organizations/orgname/deployments

Le système doit afficher l'état "déployé" pour tous les appels. En cas d'échec, procédez comme suit:

Recherchez d'éventuelles erreurs dans les journaux du serveur de gestion (sur <inst_root>/apigee/var/log/edge-management-server).
Appelez le serveur de gestion pour vérifier s'il fonctionne correctement.
Supprimez le serveur de l'ELB, puis redémarrez le serveur de gestion.
/<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restart

Routeur

Vous pouvez effectuer une vérification de l'API sur le routeur (ou n'importe quel serveur) en appelant la commande CURL suivante:

curl http://<host>:8081/v1/servers/self/up

Où, hôte est l'adresse IP du routeur.

Cet appel renvoie les valeurs "true" et "false". Si la valeur est "true", cela signifie que le nœud est opérationnel et que le service de routeur est en cours d'exécution.

Si vous ne recevez pas de réponse HTTP 200 (OK), Edge ne pourra pas répondre aux requêtes sur le port 8081.