Generic Log Adapter - Notas de release

Problemas conocidos y soluciones

1.0 Generic Log Adapter
  1.1 El último registro no se procesa cuando Generic Log Adapter se ejecuta continuamente
  1.2 Problemas al invocar el archivo de configuración de Generic Log Adapter
  1.3 Limitación al analizar las anotaciones de WebSphere® Application Server en UNIX
  1.4 Limitación al analizar las anotaciones de error deWebSphere® MQ en UNIX
  1.5 Problemas al analizar los archivos de anotaciones utilizando runregex_showlog_example.bat/sh
  1.6 Datos incorrectos devueltos por DB2® Diagnostic Log Rules Parser
  1.7 El análisis de algunos registros de anotaciones genera información de huso horario incorrecto
  1.8 Elementos de datos ampliados no válidos generados
  1.9 Los scripts de Generic Log Adapter no son legibles en z/OS
  1.10 El script de ejemplo errpt, runregex_errpt_example.sh, de Generic Log Adpater AIX® no funciona en AIX
  1.11 La supervisión continua de archivos de anotaciones con analizadores estáticos no está soportada
  1.12 Información y limitaciones del registro de anotaciones de Generic Log Adapter
  1.13 No se ha realizado la validación sobre el tipo de archivo de anotaciones
  1.14 Limitación al analizar los archivos activity.log de WebSphere Application Server
  1.15 Limitación al analizar archivos de anotaciones generados en un entorno distinto
  1.15 Paneles del editor vacíos al ejecutar archivos del adaptador de análisis estático
  1.17 Problemas al desempaquetar con el programa de utilidad unzip de Windows® XP

1.0 Generic Log Adapter

1.1 El último registro no se procesa cuando Generic Log Adapter se ejecuta continuamente

Cuando Generic Log Adapter está supervisando continuamente un archivo de anotaciones no procesará el último registro si no se especifica ningún patrón final. El último registro solo se procesará cuando Generic Log Adapter esté concluyendo.

Para asegurarse de que el último registro se procesa durante la supervisión, proporcione un patrón final para los registros en el archivo de configuración de Generic Log Adapter.

1.2 Problemas al invocar el archivo de configuración de Generic Log Adapter

El archivo de configuración de Generic Log Adapter no se invoca adecuadamente cuando se llama utilizando el archivo de proceso por lotes gla.bat.

Esto puede resolverse utilizando una vía de acceso absoluta para el archivo de configuración. Por ejemplo, gla.bat c:\mypathname\static.adapter .

1.3 Limitación al analizar las anotaciones de WebSphere Application Server en UNIX

Al analizar la actividad binaria o las anotaciones de servicio de WebSphere Application Server en plataformas UNIX® mediante Generic Log Adapter, el usuario debe tener privilegios iguales o superiores a los del instalador de WebSphere Application Server.

Para solucionar esta limitación, la actividad binaria o las anotaciones de servicio deben moverse a un directorio con los mismos privilegios que el usuario de Generic Log Adapter antes de analizar las anotaciones.

1.4 Limitación al analizar las anotaciones de WebSphere MQ Error en UNIX

Al analizar las anotaciones de error de WebSphere MQ en plataformas UNIX® mediante Generic Log Adapter, el usuario debe tener privilegios iguales o mayores que el instalador de WebSphere MQ.

Para solucionar esta limitación, mueva las anotaciones de error de MQ a un directorio con los mismos privilegios que el usuario de Generic Log Adapter antes de analizar las anotaciones.

1.5 Problemas al analizar los archivos de anotaciones utilizando runregex_showlog_example.bat/sh

Al intentar utilizar runregex_showlog_example.bat y runregex_showlog_example.sh para analizar las anotaciones de actividad de WebSphere Application Server, no se puede encontrar el programa de utilidad de WebSphere Application.

Para solucionar este problema, edite el archivo regex_showlog_example.adapter en el editor de reglas y actualice la propiedad de conversor de sensor para que señale la ubicación del directorio de WebSphere Application Server.

