Notas de releas del adaptador de anotaciones genéricas (GLA)

© Copyright International Business Machines Corporation 2000, 2006. Reservados todos los derechos. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Problemas conocidos y soluciones provisionales

1.0 El último registro no se procesa cuando el adaptador de anotaciones genéricas (GLA) se ejecuta continuamente
1.1 Limitación al analizar las anotaciones de WebSphere Application Server en UNIX
1.2 Limitación al analizar las anotaciones de WebSphere MQ Error en UNIX
1.3 Problemas al analizar los archivos de anotaciones utilizando runregex_showlog_example.bat/sh
1.5 Elementos de datos ampliados no válidos generados
1.7 Información y limitaciones de las anotaciones del adaptador de anotaciones genéricas (GLA)
1.8 No se ha realizado la validación sobre el tipo de archivo de anotaciones
1.9 Limitación al analizar los archivos activity.log de WebSphere Application Server
1.10 Limitación al analizar archivos de anotaciones generados en un entorno distinto
1.12 análisis de archivos de anotaciones con símbolos de huso horario de tres letras no exclusivos puede devolver horas de creación incorrectas para los eventos
1.13 Los eventos base comunes (CBE) analizados para las anotaciones de DB2 Express Diagnostic no cumplen con la especificación
1.14 Error de validación del adaptador al analizar un archivo de anotaciones
1.15 Errores de formato al analizar el archivo de anotaciones
1.16 Problemas de configuración al analizar las anotaciones

En las Notas de release de TPTP V4.2 encontrará información adicional asociada al adaptador de anotaciones genéricas (GLA) de TPTP.

1.0 El último registro no se procesa cuando el adaptador de anotaciones genéricas (GLA) se ejecuta continuamente

El adaptador de anotaciones genéricas (GLA), cuando supervisa 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 el adaptador de anotaciones genéricas (GLA) 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 del adaptador de anotaciones genéricas (GLA).

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

Al analizar las anotaciones de servicio o de actividad binarias de WebSphere Application Server en plataformas UNIX mediante el adaptador de anotaciones genéricas (GLA), el usuario debe tener privilegios iguales o superiores a los del instalador de WebSphere Application Server.

Para solucionar esta limitación, mueva las anotaciones de servicio o de actividad binarias a un directorio con los mismos privilegios que el usuario del adaptador de anotaciones genéricas (GLA) antes de analizar las anotaciones.

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

Al analizar las anotaciones de error de WebSphere MQ en las plataformas UNIX mediante el adaptador de anotaciones genéricas (GLA), 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 del adaptador de anotaciones genéricas (GLA) antes de analizar las anotaciones.

1.3 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.5 Elementos de datos ampliados no válidos generados

El adaptador de anotaciones genéricas (GLA) 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 el adaptador de anotaciones genéricas (GLA) generará uno con solo 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.7 Información de las anotaciones del adaptador de anotaciones genéricas (GLA)

El adaptador de anotaciones genéricas (GLA), cuando se ejecuta en modalidad autónoma fuera de un entorno Eclipse, anota mensajes y errores en un archivo llamado hgla.log en el directorio de trabajo actual. Si el archivo hgla.log ya existe en el directorio de trabajo actual, se crea un archivo de anotaciones nuevo llamado hgla.nnnnnnnn.log, donde nnnnnnnn es un número exclusivo. Cuando el adaptador de anotaciones genéricas se ejecuta como parte de una operación de importación de anotaciones, los mensajes de error que anota se visualizan en un diálogo de error en el analizador de anotaciones y rastreo (LTA).

Al ejecutarse dentro de un entorno de Eclipse en la perspectiva del adaptador de anotaciones genéricas, los mensajes y los errores anotados por el adaptador de anotaciones genéricas se listan en la vista Problemas.

El adaptador de anotaciones genéricas (GLA) anota eventos con niveles de anotación 5, 10, 20, 30, 50 y 60, dependiendo del valor de loggingLevel para los Contextos y Componentes del archivo de configuración del adaptador. El archivo hgla.log puede importarse al analizador de anotaciones y rastreo, como tipo de archivo XML de eventos base comunes (CBE), para diagnosticar los problemas encontrados por el adaptador de anotaciones genéricas (GLA) al analizar el archivo de anotaciones.

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

El adaptador de anotaciones genéricas (GLA) no realiza 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.9 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 del evento base común (CBE).

1.10 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 el adaptador de anotaciones genéricas (GLA) 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, los valores de creationTime en los eventos base comunes (CBE) resultantes pueden ser cero y el campo msg de evento base común puede estar en blanco.

