Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Surveillance

Edge pour Private Cloud v. 4.17.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 liste 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
Routeur	1100	/opt/apigee/edge-router/bin/start
Processeur de messages	1101	/opt/apigee/edge-message-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 comme indiqué 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 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 dispose d'une action change_jmx_auth que vous utilisez pour activer/désactiver l'authentification et définir les identifiants JMX.

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

>  /opt/apigee/apigee-service/bin/apigee-service comp change_jmx_auth optionsOrConfigFile

où :

comp est soit 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 (désactiver)
Le fichier de configuration inclut :
- JMX_USERNAME=username
- JMX_ENABLED=y/n
- JMX_PASSWORD=password (si cette option n'est pas définie ou n'est pas transmise avec -p, vous êtes invité à la saisir)

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

> /opt/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 :

> /opt/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 ultérieurement, utilisez la commande suivante :

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

Serveur de gestion

Utiliser JConsole pour surveiller la vérification de l'état du système et les informations sur les processus

Utilisez JConsole (un outil compatible avec JMX) pour gérer et surveiller les vérifications d'état et les statistiques de traitement. À l'aide de JConsole, vous pouvez utiliser les statistiques JMX exposées par Management Server (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 (MBeans) proposés via JMX.

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

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 :

MBeans JMX	Attributs JMX
Mémoire	HeapMemoryUsage
	NonHeapMemoryUsage
	Utilisation
Remarque : Les valeurs d'attribut s'affichent sous quatre valeurs : "committed", "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 sur n'importe quel serveur) en appelant la commande CURL suivante :

curl http://<host>:8080/v1/servers/self/up -H "Accept: application/json"

Où <host> est l'adresse IP du serveur de gestion. Vous pouvez spécifier le type Accept comme application/json ou application/xml.

Cet appel renvoie "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), cela signifie qu'Edge ne peut pas répondre aux requêtes du port 8080.

Dépannage

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

Utiliser l'application Edge : vérifications des utilisateurs, de l'organisation et du déploiement

Le serveur de gestion joue un rôle essentiel dans la conservation de tous les autres packages 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 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 "deployed" (déployé) pour tous les appels. Si ces commandes échouent, procédez comme suit :

Recherchez d'éventuelles erreurs dans les journaux du serveur de gestion (à l'emplacement opt/apigee/var/log/edge-management-server).
Envoyez une requête au serveur de gestion pour vérifier s'il fonctionne correctement.
Supprimez le serveur de l'ELB, puis redémarrez le serveur de gestion.
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Routeur

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

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

Où "host" est l'adresse IP du routeur.

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

Si vous ne recevez pas de réponse HTTP 200 (OK), cela signifie qu'Edge ne peut pas répondre aux requêtes du port 8081.