Se usó la API de Cloud Translation para traducir esta página.

Cómo supervisar

Edge para la nube privada v4.18.01

En este documento, se describen las técnicas de supervisión de los componentes compatibles con una implementación local de Apigee Edge.

Cómo habilitar JMX

JMX está habilitado de forma predeterminada para Cassandra y, luego, inhabilitado para todos los demás componentes de Edge. Por lo tanto, debes habilitar JMX de forma individual para cada componente.

Cada componente admite JMX en un puerto diferente. En la siguiente tabla, se muestra el puerto JMX y el archivo que modificas para habilitar JMX en ese puerto:

Componente	Puerto JMX	Archivo
Servidor de administración	1099	/opt/apigee/edge-management-server/bin/start
Router	1100	/opt/apigee/edge-router/bin/start
Procesador de mensajes	1101	/opt/apigee/edge-message-processor/bin/start
LPD	1102	/opt/apigee/edge-qpid-server/bin/start
Postgres	1103	/opt/apigee/edge-postgres-server/bin/start

Por ejemplo, para habilitar JMX en el servidor de administración, abre /opt/apigee/edge-management-server/bin/start en un editor. Deberías ver la siguiente línea para iniciar el servidor de administración:

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

Edita esta línea para agregar lo siguiente:

-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

Ten en cuenta que esta línea especifica el número de puerto JMX como 1099 para el servidor de administración. Establece el número de puerto para cada componente como se define en la tabla anterior. Por ejemplo:

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

Guarda el archivo y, luego, reinicia el componente. Por ejemplo, para reiniciar el servidor de administración, haz lo siguiente:

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

Habilita la autenticación de JMX y configura la contraseña de JMX

El proceso de supervisión para el servidor de administración, el procesador de mensajes, Qpid y Postgres usan JMX. JMX está habilitado de forma predeterminada, y el acceso remoto no requiere una contraseña.

Para habilitar la autenticación JMX, cada componente tiene una acción change_jmx_auth que debes usar para habilitar o inhabilitar la autenticación y configurar las credenciales de JMX.

Para habilitar la autenticación JMX, usa el siguiente comando:

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

Donde:

comp es edge-management-server, perimetral-message-processor, Edge-qpid-server o Edge-postgres-server.
Las opciones son las siguientes:
- -u: Nombre de usuario
- -p: Contraseña
- -e: y (habilitar) o n (dsiable)
El archivo de configuración incluye lo siguiente:
- JMX_USERNAME=nombre de usuario
- JMX_HABILITADO=y/n
- JMX_PASSWORD=password (si no se establece o no se pasa con -p, se te solicita)

Por ejemplo, para usar opciones en la línea de comandos, haz lo siguiente:

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

Si tienes un archivo de configuración, haz lo siguiente:

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

Si ejecutas Edge en varios nodos, ejecuta este comando en todos y especifica el mismo nombre de usuario y contraseña.

Para inhabilitar la autenticación JMX más adelante, usa el siguiente comando:

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

Servidor de administración

Cómo usar JConsole para supervisar la verificación de estado del sistema y la información de procesos

Usa JConsole (una herramienta compatible con JMX) para administrar y supervisar verificaciones de estado y estadísticas de procesos. Con JConsole, puedes consumir las estadísticas de JMX que expone el servidor de administración (o cualquier servidor) y mostrarlas en una interfaz gráfica. Para obtener más información sobre el uso de JConsole, consulta http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html.

Usa JConsole y la siguiente URL de servicio para supervisar los atributos JMX (MBeans) que se ofrecen a través de JMX.

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

donde <ip address> es la dirección IP del servidor de administración (o el servidor correspondiente). De forma predeterminada, el puerto es 1099 para el servidor de administración.

En la siguiente tabla, se muestran las estadísticas genéricas de JMX:

MBeans de JMX	Atributos JMX
Memoria	HeapMemoryUsage
	NonHeapMemoryUsage
	Uso
Nota: Los valores del atributo se mostrarán en cuatro valores: confirmados, init, máximos y usados.

Usa las verificaciones de la API de Edge Application

Puedes realizar una verificación de API en el servidor de administración (o en cualquier servidor) si invocas el siguiente comando CURL:

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

Donde <host> es la dirección IP del servidor de administración. Puedes especificar el tipo Accept como application/json o application/xml.

Esta llamada muestra los valores "true" y "false". Si es verdadero, significa que el nodo está activo y se está ejecutando el servicio de Java.

Si no recibes una respuesta HTTP 200 (OK), el perímetro no puede responder a las solicitudes del puerto 8080.

Solución de problemas

Accede al servidor y ejecuta el siguiente comando:
/opt/apigee/apigee-service/bin/apigee-service Edge-management-server status
Si el servicio no está en ejecución, inicia el servicio:
/opt/apigee/apigee-service/bin/apigee-service Edge-management-server start

Usa aplicaciones perimetrales: verificaciones de usuarios, implementación y organización

Management Server desempeña una función vital en la retención de todas las demás parcelas en cada instalación local. Puedes verificar el estado del usuario, la organización y la implementación en el servidor de administración mediante los siguientes comandos:

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

El sistema debe mostrar el estado "implementado" para todas las llamadas. Si estos procesos fallan, haz lo siguiente:

Revisa los registros del servidor de administración (en opt/apigee/var/log/edge-management-server) para verificar si hay errores.
Realiza una llamada al servidor de administración para verificar si funciona correctamente.
Quita el servidor del ELB y, luego, reinicia el servidor de administración.
/opt/apigee/apigee-service/bin/apigee-service edge-management-server reiniciar

Router

Puedes realizar una verificación de API en el router (o en cualquier servidor) si invocas el siguiente comando CURL:

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

Donde, host es la dirección IP del router.

Esta llamada muestra los valores "true" y "false". Si es verdadero, significa que el nodo está activo y que el servicio del router está en ejecución.

Si no recibes una respuesta HTTP 200 (OK), Edge no podrá responder a las solicitudes del puerto 8081.