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 de Liberty con un repositorio del que se va a leer.
vía_acceso_repositorio
Especifique la vía de acceso a un repositorio del que se va a leer. Este suele ser el directorio que contiene los directorios logdata y tracedata.
Nota: si no se especifica ni un nombre_servidor ni una vía_acceso_repositorio en la línea de mandatos, se realiza la tarea con la instancia de 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
Filtro basado en la fecha mínima de creación del registro. Se debe especificar el valor como una fecha (por ejemplo --minDate="2/20/13") o como fecha y hora (por ejemplo --minDate="2/20/13 16:47:21:445 EST").
- --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").
- --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. El valor debe ser uno de los 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 * de comodín.
- --includeMessage=valor
Filtro basado en el nombre de mensaje. El valor puede incluir * de comodín.
- --includeThread=valor
Incluir los 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 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.
- --format={basic | advanced | CBE-1.0.1}
- copiar
- 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 de Liberty con un repositorio del que se va a leer.
- vía_acceso_repositorio
Especifique la vía de acceso a un repositorio del que se va a leer. Este suele ser el directorio que contiene los directorios logdata y tracedata.
- 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.
- Nota: Se debe especificar el nombre_servidor o la vía_acceso_repositorio, así como la vía_acceso_destino.
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. Se debe especificar el valor como una fecha (por ejemplo --minDate="2/20/13") o como fecha y hora (por ejemplo --minDate="2/20/13 16:52:32:808 EST").
- --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:52:32:808 EST").
- --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. El valor debe ser uno de los 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 * de comodín.
- --excludeLogger=valor[,valor]*
Excluir los registros con el nombre de registrador especificado. El valor puede incluir * de comodín.
- --includeMessage=valor
Filtro basado en el nombre de mensaje. El valor puede incluir * de comodín.
- --includeThread=valor
Incluir los 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 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_acceso_repositorio}
- serverName
Especifique el nombre de un servidor de Liberty con un repositorio del que se va a leer.
- vía_acceso_repositorio
Especifique la vía de acceso a un repositorio del que se va a leer. Este suele ser el directorio que contiene los directorios logdata y tracedata.
- Nota: si no se especifica ni un nombre_servidor ni una vía_acceso_repositorio en la línea de mandatos, se realiza la tarea con la instancia de servidor predeterminada, defaultServer, si existe.
- 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 de 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 los mensajes de registro de un repositorio en /apps/server1/logs;
incluir solo lo que se han escrito en la corriente de errores de un repositorio específico.
binaryLog view /apps/server1/logs --includeLogger=SystemErr
- Ver los sucesos del repositorio de defaultServer que se han producido antes del 14 de septiembre de 2012 4:28 PM, hora EDT (Eastern Daylight
Time).
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 los sucesos desde el defaultServer utilizando uno de los ID de instancia
del ejemplo anterior:
binaryLog view --includeInstance=1358871281166
- Copiar los sucesos del defaultServer, cuyo nivel especificado es WARNING
o superior, de la última instancia de servidor en un nuevo repositorio en
el directorio d:\toSupport.
binaryLog copy defaultServer d:\toSupport --minLevel=warning --includeInstance=latest
- Mostrar todos los sucesos en el repositorio de defaultServer entre el 19 de julio de 2013 y el 2 de agosto de 2013.