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

Surveillance

Edge for Private Cloud v. 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:

Élément	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
Qid	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 devrait vous servir à 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 comme 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 JMX à distance ne nécessite pas de mot de passe.

Pour activer l'authentification JMX, chaque composant comporte une action change_jmx_auth qui vous permet d'activer/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 correspond à 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 (activé) ou n (dissociable)
Le fichier de configuration inclut les éléments suivants :
- JMX_USERNAME=nom d'utilisateur
- JMX_ENABLED=y/n
- JMX_PASSWORD=password (si cette règle n'est pas configurée ou si elle n'est pas transmise avec -p, vous êtes invité à le faire)

Par exemple, pour utiliser les options dans 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 le même nom d'utilisateur et le même mot de passe.

Pour désactiver l'authentification JMX par la suite, 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 traiter les informations à l'aide de JConsole

Utilisez JConsole (un outil conforme à JMX) pour gérer et surveiller la vérification de l'état et les statistiques de traitement. Avec JConsole, vous pouvez utiliser les statistiques JMX exposées par le serveur de gestion (ou n'importe quel serveur) et les afficher dans une interface graphique. Pour en savoir plus sur l'utilisation de JConsole, consultez 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 (Moeans) 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 respectif). Par défaut, le port est 1099 pour le serveur de gestion.

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

JMX Morans	Attributs JMX
Mémoire	Utilisation du tas de mémoire
	Utilisation de la mémoire autre que le tas de mémoire
	Utilisation
Remarque:Les valeurs des attributs s'affichent dans quatre valeurs: commit, init, max et used.

Utilisation des vérifications de l'API Edge Application

Vous pouvez vérifier l'API sur le serveur de gestion (ou n'importe quel 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 de 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
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 de l'application périphérique : vérifications des utilisateurs, de l'organisation et du déploiement

Le serveur de gestion joue un rôle essentiel pour maintenir tous les autres colis ensemble dans chaque installation sur site. Vous pouvez vérifier l'état des utilisateurs, de l'organisation et du déploiement sur le serveur de gestion en exécutant les 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:

Vérifiez que les journaux du serveur de gestion (à l'adresse <inst_root>/apigee/var/log/edge-management-server) ne contiennent pas d'erreurs.
Effectuez un appel sur le serveur de gestion pour vérifier qu'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 vérifier 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ù l'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 peut pas répondre aux requêtes de port 8081.