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

La especificación com.ibm.ws.webservices.engine.*=all=enabled sólo rastrea el tiempo de ejecución de servicios web. Consulte el paso 4 para obtener los valores que puede utilizar para rastrear los mensajes SOAP y las excepciones definidas por el usuario o revise el rastreo de mensajes SOAP con tcpmon para obtener más información sobre el rastreo de los mensajes SOAP con el proceso tcpmon.

Acerca de esta tarea

Las siguientes tareas describen cómo puede habilitar el rastreo para los servicios web:

Procedimiento

  1. Habilite el rastreo para un cliente no gestionado de servicios web.
    1. [AIX Solaris HP-UX Linux Windows][z/OS]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.
    2. [IBM i]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.
    3. [AIX Solaris HP-UX Linux Windows][z/OS]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.
    4. [IBM i]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.
    5. Edite el archivo de propiedades para eliminar com.ibm.ejs.ras.*=all=enabled y añadir com.ibm.ws.webservices.engine.*=all=enabled.
    6. 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.
  2. 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:
    [AIX Solaris HP-UX Linux Windows][z/OS]
    %raíz_instalación%\bin\launchClient MiClienteApl.ear
    -CCtrace=com.ibm.ws.webservices.engine.*=all=enabled -CCtracefile=miClienteApl.trc
    [IBM i]
    raíz_servidor_aplic/bin/launchClient MiClienteAplic.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.
  3. Habilite el rastreo para una aplicación Java EE) (Java Platform, Enterprise Edition) de servicios web.
    1. Inicie WebSphere Application Server.
    2. Abra la consola administrativa.
    3. Pulse Servidores > Servidores de aplicaciones > servidor.
    4. Pulse Cambiar los niveles de detalle del registro.
    5. 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
    6. Pulse Guardar y Aplicar.
    Para obtener más información sobre cómo habilitar el rastreo, consulte la información sobre configuración del registro cronológico.
  4. 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 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

Resultados

Ha habilitado el rastreo para los clientes no gestionados, los clientes gestionados y las aplicaciones de servidor. En función de la especificación de la serie de rastreo, éste puede incluir componentes de tiempo de ejecución, excepciones definidas por el usuario y mensajes SOAP.

Qué hacer a continuación

Analice los datos del mensaje.

Icon that indicates the type of topic Task topic



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