Configuración de JMX

Cuando se define un origen de datos JMX en el agente, parte de las propiedades de configuración se crean automáticamente.

La configuración de tiempo de ejecución de JMX es exclusiva debido a que proporciona cierto control sobre qué se muestra de la configuración. El cliente JMX para el agente puede conectarse a varios tipos diferentes de servidores de aplicaciones. Sin embargo, no es necesario dar soporte a todos estos tipos de servidores de aplicaciones en cualquier agente. Puede determinar qué tipos de servidores de aplicaciones se deben soportar, y las secciones de configuración innecesarias no se incluirán en el agente.

En la mayoría de los casos, un agente está diseñado para supervisar un tipo de servidor de aplicaciones JMX. Al crear el origen de datos JMX, puede utilizar el Navegador JMX. Cuando utiliza el Navegador JMX, las opciones de configuración del servidor JMX utilizadas para explorar el servidor MBean se añaden al agente automáticamente. Para cambiar los tipos de servidores de aplicaciones a los que puede conectarse después de crear el agente, pulse Opciones de JMX globales en el área Información de JMX. En la página Opciones para todo el agente JMX, cambie las selecciones que desee.

Puede diseñar un agente genérico que supervise más de un tipo de servidor de aplicaciones JMX. En este caso, se puede seleccionar más de una opción de configuración de servidor JMX en la página Opciones para todo el agente JMX. Cuando están soportadas más de un tipo de conexión JMX, la configuración de tiempo de ejecución le solicita el tipo de conexión que se utiliza para esa instancia de agente.

Nota: Una instancia de un agente sólo se puede conectar a un tipo de servidor de aplicaciones JMX. Se pueden utilizar subnodos para conectarse a diferentes servidores de aplicaciones JMX del mismo tipo dentro de una instancia de agente. Para conectarse a más de un tipo de servidor de aplicaciones JMX, debe configurar como mínimo una instancia de agente para cada tipo de servidor de aplicaciones JMX.

Puede ver, añadir y cambiar las propiedades de configuración utilizando Agent Editor. Encontrará instrucciones en: Cambio de las propiedades de configuración utilizando Agent Editor. Si un origen datos JMX está definido en un subnodo, también puede especificar Alteraciones temporales de configuración de subnodo. Encontrará instrucciones en: Configuración del subnodo.

Si define un origen de datos JMX en el agente, este debe utilizar Java™ para conectarse al servidor de aplicaciones JMX. Las propiedades de configuración de Java se añaden al agente automáticamente.

Las siguientes propiedades de configuración de Java son específicas de la configuración del tiempo de ejecución del agente:

Directorio inicial de Java: Vía de acceso completa que apunta al directorio de instalación Java
Configure el agente para que utilice la misma máquina virtual (JVM) que la que utiliza la aplicación que está supervisando, en concreto para WebLogic Server y WebSphere Application Server.
Argumentos de JVM: Especifica una lista opcional de argumentos para la máquina virtual Java.
Nivel de rastreo: Define la cantidad de información a escribir en el archivo de rastreo de Java. El valor predeterminado es grabar solo los datos de error en el archivo de registro.

Nota: El Agent Builder no requiere estas propiedades porque utiliza su propia JVM y registro, que se ha configurado a través del plug-in JLog.

Si se define un origen de datos JMX en el agente, los siguientes campos de configuración comunes necesarios se añaden al agente automáticamente:

Conexión: Tipo de conexión con el servidor MBean
ID de usuario: El ID de usuario que se utiliza para autenticarse en el servidor MBean.
Contraseña: Contraseña del ID de usuario.
Vías de acceso base: Directorios en los que se buscan archivos JAR nombrados en Vía de acceso de clases o directorios nombrados en Directorios JAR, que no estén calificados al completo. Los nombres de directorio están separados por un punto y coma (;) en Windows, y por un punto y coma (;) o dos puntos (:) en sistemas UNIX.
Vía de acceso de clases: Archivos JAR llamados explícitamente para que los busque el agente. Los que no están completamente calificados se añaden a cada una de las Vías de acceso hasta que se encuentra el archivo JAR.
Directorios de JAR: Directorios en los que se buscan archivos JAR. Los nombres de directorio están separados por un punto y coma (;) en Windows, y por un punto y coma (;) o dos puntos (:) en sistemas UNIX. No es necesario identificar explícitamente los archivos JAR de estos directorios; se encuentran porque residen en uno de estos directorios. No se busca en los subdirectorios de estos directorios. Cualquier nombre de directorio que no esté completamente calificado se añade a cada una de las Vías de acceso base hasta que se encuentra el directorio.

