La herramienta de línea de mandatos LogViewer

Utilice el mandato LogViewer para consultar el contenido de los repositorios de registro y rastreo de HPEL (High Performance Extensible Logging). También puede utilizar el mandato LogViewer para ver las nuevas entradas del repositorio de registro y rastreo a medida que el servidor graba contenido en las mismas.

LogViewer

El recurso HPEL (High Performance Extensible Logging) graba en los repositorios de registro y rastreo en formato binario. Puede ver, consultar y filtrar el repositorio utilizando el mandato LogViewer. El mandato LogViewer proporciona opciones para convertir rápidamente registros HPEL en un archivo de texto en distintos formatos, incluidos básico, avanzado, y formato Common Base Event. El mandato también proporciona opciones para facilitar la obtención de los datos que necesita de los registros; por ejemplo, le permite filtrar los registros deseados por nivel, por nombre de registrador o por fecha y hora.

Utilice el siguiente mandato para ver el contenido completo de los repositorios de registro y de rastreo:
  • [Windows](Windows) logViewer.bat
  • [AIX HP-UX Solaris](Unix - perfil completo) logViewer.sh
  • [AIX HP-UX Solaris](Unix - perfil Liberty) logViewer

Parámetros opcionales

[perfil Liberty] nombre_servidor
Especifica el nombre del servidor cuyos repositorios de datos de registro y rastreo desea que utilice el mandato logViewer. Este parámetro no es necesario en los casos en los que sólo se ha creado un servidor de perfiles Liberty y no así en los casos en los que se especifica la vía de acceso al repositorio de datos del registro y de rastreo utilizando el parámetro -repositoryDir.
-repositoryDir nombre_directorio
Especifica la vía de acceso al directorio del repositorio. En el caso en el que desee consultar de forma conjunta los datos de registro y, también, de rastreo, proporcione la vía de acceso del directorio padre, que contiene ambos directorios, el de datos de registro y datos de rastreo. Si utiliza la ubicación de repositorio predeterminada, profile_root/logs/application_server/, y ejecuta esta herramienta desde el directorio bin de un perfil, este argumento es opcional. La herramienta comprueba la ubicación predeterminada, si no se ha proporcionado ninguna. Si existen varios servidores de aplicaciones en este perfil con repositorios HPEL, se le solicita seleccionar qué repositorio de rastreo y registro de servidor desea ver.
-outLog nombre_archivo
Especifica el nombre de archivo en el que desea que se escriba la salida de texto. Si no proporciona esta información, la salida de texto se visualiza en la consola.
-format basic | advanced | cbe-1.0.1
Especifica el formato de salida. Los formatos soportados incluyen básico, avanzado y el formato CBE-1.0.1. Si no proporciona esta información, la salida está en formato básico.
-monitor [entero]
Especifica que desea que logViewer supervise continuamente el repositorio y dé como salida nuevas entradas de registro a medida que se creen. Puede proporcionar un argumento de entero opcional después de este parámetro para especificar la frecuencia con la que desea que la herramienta LogViewer consulte el repositorio para buscar nuevos registros. De forma predeterminada, logViewer consulta el repositorio para buscar nuevos registros cada 5 segundos. Cuando se utiliza con otras opciones de filtrado, sólo se muestran los nuevos registros que coinciden con los criterios de filtrado.
-help
Utilice este parámetro para que la herramienta LogViewer liste el conjunto completo de opciones disponibles.
-startDatefecha_hora
Puede filtrar los resultados que se visualizan del repositorio por fecha y hora. Utilice el parámetro startDate para filtrar las entradas de registro que se han producido después de la fecha o la hora y fecha proporcionadas como argumento. Proporcione una fecha o una fecha y hora, con el formato MM/dd/aa o con el formato MM/dd/aa H:m:s:S z. z hace referencia al huso horario.
-stopDate fecha_hora
Utilice este parámetro para descartar las entradas del archivo de registro que se han creado después de la fecha u hora especificada. Proporcione el argumento en el mismo formato que para la opción -startDate.
-level nombre_nivel
Especifica que desea que la herramienta muestre únicamente los sucesos de registro que coincidan con el nombre de nivel proporcionado como argumento. Los valores válidos para el nombre de nivel son FINEST, FINER, FINE, DETAIL, CONFIG, INFO, AUDIT, WARNING, SEVERE, FATAL.
-minLevel nombre_nivel
Especifica que desea que la herramienta muestre únicamente los registros del nivel de especificado o superior. Los valores válido para el nombre de nivel son: FINEST, FINER, FINE, DETAIL, CONFIG, INFO, AUDIT, WARNING, SEVERE, FATAL.
-maxLevel nombre_nivel
Especifica que desea que la herramienta muestre únicamente los registros del nivel de especificado o inferior. Los valores válido para el nombre de nivel son: FINEST, FINER, FINE, DETAIL, CONFIG, INFO, AUDIT, WARNING, SEVERE, FATAL.
-includeLoggers nombre_registrador
Cuando se utiliza esta opción, sólo se incluyen los sucesos de registro de los registradores especificados en la salida del LogViewer. Separe las distintas entradas con una coma. El símbolo * se puede utilizar como comodín para incluir todos los registradores que se encuentran bajo un registrador padre. Cuando se utiliza en combinación con la opción -excludedLoggers, la coincidencia más específica determina si el suceso se incluye o se excluye.
-excludeLoggers nombre_registrador
Utilice esta opción para excluir los sucesos de registro de los registradores especificados de la salida del LogViewer. Separe las distintas entradas con una coma. El símbolo * se puede utilizar como carácter comodín para incluir todos los registradores bajo un registrador de nivel superior. Cuando se utiliza en combinación con la opción -includeLoggers, la coincidencia más específica determina si el suceso se incluye o se excluye.
-thread id_hebra
Utilice esta opción para restringir la salida del LogViewer a únicamente los sucesos de registro de una hebra determinada. Los mensajes de registro que no hayan sido creados por el ID de hebra especificado como argumento a esta opción no se mostrarán. Especifique el ID de hebra en formato hexadecimal.
-extractToNewRepositorynombre_directorio
Esta opción redirecciona los registros de rastreo y registro de un repositorio binario a un nuevo repositorio binario en la ubicación que especifique. Puede utilizar esta opción con otras opciones de filtrado para obtener un subconjunto de registros de rastreo y registro en el nuevo repositorio. Esta opción utiliza la vía de acceso de directorio donde se debe escribir el nuevo repositorio como un argumento. Por lo tanto, el directorio debe estar vacío. Si el directorio no existe, se crea el directorio. Sin embargo, los errores que se producen durante la creación del directorio podrían crear directorios extraños.
-listInstances
Utilice esta opción para listar los ID de las instancias de proceso de servidor que están disponibles para ser utilizados con la opción -instance. Tras ejecutar LogViewer con la opción -listInstances, puede utilizar la opción -instance para invocar a LogViewer con uno de los ID de instancia de proceso de servidor como argumento. Puesto que esta opción no procesa ningún registro de rastreo o de registro, se ignoran todas las opciones cuando especifique esta opción.
-instance id_instancia
Utilice esta opción para recuperar los datos de registro y rastreo para una instancia de proceso de servidor determinado proporcionando el ID de instancia de servidor. Ejecute LogViewer, junto con la opción -listInstances, antes de utilizar esta opción para obtener un ID de instancia válido. Esta opción es necesaria al visualizar los registros y el rastreo desde un entorno que contiene subprocesos como, por ejemplo, el sistema operativo z/OS.
Si esta opción se combina con -latestInstance, se ignora -instance.
-latestInstance
Utilice esta opción para recuperar los datos de registro y rastreo de la instancia de servidor más reciente. Si esta opción se utiliza con la opción -instance, se ignora la opción -instance.
-message serie_coincidencia
Utilice esta opción para recuperar sólo los datos de registro y rastreo con un campo de mensaje que coincida con el texto solicitada.
-includeExtensions name[=valor][,name[=valor]]*
Utilice esta opción para recuperar los datos de registro y rastreo don un nombre de extensión que coincida con el nombre solicitado y un valor de extensión que coincida con el valor solicitado. También puede utilizar esta opción para recuperar los datos de registro y de rastreo con un nombre de extensión que coincida con el nombre solicitado y un valor de extensión que coincida con cualquier valor, si omite la parte =value de la opción.
Se puede utilizar cualquier nombre de extensión en el formato avanzado. Tenga en cuenta que 'source', 'class' y 'method' no se almacenan en los repositorios de registro/rastreo como extensiones y, por lo tanto, no se pueden filtrar con esta opción.
Separe varios argumentos name=valor con una coma. Especifique '==' (dos signos igual) en el lugar de '=' (un signo igual) en los casos donde el nombre o el valor debe contener un signo igual. Especifique ',,' (dos comas) en lugar de ',' (una coma) en los casos donde el nombre o el valor debe contener una coma.
-encoding juego_caracteres
Especifica el juego de caracteres que utilizará el mandato LogViewer para la salida de texto.

