Rastreo de servicios web
Puede rastrear los componentes de tiempo de ejecución de servicios web, incluyendo un cliente no gestionado, un cliente gestionado y una aplicación de servidor. La entrada y salida del procedimiento, así como las acciones de proceso pueden rastrearse en los componentes de tiempo de ejecución. También puede rastrear excepciones definidas por el usuario y mensajes SOAP que utilizan JMS (Java™ Message Service) o HTTP para solicitar servicios web.
Antes de empezar
Acerca de esta tarea
Las siguientes tareas describen cómo puede habilitar el rastreo para los servicios web:
Procedimiento
- Habilite el rastreo para un cliente no gestionado de servicios web.
Para crear un archivo de propiedades de rastreo, copie el archivo %dir_raíz_instalación\properties\TraceSettings.properties en el mismo directorio que el archivo JAR (Java Archive) de la aplicación cliente.
Para crear un archivo de propiedades de rastreo, copie el archivo raíz_servidor_apl/properties/TraceSettings.properties al mismo directorio que el archivo JAR (Java Archive) de la aplicación cliente.
Edite el archivo de propiedades y cambie el valor de traceFileName para dar salida a los datos de rastreo. Por ejemplo, traceFileName=c:\\temp\\myAppClient.trc.
Edite el archivo de propiedades y cambie el valor de traceFileName para dar salida a los datos de rastreo. Por ejemplo, traceFileName=/myDir/myAppClient.trc.
- Edite el archivo de propiedades para eliminar com.ibm.ejs.ras.*=all=enabled y añadir com.ibm.ws.webservices.engine.*=all=enabled.
- Añada la opción -DtraceSettingsFile=<archivo_propiedades_rastreo> a la línea de mandatos java que se utiliza para ejecutar el cliente, donde archivo_propiedades_rastreo representa el nombre del archivo de propiedades que ha creado en los subpasos de la "a" a la "c". Por ejemplo, java -DtraceSettingsFile=TraceSettings.properties myApp.myAppMainClass.
- Habilite el rastreo para un cliente gestionado por servicios web invocando
la herramienta de línea de mandatos launchClient con las opciones siguientes:
-CCtrace=com.ibm.ws.webservices.engine.*=all=enabled
-CCtracefile=traceFileName
Por ejemplo:%raíz_instalación%\bin\launchClient MiClienteApl.ear
-CCtrace=com.ibm.ws.webservices.engine.*=all=enabled -CCtracefile=miClienteApl.trc
Para obtener más información sobre esta herramienta, consulte la información sobre la herramienta launchClient.raíz_servidor_aplic/bin/launchClient MiClienteAplic.ear
-CCtrace=com.ibm.ws.webservices.engine.*=all=enabled -CCtracefile=miClienteApl.trc
- Habilite el rastreo para una aplicación Java EE) (Java Platform, Enterprise Edition) de servicios web.
- Inicie WebSphere Application Server.
- Abra la consola administrativa.
- Pulse Servidores > Servidores de aplicaciones > servidor.
- Pulse Cambiar los niveles de detalle del registro.
- Añada o suprima la serie de rastreo en el recuadro de texto. Para esta tarea, suprima
la serie de rastreo *=info y añada la serie de rastreo com.ibm.ws.webservices.engine.*=all=enabled. Puede especificar la serie de rastreo en el recuadro de una de las dos formas siguiente:
- Escriba la serie de rastreo directamente en el recuadro de texto. Las series de rastreo deben separarse
mediante dos puntos (:) sin espacios.
Por ejemplo:
com.ibm.ws.webservices.trace.MessageTrace=finest:com.ibm.ws.webservices. engine.Message=finest
- Elija una serie de rastreo predefinida en la sección que se muestra.
La sección predefinida empieza por
*[Todos los componentes].
Los componentes de servicios web de series de rastreo predefinidos se listan en la
sección com.ibm..ws.*.
- Pulse el signo más (+) para expandir la sección com.ibm.ws.*.
- Pulse la serie de rastreo predefinida. Por ejemplo, si desea añadir una serie de rastreo predefinida para el rastreo de mensajería de SOAP, pulse com.ibm.ws.webservices.trace.MessageTrace.
- Pulse la opción de rastreo en la lista desplegable. Por ejemplo, puede elegir desactivado, muy grave, grave, aviso, auditoría, información, configuración, detalle, preciso, muy preciso, mucho más preciso y todos. Se recomienda la opción mucho más preciso.
Cuando pulsa la opción, ésta se añade al final de la serie de rastreo.
Por ejemplo:
com.ibm.ws.webservices.trace.MessageTrace=finest
- Escriba la serie de rastreo directamente en el recuadro de texto. Las series de rastreo deben separarse
mediante dos puntos (:) sin espacios.
Por ejemplo:
- Pulse Guardar y Aplicar.
- Habilite el rastreo para los mensajes SOAP, para excepciones definidas por el usuario o para los dos. Las siguientes especificaciones de rastreo se utilizan para rastrear mensajes SOAP:
- com.ibm.ws.webservices.trace.MessageTrace=all
Esta especificación rastrea el contenido de un mensaje SOAP, incluidos los datos adjuntos binarios.
Cuando el tipo de contexto del mensaje SOAP no es text ni xml, el mensaje probablemente contiene datos adjuntos. En este caso, el mensaje se visualiza en el archivo de rastreo en el formato de vuelco hex. En el siguiente ejemplo se muestra una línea en el formato de vuelco hex para los mensajes SOAP no de texto:0000: 0D 0A 2D 2D 2D 2D 2D 2D - 3D 5F 50 61 72 74 5F 36 ..------=_Part_6
- En cada línea de archivo de rastreo se muestran 16 bytes del mensaje
- Los cuatro primeros dígitos forman un número hex cuyo valor es el desplazamiento de bytes en el mensaje SOAP del primer byte de la línea.
- Los 16 números hex de dos dígitos siguientes forman el contenido de cada uno de los bytes consecutivos en el mensaje.
- La representación ASCII de los bytes se muestra en los últimos 16 caracteres de la línea, y los caracteres que no pueden imprimirse se representan por un punto.
- *=off:com.ibm.ws.webservices.*=all
Puede rastrear toda la información de servicios web, incluidos los mensajes SOAP y las excepciones definidas por el usuario, con este valor.
Para habilitar el registro cronológico de excepciones definidas por el usuario, especifique la serie de rastreo com.ibm.ws.webservices.trace.UserExceptionTrace=all. De forma predeterminada, las excepciones definidas por el usuario no se registran. Una excepción definida por el usuario es una excepción que se ha definido en el archivo WDSL (Web Services Description Language) correspondiente a una operación.
Una excepción definida por el usuario suele indicar una condición sin errores. Por ejemplo, la excepción OverdrawnException definida por el usuario puede producirse para la implementación de punto final de servicio del método makeWithdrawl. Esta excepción indica una condición esperada y no indica un error en la implementación de punto final de servicio. Puesto que estos tipos de excepciones pueden producirse durante el proceso normal, de manera predeterminada no se registran. Cuando se registra una excepción definida por el usuario, la información se envía al archivo trace.log y no al archivo SystemOut.log.
Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.log y activity.log en sistemas distribuidos y de IBM® i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la información de registro y rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin de perfil de servidor. Consulte la información sobre la utilización de HPEL para resolver problemas de aplicaciones para obtener más información sobre la utilización de HPEL.También puede utilizar las siguientes series de rastreo para habilitar el rastreo para excepciones definidas por el usuario, así como otros puntos de rastreo:- com.ibm.ws.webservices.*=all
Activa todos los registros cronológicos de rastreo de tiempo de ejecución de servicios web.
- com.ibm.ws.webservices.trace.*=all
Activa MessageTrace y UserExceptionTrace.
Avoid trouble: Tenga en cuenta que una vez este rastreo está activado, la carga útil del mensaje SOAP completo se grabará en el archivo de rastreo. Si hay alguna información confidencial (como el ID de usuario o contraseña) en el mensaje SOAP como parte de la carga útil, se emitirá como texto sin formato también. Planifique correctamente proteger la seguridad de su información.gotcha
Nota: Para el servicio web JAX-WS, hay dos formas (nivel normal y nivel mínimo) de imprimir el mensaje SOAP HTTP de salida y el mensaje SOAP HTTP de entrada en el archivo de rastreo.- Nivel normal estableciendo
- com.ibm.ws.websvcs.trace.*=all
- Nivel mínimo estableciendo
- com.ibm.ws.websvcs.trace.MessageTrace=all:com.ibm.ws.websvcs.trace.LogFilterInputStream=all
- com.ibm.ws.webservices.trace.MessageTrace=all
Resultados
Qué hacer a continuación


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