Configuración de XCT con scripts wsadmin
Puede configurar el rastreo de componentes cruzados (XCT) utilizando scripts wsadmin. Utilice los ejemplos de este tema como guía para crear sus propios scripts wsadmin.
Acerca de esta tarea
Variable | Descripción |
---|---|
miCélula | Nombre de la célula |
miNodo | Nombre de host del nodo |
mi_servidor | Nombre del servidor |
Procedimiento
- Utilice el objeto AdminConfig para configurar XCT.
Los cambios que realice utilizando el objeto AdminConfig entrarán en vigor la próxima vez que inicie el servidor.
- Habilite XCT para el servidor.
De forma predeterminada, XCT está inhabilitado para el servidor. En el ejemplo siguiente se muestra cómo habilitar XCT para el servidor cuando el servidor utiliza la modalidad de registro cronológico y rastreo HPEL (High Performance Extensible Logging). Especifique RASLoggingService en lugar de HighPerformanceExtensibleLogging cuando el servidor utiliza la modalidad básica del registro cronológico y rastreo. Especifique false en lugar de true para inhabilitar XCT.
# eliminar propiedad existente si ya está presente configId = AdminConfig.getid("/Cell:myCell/Node:myNode /Server:myServer/HighPerformanceExtensibleLogging: /Property:com.ibm.websphere.logging.enableCorrelation")if (len(configId) > 0): AdminConfig.remove(configId) # añadir nueva propiedad LoggingService = AdminConfig.getid("/Cell:miCélula/Node:miNodo /Server:miServidor/HighPerformanceExtensibleLogging:/") AdminConfig.create("Property", LoggingService, [["name", "com.ibm.websphere.logging.enableCorrelation"],["value", "true"]]) AdminConfig.save()
- Cambie el valor de registro cronológico para XCT .
De forma predeterminada, el valor de registro cronológico de XCT incluye los ID de solicitud en archivos de registro cronológico y rastreo. En el ejemplo siguiente se muestra cómo hacer que XCT incluya los ID de solicitud en los archivos de registro cronológico y rastreo y registre los registros del registro cronológico de XCT. Especifique REQUEST ID en lugar de LOG para que XCT incluya únicamente los ID de solicitud en los archivos de registro y rastreo. Especifique DATA_SNAPSHOT en lugar de LOG para que XCT incluya los ID de solicitud en los archivos de registro y rastreo, en las entrada de registro de XCT y que capture instantáneas de datos. Especifique RASLoggingService en lugar de HighPerformanceExtensibleLogging cuando el servidor utiliza la modalidad básica del registro cronológico y rastreo.
# eliminar propiedad existente si ya está presente configId = AdminConfig.getid("/Cell:myCell/Node:myNode /Server:myServer/HighPerformanceExtensibleLogging:/Property:com.ibm.websphere .logging.correlationLevel") if (len(configId) > 0): AdminConfig.remove(configId) # añadir nueva propiedad LoggingService = AdminConfig.getid("/Cell:miCélula/Node:miNodo Server:miServidor/HighPerformanceExtensibleLogging:/") AdminConfig.create("Property", LoggingService, [["name", "com.ibm.websphere.logging.correlationLevel"],["value", "LOG"]]) AdminConfig.save()
Best practice: Habilite XCT para incluir los ID de solicitud en los archivos de registro y rastreo cuando desee ver qué entradas de registro y rastreo, en todas las hebras y los procesos de servidor de aplicaciones, están relacionadas con la misma solicitud. Los ID de solicitud sólo se registran cuando se utiliza la modalidad de registro y rastreo HPEL y se pueden ver o utilizar para el filtrado utilizando el mandato logViewer. bprac
Best practice: Habilite XCT para crear registros de anotaciones de correlación cuando desee registrar cómo se ramifican las solicitudes entre las hebras y los procesos y ver información adicional sobre cada solicitud. La habilitación de XCT para crear registros de anotaciones de correlación podría tener un impacto significativo en el rendimiento en el sistema, por lo que se adapta mejor en los entornos de prueba y desarrollo. bprac
Best practice: Habilite XCT para capturar instantáneas de datos cuando desee almacenar todos los cuerpos de solicitud y respuesta en el sistema de archivos. La habilitación de XCT para capturar instantáneas de datos podría tener un impacto significativo de rendimiento en el sistema, así que se adapta mejor para los entornos de prueba y desarrollo. XCT captura las instantáneas de datos para las solicitudes de mensajes y las respuestas manejadas por el SIBus. bprac
Avoid trouble: Las instantáneas de datos se capturan y graban en el directorio $SERVER_LOG_ROOT/snapdata. El servidor de aplicaciones no borra automáticamente los archivos de este directorio. Tendrá que suprimir los archivos de este directorio periódicamente cuando está habilitada la captura de instantáneas de datos. Las instantáneas de datos almacenan todo el contenido de solicitudes y respuestas y podrían incluir información confidencial. Es posible que el uso de esta opción no sea apropiado en entornos de producción. gotcha
- Habilite XCT para el servidor.
- Utilice el objeto AdminControl para configurar XCT. Los cambios que realice mediante el objeto AdminControl entran en vigor inmediatamente.
- Habilite XCT para el servidor.
De forma predeterminada, XCT está inhabilitado para el servidor. En el ejemplo siguiente se muestra cómo habilitar XCT para el servidor cuando el servidor utiliza la modalidad de registro cronológico y rastreo HPEL. Compruebe que el servidor está ejecutándose y especifique RasLoggingService en lugar de HPELControlService cuando el servidor esté utilizando la modalidad básica de registro y rastreo. Especifique false en lugar de true para inhabilitar XCT.
LoggingMBean = AdminControl.queryNames('cell=miCelda,node=miNodo, type=HPELControlService,process=miServidor,*') AdminControl.setAttribute(LoggingMBean, "correlationEnabled", "true")
- Cambie el valor de registro cronológico para XCT .
De forma predeterminada, el valor de registro cronológico de XCT incluye los ID de solicitud en archivos de registro cronológico y rastreo. En el ejemplo siguiente se muestra cómo hacer que XCT incluya los ID de solicitud en los archivos de registro cronológico y rastreo y registre los registros del registro cronológico de XCT. Especifique REQUEST ID en lugar de LOG para que XCT incluya únicamente los ID de solicitud en los archivos de registro y rastreo. Especifique DATA_SNAPSHOT en lugar de LOG para que XCT incluya los ID de solicitud en los archivos de registro y rastreo, en las entrada de registro de XCT y que capture instantáneas de datos. Compruebe que el servidor está ejecutándose y especifique RasLoggingService en lugar de HPELControlService cuando el servidor esté utilizando la modalidad básica de registro y rastreo.
LoggingMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELControlService,process=myServer,*') AdminControl.setAttribute(LoggingMBean, "xctLevel", "LOG")
Best practice: Habilite XCT para incluir los ID de solicitud en los archivos de registro y rastreo cuando desee ver qué entradas de registro y rastreo, en todas las hebras y los procesos de servidor de aplicaciones, están relacionadas con la misma solicitud. Los ID de solicitud sólo se registran cuando se utiliza la modalidad de registro y rastreo HPEL y se pueden ver o utilizar para el filtrado utilizando el mandato logViewer. bprac
Best practice: Habilite XCT para crear registros de anotaciones de correlación cuando desee registrar cómo se ramifican las solicitudes entre las hebras y los procesos y ver información adicional sobre cada solicitud. La habilitación de XCT para crear registros de anotaciones de correlación podría tener un impacto significativo en el rendimiento en el sistema, por lo que se adapta mejor en los entornos de prueba y desarrollo. bprac
Best practice: Habilite XCT para capturar instantáneas de datos cuando desee almacenar todos los cuerpos de solicitud y respuesta en el sistema de archivos. La habilitación de XCT para capturar instantáneas de datos podría tener un impacto significativo de rendimiento en el sistema, así que se adapta mejor para los entornos de prueba y desarrollo. XCT captura las instantáneas de datos para las solicitudes de mensajes y las respuestas manejadas por el SIBus. bprac
Avoid trouble: Las instantáneas de datos se capturan y graban en el directorio $SERVER_LOG_ROOT/snapdata. El servidor de aplicaciones no borra automáticamente los archivos de este directorio. Tendrá que suprimir los archivos de este directorio periódicamente cuando está habilitada la captura de instantáneas de datos. Las instantáneas de datos almacenan todo el contenido de solicitudes y respuestas y podrían incluir información confidencial. Es posible que el uso de esta opción no sea apropiado en entornos de producción. gotcha
- Habilite XCT para el servidor.
Resultados


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ttrb_confXTCwsadmin
File name: ttrb_confXTCwsadmin.html