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.

El recurso de registro cronológico binario y rastreo graba en un repositorio en formato binario. Puede ver, consultar y filtrar el repositorio utilizando el mandato binaryLog. El mandato binaryLog proporciona opciones para convertir rápidamente el contenido del repositorio en un archivo de texto en distintos formatos, como básico y avanzado. El mandato también proporciona opciones para obtener los datos que necesita de los registros más fácilmente. Por ejemplo, puede filtrar qué registros de anotaciones desea por nivel, nombre de registrador o fecha y hora.

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").

    [17.0.0.1 and later]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").

    [17.0.0.1 and later]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.

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.

  • [17.0.0.1 and later]--isoDateFormat

    Especifica que se utiliza el formato de fecha y hora ISO-8601 para la salida.

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").

    [17.0.0.1 and later]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").

    [17.0.0.1 and later]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.

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.
[17.0.0.1 and later]
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.
[17.0.0.1 and later]Opción de salida:
  • --isoDateFormat

    Especifica que se utiliza el formato de fecha y hora ISO-8601 para la salida.

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
  • [17.0.0.1 and later]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.
  • [17.0.0.1 and later]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

Icono que indica el tipo de tema Tema de referencia

Nombre de archivo: rwlp_logviewer.html