1.6 Datos incorrectos devueltos DB2® Diagnostic Log Rules Parser

Al analizar los archivos de anotaciones de diagnóstico de DB2 con la configuración del adaptador basado en reglas, los mensajes del archivo de anotaciones de la salida analizada incluyen signos de dos puntos extraños.

Actualmente no hay ninguna solución para este problema.

1.7 El análisis de algunos registros de anotaciones genera información de huso horario incorrecto

El análisis de algunos registros de anotaciones genera información de huso horario incorrecto

Solo los archivos de anotaciones con indicaciones de la hora que contengan información de huso horario generarán datos analizados con valores de creationTime que tengan el huso horario correcto. Si las indicaciones de la hora de archivos de anotaciones no contienen información de huso horario, Generic Log Adapter generará valores de creationTime con información de huso horario incorrecta.

1.8 Elementos de datos ampliados no válidos generados

Generic Log Adapter generará un elemento de evento base común extendedDataElements no válido para un registro de anotaciones si no hay ninguna regla que coincida en el nombre o el valor de tipo. extendedDataElement no debe generarse si no se ha analizado ningún nombre o tipo del registro de anotaciones pero Generic Log Adapter generará uno solo con el campo de valor.

Para solucionar este problema, asegúrese de que se proporcionan reglas que originarán la coincidencia de los tres campos (nombre, valor, tipo) de extendedDataElement.

1.9 Los scripts de Generic Log Adapter no son legibles en z/OS®

El desempaquetado de runtime.zip y rules.zip en z/OS® genera a veces archivos de script no legibles.

Para evitar este problema, asegúrese de seguir el procedimiento que se indica a continuación al desempaquetar runtime.zip y rules.zip en un sistema z/OS.

unzip -a runtime.zip
unzip -a rules.zip
unzip -o rules.zip *.adapter

1.10 El script de ejemplo errpt, runregex_errpt_example.sh, de Generic Log Adpater AIX® no funciona en AIX

El script de ejemplo errpt runregex_errpt_example.sh de Generic Log Adpater AIX no funciona en un sistema AIX

Para solucionar este problema, edite el archivo del adaptador de ejemplo errpt de AIX GenericLogAdapter\config\AIX\syslog\v4\regex_errpt_example.adapter con el editor de configuraciones de Generic Log Adapter y haga los cambios siguientes:

  1. Cambie la propiedad de conversor del sensor para que tenga el valor errpt -a >/tmp/errpt.out.
  2. Añada una propiedad nueva al sensor con el nombre shell y el valor sh.
1.11 La supervisión continua de archivos de anotaciones con analizadores estáticos no está soportada

No puede supervisar los archivos de anotaciones continuamente con clases de analizador Java estático. Utilice el analizador basado en reglas, si existe uno, para supervisar continuamente estos archivos de anotaciones.

1.12 Información y limitaciones del registro de anotaciones de Generic Log Adapter

Cuando Generic Log Adapter se ejecuta fuera de un entorno Eclipse anota mensajes y errores en un archivo llamado hgla.log. Cuando se ejecuta en modalidad autónoma, hgla.log se crea en el directorio de trabajo actual.  Cuando se ejecuta como parte de una operación de importación de anotaciones remotas mediante el Analizador de anotaciones y rastreo, hgla.log se ubicará en el sistema remoto en el directorio /tmp si está ejecutando en un sistema UNIX o Linux o en c:\Documents and Settings\userid\Local Settings\Temp si esta ejecutando en un sistema Windows®.  Generic Log Adapter anota los eventos con niveles de anotación 10, 20, 30, 50 y 60. El archivo hgla.log puede importarse en el Analizador de anotaciones y rastreo para diagnosticar problemas encontrados por Generic Log Adapter al analizar el archivo de anotaciones.

Cuando se ejecuta dentro de un entorno Eclipse, por ejemplo como parte de una operación de importación local mediante el Analizador de anotaciones y rastreo, Generic Log Adapter no anota los mensajes en el archivo hgla.log ni en ninguna otra ubicación.

1.13 No se ha realizado la validación sobre el tipo de archivo de anotaciones

Generic Log Adapter no ha realizado una validación para determinar si el tipo de archivo de anotaciones que se analiza coincide con la configuración del archivo de adaptador. Por ejemplo, si el archivo de anotaciones especificado en la configuración del sensor del archivo de adaptador no es del tipo para el que se han diseñado las reglas de sustitución y configuración de extractor en la configuración del analizador, pueden producirse resultados impredecibles. El análisis puede ser satisfactorio sin errores pero los datos de Evento base común serán incorrectos.  El análisis puede fallar con mensajes de error que indiquen que se han encontrado datos incorrectos.

Para solucionar este problema, asegúrese de que el archivo de anotaciones especificado en la configuración del componente de sensor es del tipo correcto.

1.14 Limitación al analizar los archivos activity.log de WebSphere Application Server

Al analizar archivos de anotaciones de actividad binarios de WebSphere Application Server en sistemas que no estén en inglés utilizando runregex_showlog_example.bat/sh, los datos del registro de anotaciones no se correlacionarán satisfactoriamente con un Evento base común.  En lugar de esto, algunos datos del registro de anotaciones pueden aparecer en el campo incorrecto de Common Base Event.

1.15 Limitación al analizar archivos de anotaciones generados en un entorno distinto

Al analizar los archivos de anotaciones que contienen indicaciones de la hora en un entorno local distinto del entorno local en el que se está ejecutando Generic Log Adapter y utilizando un archivo de adaptador basado en reglas configurado para utilizar el atributo de formato horario en la regla de sustitución para creationTime, es posible que la indicación de la hora y otros datos del registro de anotaciones no se analicen correctamente.  Por ejemplo, al analizar un archivo de anotaciones de acceso a un servidor IBM® HTTP Server en inglés desde una máquina japonesa utilizando   config\IHS\access\v1.3.19.3\runregex_example.bat/sh, los valores de creationTime de los eventos base comunes resultantes tendrán un valor de cero y el campo de mensaje del evento base común estará en blanco.

Para solucionar este problema, cambie el archivo runregex_example.bat/sh añadiendo los parámetros JVM siguientes al mandato java:

-Duser.language=2-char-language-code -Duser.region=2-char-country-code

donde los códigos de idioma y país son para el entorno local en el que están las indicaciones de la hora. Para el ejemplo mencionado, los parámetros de JVM serían:

-Duser.language=en -Duser.region=US
1.16 Paneles del editor vacíos al ejecutar archivos del adaptador de análisis estático

Al ejecutar un archivo de adaptador de analizador estático en el editor de configuraciones de Generic Log Adapter, los paneles Resultado del extractor y Resultado del formateador están vacíos. Esto es porque un adaptador de analizador estático no contiene un componente extractor ni formateador. Sin embargo, si el archivo de adaptador de analizador estático está configurado correctamente, el panel Resultado del sensor debe contener datos. La salida del sensor del analizador estático, son eventos base comunes que representan los registros de anotaciones analizados. El panel Resultado del sensor contendrá los eventos base comunes en formato de serie. Si el panel Resultado del sensor está vacío después de pulsar el botón Volver a ejecutar adaptador, pulse el botón Mostrar anotaciones en la barra de herramientas en la parte superior del panel Resultado del extractor para visualizar la salida del sensor en el panel Resultado del sensor.

1.17 Problemas al desempaquetar con el programa de utilidad unzip de Windows XP

Al instalar Generic Log Adapter en Windows XP, se producen problemas al desempaquetar el archivo rules.zip de Generic Log Adapter con el programa de utilidad unzip nativo de Windows XP. Algunos directorios y archivos no se han desempaquetado. Como resultado de este problema, algunos tipos de archivo de anotaciones no pueden analizarse utilizando Generic Log Adapter.Para solucionar este problema, al instalar en Windows XP, utilice otro programa de utilidad de desempaquetado como por ejemplo WinZip o UnZip.

Volver al archivo readme principal