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

Surveillance

Edge pour Private Cloud v4.18.01

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

Activer JMX

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

Chaque composant prend en charge JMX sur un port différent. Le tableau suivant répertorie les ports 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 les éléments suivants:

-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 paramètre 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 la gestion Serveur:

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

Activer l'authentification 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 utiliser 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 possède 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 correspond à edge-management-server, Edge-message-processor, Edge-qpid-server ou edge-postgres-server.
Les options sont les suivantes: <ph type="x-smartling-placeholder">
- -u: nom d'utilisateur
- -p: mot de passe
- -e: y (activer) ou n (modifiable)
Le fichier de configuration comprend les éléments suivants: <ph type="x-smartling-placeholder">
- JMX_USERNAME=nom d'utilisateur
- JMX_ENABLED=y/n
- JMX_PASSWORD=password (si elle n'est pas définie ou si elle n'est pas transmise avec -p, un message vous invite à le faire).

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 mot de passe.

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

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

Serveur de gestion

En utilisant JConsole pour surveiller la vérification de l'état du système et traiter les informations

Utilisez JConsole (un outil compatible 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 fournies par Management Server (ou tout autre 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ées via JMX.

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

où <adresse IP> est l'adresse IP du serveur de gestion (ou serveur concerné). Le port par défaut 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 seront affichées avec quatre valeurs: commit, "init", "max" et "used".

Utilisation de l'API Edge Application vérifications

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

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 d'acceptation application/json ou application/xml.

Cet appel renvoie la valeur "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 est incapable de répondre au port 8080 requêtes.

Dépannage

Connectez-vous au serveur et exécutez la commande suivante:
/opt/apigee/apigee-service/bin/apigee-service état du serveur de gestion en périphérie
Si le service n'est pas en cours d'exécution, démarrez-le:
/opt/apigee/apigee-service/bin/apigee-service démarrage du serveur de gestion en périphérie

Utilisation de Edge Application : contrôles des utilisateurs, de l'organisation et du déploiement

Le serveur de gestion joue un rôle essentiel dans le regroupement de tous les autres colis dans chaque environnement sur site. l'installation. 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 "déployé" pour tous les appels. En cas d'échec, suivantes:

Consultez les journaux du serveur de gestion (au niveau du serveur opt/apigee/var/log/edge-management-server). en cas d'erreur.
Effectuer un appel 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 redémarrage du serveur de gestion en périphérie

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ù, l'hôte est l'adresse IP du routeur.

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

Si vous ne recevez pas de réponse HTTP 200 (OK), Edge ne peut pas répondre au port 8081. requêtes.