Para solucionar este problema, asegúrese de que los valores de los atributos código de idioma ISO y código de país ISO de la instancia de contexto del archivo de adaptador basado en reglas corresponden al entorno local de las indicaciones de la hora en el archivo de anotaciones a analizar.

1.12 El análisis de archivos de anotaciones con símbolos de huso horario de tres letras no exclusivos puede devolver horas de creación incorrectas para los eventos

Al convertir archivos de anotación que utilicen símbolos de huso horario de tres letras al formato de evento base común (CBE) utilizando el adaptador de anotaciones genéricas (GLA), pueden generarse horas de creación incorrectas para los eventos si el símbolo de huso horario de tres letras no es exclusivo. Por ejemplo, el símbolo de tres letras "IST" puede interpretarse como Israeli Standard Time, Indian Standard Time, Iran Standard Time o Irish Summer Time.

1.13 Los eventos base comunes (CBE) analizados para las anotaciones de DB2 Express Diagnostic no cumplen con la especificación

Si analiza unas anotaciones de IBM DB2 Express Diagnositic con los adaptadores de % GLA_Install%\GenericLogAdapter\config\DB2\diag\tool, los eventos base comunes (CBE) resultantes escritos en el archivo de salida rompen parte de la especificación de eventos base comunes (CBE). Esto es debido a un error del programa de utilidad db2diag.exe que se utiliza para convertir anotaciones de Diagnóstico de DB2 en eventos base comunes (CBE). Esto no debe afectar a la operación de análisis. No habrá ninguna solución para este problema hasta que se arregle db2diag.exe.

1.14 Error de validación del adaptador al analizar un archivo de anotaciones

El análisis de un archivo de anotaciones con un archivo de adaptador creado utilizando una versión anterior del editor de configuraciones de adaptador puede originar el mensaje de error siguiente en el archivo de anotaciones del adaptador de anotaciones genéricas (GLA), hgla.log:

IWAT0383E Error de validación del adaptador: cvc-complex-type.4: El atributo 
'lineBreakSymbol' debe aparecer en el elemento 'ex:Extractor'.

Las versiones anteriores del editor de configuraciones de adaptador creaban archivos de adaptador sin el atributo de Extractor necesario lineBreakSymbol. Este atributo debe estar presente en el elemento Extractor, incluso aunque tenga un valor vacío. Ahora, el adaptador de anotaciones genéricas (GLA) valida el archivo de adaptador con el esquema del adaptador de anotaciones genéricas (GLA) antes de utilizarlo, y lineBreakSymbol es un atributo necesario en el esquema.

Para solucionar este problema, abra el archivo de adaptador en el editor de configuraciones de adaptador, añada un valor no vacío al campo lineBreakSymbol del elemento Extractor, guarde el archivo de adaptador, suprima el valor si no es necesario y vuelva a guardar el archivo. El archivo de adaptador contendrá ahora el atributo lineBreakSymbol en el elemento Extractor.

1.15 Errores de formato al analizar el archivo de anotaciones

El análisis de un archivo de anotaciones con un archivo de adaptador creado utilizando una versión anterior del editor de configuraciones de adaptador puede originar mensajes de error como el siguiente en el archivo de anotaciones del adaptador de anotaciones genéricas (GLA) hgla.log:

IWAT0438E El formateador de eventos base comunes (CBE) N76D20B0042411D98000E0362B33D6F0 no
puede 
crear un CommmonBaseEvent porque falta la propiedad necesaria sourceComponentId.

Este mensaje indica que el componente formateador del adaptador de anotaciones genéricas (GLA) no ha podido crear un evento base común (CBE) debido a que sourceComponentId es una propiedad necesaria de los eventos base comunes (CBE) que no se encuentra. Ahora, el adaptador de anotaciones genéricas (GLA) valida que todas las propiedades estén presenten en el evento base común y si faltan propiedades, no se devuelve el evento base común. Puede ser que el archivo de adaptador no tenga reglas de análisis para las propiedades indicadas en los mensajes o que las reglas de análisis no sean correctas.

Para solucionar este problema, añada las reglas del adaptador al archivo de adaptador para las propiedades de eventos base comunes (CBE) necesarias que faltan o verifique que las reglas sean correctas.

1.16 Problemas de configuración al analizar las anotaciones

Al analizar las anotaciones, pueden aparecer los mensajes siguientes en la consola:

Para solucionar este problema, asegúrese de hacer las actualizaciones siguientes en la opción -classpath de los archivos de script de tiempo de ejecución gla.bat y gla.sh: