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.
(Windows) logViewer.bat
(Unix - perfil completo) logViewer.sh
(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]](../images/ngzos.gif)
- 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