Consideraciones sobre el filtrado

Tenga presentes las optimizaciones de filtrado LogViewer. La herramienta LogViewer filtra los datos de registro y rastreo de forma más eficiente cuando se utiliza con las siguientes opciones de filtrado:

  • startDate
  • stopDate
  • thread
  • level
  • minLevel
  • maxLevel

Ejemplo de uso

Vea los siguientes ejemplos de mandatos de LogViewer con servidores de perfiles completos en sistemas basados en UNIX. Los ejemplos muestran cómo ejecutar LogViewer desde el directorio bin de un perfil, de forma que no sea necesario el parámetro repositoryDir.

  • Escribir todos los registros en el repositorio predeterminado entre el 19 de julio de 2009 y el 2 de agosto de 2009 a un archivo denominado /tmp/promo.logs.
    logViewer.sh -outLog /tmp/promo.logs -startDate 07/19/2009 -stopDate 08/02/2009
  • Mostrar los registros nuevos cuyo nivel especificado sea WARNING o superior utilizando el formato avanzado a medida que el servidor los grabe en el repositorio de registro.
    logViewer.sh -monitor -minLevel WARNING -format advanced
  • Escribir sólo los mensajes de registro que se han grabado a la corriente de errores de un repositorio específico a un archivo denominado logged_errors.txt.
    logViewer.sh -repositoryDir /apps/server1/logs -includeLoggers SystemErr -outLog logged_errors.txt 
  • Ver los sucesos del repositorio predeterminado que se hayan producido antes del 14 de septiembre de 2009 4:28 PM, hora EDT (Eastern Daylight Time).
    logViewer.sh -stopDate "09/14/2009 16:28:00:000 EDT"
  • Grabar los sucesos del repositorio predeterminado que contienen una extensión de hebra con el valor WebContainer : 6
    logViewer.sh -includeExtensions thread="WebContainer : 6" -format advanced
  • Grabar los sucesos del repositorio predeterminado que formaban parte de la solicitud con un requestID a856cb2c-79ed-4d62-a3cf-a9908b2db07b.
    logViewer.sh -includeExtensions requestID=a856cb2c-79ed-4d62-a3cf-a9908b2db07b
  • Grabar los sucesos del repositorio predeterminado que se crearon en una hebra que presta servicio a la aplicación PlantsByWebSphere.
    logViewer.sh -includeExtensions appName=PlantsByWebSphere