Nota: Para la supervisión remota, los archivos JAR y todos sus archivos JAR dependientes deben instalares localmente en el sistema donde se ejecuta el agente. Estos archivos JAR son archivos necesarios para conectarse a la aplicación que se está supervisando. Estos archivos JAR se deben configurar en Directorios de JAR, y en Vías de acceso base y Vía de acceso de clase. Además, instale localmente una JVM soportada para la aplicación que está supervisando y especifique la vía de acceso en el campo configuración del Directorio inicial de Java.

Ejemplos:

Para WebLogic 10, la vía de acceso de clase es server/lib/wlclient.jar;server/lib/wljmxclient.jar. La vía de acceso base apunta al directorio del servidor de aplicaciones de WebLogic donde se encuentra el directorio server/lib.
Para WebSphere, la vía de acceso base apunta a la ubicación donde está instalado el WebSphere Application Server. En este ejemplo se listan varias vías de acceso base para proporcionar un valor predeterminado para Windows y UNIX. La vía de acceso de clase lista los archivos JAR relativos a la vía de acceso base. El valor relativo lib para el campo Directorios de JAR hace que todos los archivos JAR de este directorio de la vía de acceso base se carguen.
- Vías de acceso base: C:\Archivos de programa\IBM\WebSphere\AppServer;/opt/IBM/WebSphere/AppServer
- Vía de acceso de clase: runtimes/com.ibm.ws.admin.client_6.1.0.jar;plugins/com.ibm.ws.security.crypto_6.1.0.jar
- Directorios de JAR: lib

Según los tipos de servidor JMX que se seleccionan en la página Opciones para todo el agente JMX, se añaden todas o algunas de las propiedades de configuración siguientes. Los valores predeterminados los proporciona Agent Builder y se pueden modificar:

Propiedades compatibles con JSR-160 de configuración específicas de la conexión con el servidor:

URL del servicio JMX: URL de los servicios JMX al que se debe conectar para la supervisión.

Propiedades de configuración específicas de la conexión de WebSphere Application Server versión 6.0 y posteriores:

Nombre de host: Nombre de host del sistema donde se ubica el servidor de aplicaciones que está supervisando. Para la supervisión local, el nombre es el nombre del sistema local. Para la supervisión remota, el nombre es el nombre de host del sistema donde se ubica el servidor de aplicaciones.
Puerto: Número de puerto que utilizar en el nombre de host que se va a supervisar.
Protocolo de conectores: Protocolo de conectores que debe utilizar la conexión de supervisión. Se soportan RMI y SOAP.
Nombre de perfil: Nombre del perfil que se debe utilizar para configurar la conexión.

Propiedades de configuración específicas de la conexión con JBoss Application Server (no JSR-160):

Nombre JNDI: Nombre JNDI utilizado para realizar búsquedas en el servidor MBean.
URL de proveedor: URL del proveedor de servicios JMX al que se debe conectar para la supervisión.

Propiedades de la configuración específicas de la conexión de WebLogic Server:

URL de servicio: URL del proveedor de servicios JMX al que se debe conectar para la supervisión que incluye el nombre JNDI.

Nota: Si la seguridad administrativa de WebSphere está habilitada, debe asegurarse de que las solicitudes de inicio de sesión del cliente están inhabilitadas en los archivos de propiedades de conexión del cliente apropiados. Para conexiones RMI, para evitar que los clientes realicen solicitudes al usuario, debe modificar la propiedad com.ibm.CORBA.loginSource en el archivo sas.client.props en el directorio de propiedades de perfil del WebSphere Application Server. En una conexión SOAP, debe modificar la propiedad com.ibm.SOAP.loginSource en el archivo soap.client.props del mismo directorio. En ambos casos, la propiedad loginSource se debe establecer de modo que no contenga ningún valor.

Puede ver, añadir y cambiar las propiedades de configuración utilizando Agent Editor. Consulte (Cambio de las propiedades de configuración utilizando Agent Editor). Si un origen de datos de Windows se ha definido en un subnodo, también puede especificar Alteraciones temporales de configuración de subnodo. Consulte Configuración del subnodo.