Opciones de mandato BinaryLog
Utilice el mandato binaryLog para ver o copiar el contenido de un repositorio de registro cronológico binario o enumerar las instancias de proceso servidor disponibles en el repositorio. El mandato binaryLog es equivalente al mandato logViewer en el directorio bin de perfil del servidor de aplicaciones tradicional.
Sintaxis
La sintaxis del mandato es la siguiente:
binaryLog acción {nombre_servidor | vía_acceso_repositorio} [opciones]
El valor de opciones es distinto según el valor de acción.
Parámetros
Están disponibles las acciones siguientes para el mandato binaryLog:
- view
- Lee un repositorio, opcionalmente lo filtra, y crea una versión
que los usuarios pueden leer.
La sintaxis del mandato es la siguiente:
binaryLog view {nombre_servidor | vía_acceso_repositorio} [opciones]
nombre_servidor
Especifique el nombre de un servidor Liberty con un repositorio para leer.
vía_acceso_repositorio
Especifique la vía de acceso a un repositorio del que se va a leer. Normalmente, esta vía de acceso es el directorio que contiene tanto los datos de registro, como los directorios de datos de rastreo.
Nota: Especifique una línea de mandatos o un valor para serverName y un valor para repositoryPath. De lo contrario, la tarea se ejecuta en la instancia del servidor predeterminada, defaultServer, si existe. Opciones de filtrado:
Todos los filtros son opcionales. Cuando se utilizan varios filtros, se realiza un AND lógico de todos ellos.
- --minDate=valor
Un filtro basado en una fecha de creación de registro mínima. El valor se debe especificar como una fecha (por ejemplo --minDate="23/01/17") o una fecha y una hora (por ejemplo --minDate="23/01/17 17:39:53:100 EST").
También puede especificar la fecha y ora en formato ISO-8601. Por ejemplo, especifique --minDate="2017-01-23" o --minDate="2017-01-23T17:39:53.100-0500".
- --maxDate=valor
Filtro basado en la fecha máxima de creación del registro. Se debe especificar el valor como una fecha (por ejemplo --maxDate="2/20/13") o como fecha y hora (por ejemplo --maxDate="2/20/13 16:47:21:445 EST").
También puede especificar la fecha y ora en formato ISO-8601. Por ejemplo, especifique --maxDate="2017-01-23" o --maxDate="2017-01-23T17:39:53.100-0500".
- --minLevel=valor
Filtro basado en el nivel mínimo. El valor debe ser uno de los siguientes FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL.
- --maxLevel=valor
Filtro basado en el nivel máximo. Debe especificar uno de los valores siguientes: FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL.
- --includeLogger=valor[,valor]*
Incluir los registros con el nombre de registrador especificado. El valor puede incluir * como carácter comodín.
- --includeMessage=valor
Filtro basado en el nombre de mensaje. El valor puede incluir * como carácter comodín.
- --includeThread=valor
Incluya registros con el ID de hebra especificado. Los valores deben estar en hexadecimal (por ejemplo, --includeThread=2a).
- --includeExtension=nombre=valor[,nombre=valor]*
Incluir los registros con el nombre de extensión y valor especificados. El valor puede incluir * o ? como carácter comodín. Para incluir una coma en el valor, debe utilizar "\,"
- --includeInstance=valor
Incluir los registros desde la instancia de servidor especificada. El valor debe ser "latest" o un ID de instancia válido. Ejecute este mandato utilizando la acción listInstances para ver una lista de ID de instancia válidos.
- --minDate=valor
- Opción monitor:
- --monitor
Supervisar continuamente el repositorio y generar la salida del nuevo contenido a medida que se genera.
Opciones de salida:- --format={basic | advanced | CBE-1.0.1}
Especifique el formato de salida que se va a utilizar. "basic" es el formato predeterminado.
- --encoding=valor
Especifique la codificación de caracteres que se va a utilizar para la salida.
--isoDateFormat
Especifica que se utiliza el formato de fecha y hora ISO-8601 para la salida.
- --format={basic | advanced | CBE-1.0.1}
- copy
- Lee un repositorio, opcionalmente lo filtra, y graba el contenido en un nuevo repositorio.
- La sintaxis del mandato es la
siguiente:
binaryLog copy {nombre_servidor | vía_acceso_repositorio} vía_acceso_destino [opciones]
- serverName
Especifique el nombre de un servidor Liberty con un repositorio para leer.
- vía_acceso_repositorio
Especifique la vía de acceso a un repositorio del que se va a leer. Esta vía de acceso suele ser el directorio que contiene los directorios de datos de registro y de datos de rastreo.
- vía_acceso_destino
Especifique la vía de acceso en la que se va a crear un nuevo repositorio. Se debe especificar la vía_acceso_destino. El valor serverName o repositoryPath también se debe especificar.
Opciones de filtrado:
- Todos los filtros son opcionales. Cuando se utilizan varios filtros,
se realiza un AND lógico de todos ellos.
- --minDate=valor
Filtro basado en la fecha mínima de creación del registro. El valor se debe especificar como una fecha (por ejemplo --minDate="23/01/17") o una fecha y una hora (por ejemplo --minDate="23/01/17 17:39:53:100 EST").
También puede especificar la fecha y ora en formato ISO-8601. Por ejemplo, especifique --minDate="2017-01-23" o --minDate="2017-01-23T17:39:53.100-0500".
- --maxDate=valor
Filtro basado en la fecha máxima de creación del registro. El valor se debe especificar como una fecha (por ejemplo --maxDate="23/01/17") o como una fecha y hora (por ejemplo --maxDate="23/01/17 17:39:53:100 EST").
También puede especificar la fecha y ora en formato ISO-8601. Por ejemplo, especifique --maxDate="2017-01-23" o --maxDate="2017-01-23T17:39:53.100-0500".
- --minLevel=valor
Filtro basado en el nivel mínimo. Debe utilizar uno de los valores siguientes: FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL.
- --maxLevel=valor
Filtro basado en el nivel máximo. Debe utilizar uno de los valores siguientes: FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL.
- --includeLogger=valor[,valor]*
Incluya registros con el nombre de registrador especificado. El valor puede incluir * como carácter comodín.
- --excludeLogger=valor[,valor]*
Excluir los registros con el nombre de registrador especificado. El valor puede incluir * como carácter comodín.
- --includeMessage=valor
Filtro basado en el nombre de mensaje. El valor puede incluir * como carácter comodín.
- --includeThread=valor
Incluya registros con el ID de hebra especificado. Los valores deben estar en hexadecimal (por ejemplo, --includeThread=2a).
- --includeExtension=nombre=valor[,nombre=valor]*
Incluir los registros con el nombre de extensión y valor especificados. El valor puede incluir * o ? como carácter comodín. Para incluir una coma en el valor, debe utilizar "\,"
- --includeInstance=valor
Incluir los registros desde la instancia de servidor especificada. El valor debe ser "latest" o un ID de instancia válido. Ejecute este mandato utilizando la acción listInstances para ver una lista de ID de instancia válidos.
- --minDate=valor
- listInstances
- Enumera los ID de instancias de servidor del repositorio. Una instancia de servidor es la colección de registros de registro cronológico o rastreo grabados desde el momento en que se ha iniciado un servidor hasta que se ha detenido. Los ID de instancia de servidor se pueden utilizar con la opción --includeInstance de la acción binaryLog view.
- La sintaxis del mandato es la siguiente:
binaryLog listInstances {nombre_servidor | vía_repositorio} [opciones]
- serverName
Especifique el nombre de un servidor Liberty con un repositorio para leer.
- vía_acceso_repositorio
Especifique la vía de acceso a un repositorio del que se va a leer. Esta vía de acceso suele ser el directorio que contiene los directorios de datos de registro y de datos de rastreo.
- Nota: Especifique una línea de mandatos o un valor para serverName y un valor para repositoryPath. De lo contrario, la tarea se ejecuta en la instancia del servidor predeterminada, defaultServer, si existe.
Opción de salida:
- --isoDateFormat
Especifica que se utiliza el formato de fecha y hora ISO-8601 para la salida.
- --isoDateFormat
- Tenga en cuenta las optimizaciones de filtrado binaryLog. La herramienta binaryLog filtra los datos de registro y rastreo de forma más eficiente cuando se utiliza con las siguientes opciones de filtrado:
- --minDate
- --maxDate
- --includeThread
- --minLevel
- --maxLevel
- Ejemplo de uso
Consulte los ejemplos siguientes de mandatos binaryLog.
- Mostrar todos los sucesos en el repositorio defaultServer entre
el 19 de julio de 2013 y el 2 de agosto de 2013.
binaryLog view --minDate=07/19/13 --maxDate=08/02/13
- Mostrar los registros nuevos del servidor myServer, cuyo nivel especificado
es WARNING o superior utilizando el formato avanzado cuando el servidor
los escribe en el repositorio de registro.
binaryLog view myServer --monitor --minLevel=WARNING --format=advanced
- Escribir mensajes de registro de un repositorio en
/apps/server1/logs; incluir solo los mensajes de
registro que se han escrito en la corriente de errores de un
repositorio específico.
binaryLog view /apps/server1/logs --includeLogger=SystemErr
- Ver sucesos del repositorio defaultServer que se hayan producido
antes del 14 de setiembre de 2012 a las 4:28 PM EDT (horario de
verano del Este).
binaryLog view --maxDate="09/14/12 16:28:00:000 EDT"
- Grabar los sucesos del repositorio defaultServer que contienen una extensión 'thread' con el valor 'Default Executor-thread-4'
binaryLog view --includeExtension=thread="Default Executor-thread-4" --format=advanced
- Ver la lista de instancias de servidor en el repositorio de defaultServer:
binaryLog listInstances Using D:\wlp\usr\servers\defaultServer\logs as repository directory. Instance ID Start Date 1358809441761 1/21/13 18:04:01:761 EST 1358864476191 1/22/13 9:21:16:191 EST 1358869523192 1/22/13 10:45:23:192 EST 1358871281166 1/22/13 11:14:41:166 EST 1358879829000 1/22/13 13:37:09:000 EST 1358892222067 1/22/13 17:03:42:067 EST
- Ver sucesos de defaultServer utilizando uno de los ID de
instancia del ejemplo anterior:
binaryLog view --includeInstance=1358871281166
- Copiar sucesos de defaultServer, cuyo nivel especificado es
WARNING o superior, de la instancia de servidor más reciente en un nuevo repositorio en el directorio
d:\toSupport.
binaryLog copy defaultServer d:\toSupport --minLevel=warning --includeInstance=latest
Consulte la hora y fecha en el formato ISO-8601 para el repositorio defaultServer emitiendo el mandato siguiente:
binaryLog view --isoDateFormat
La salida es la siguiente:[2017-01-16T23:36:43.891-0500] 00000150 servlet I com.ibm.ws.webcontainer.servlet.ServletWrapper doDestroy SRVE0253I: [hello-world] [/hello-world] [/index.jsp]: Destroy successful. [2017-01-16T23:36:43.900-0500] 00000150 AppMessageHel A CWWKZ0009I: La aplicación hello-world se ha detenido correctamente.
Liste los ID de instancias de servidor en el repositorio en el formato ISO-8601 especificando el mandato siguiente:
listInstances --isoDateFormat
La salida es la siguiente:Instance ID Start Date 1484625121871 2017-01-16T22:52:01.871-0500 1484626095175 2017-01-16T23:08:15.175-0500
- Mostrar todos los sucesos en el repositorio defaultServer entre
el 19 de julio de 2013 y el 2 de agosto de 2013.