[z/OS]En los sistemas operativos z/OS donde existen varios procesos, debe proporcionar el ID de instancia para identificar el proceso del que desea ver los registros y el rastreo. El ID de instancia de un controlador está representado por un valor numérico, mientras que el ID de instancia de un servant está representado por una combinación de un valor numérico, un nombre de trabajo, un ID de trabajo y un ID de proceso. Para obtener una lista de los ID de instancia válidos, ejecute LogViewer con la opción -listInstances.
  • Invoque a LogViewer con la opción -listInstances; por ejemplo:
    logViewer.sh -listInstances 

    El ejemplo siguiente es una lista de ID de instancia de un controlador y tres servants:

    ID de instancia 					      Fecha de inicio
    1280334046 					5/10/10 18:53:12:770 GMT
    1280334046/000001BC00000002_BBOS1S_STC003119 	5/10/10 18:53:39:220 GMT
    1280334046/000001B400000002_BBOS1S_STC003120 	5/10/10 18:54:44:339 GMT
    1280334046/000001C000000001_BBOS1S_STC003121 	5/10/10 18:55:43:520 GMT
  • Invoque a LogViewer con la opción -instance utilizando uno de los ID de instancia del ejemplo anterior. El tipo de ID es un controlador; por ejemplo:

    logViewer.sh
    -instance 1280334046
  • Invoque a LogViewer con la opción -instance para una instancia de servant; por ejemplo:
    logViewer.sh
    -instance 1280334046/000001BC00000002_BBOS1S_STC003119

Icon that indicates the type of topic Reference topic



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