Notas del release del adaptador de anotaciones genérico

© Copyright International Business Machines Corporation 2000, 2007. Reservados todos los derechos. Derechos restringidos para los usuarios del Gobierno de EE.UU. El uso, la duplicación o la distribución están restringidos por GSA ADP Schedule Contract con IBM Corp.

Notas del release

1.0 Limitaciones, problemas y soluciones conocidas
   1.1 No se ha procesado el último registro durante la ejecución continua del adaptador de anotaciones genérico
   1.2 Limitación al analizar los registros de WebSphere Application Server en UNIX
   1.3 Limitación al analizar los registros de error de WebSphere MQ en UNIX
   1.4 Información de registro del adaptador de anotaciones genérico
   1.5 No se ha realizado ninguna validación en el tipo de archivo de registro
   1.6 Limitación al analizar archivos de registro generados en un entorno local diferente
   1.7 Es posible que el análisis de archivos de registros con símbolos de huso horario de tres letras no exclusivos devuelvan horas de creación de sucesos incorrectas.
   1.8 Los sucesos Common Base Events analizados para el registro DB2 Express Diagnostic no deben especificarse.
   1.9 Error de validación del adaptador al analizar el archivo de registro
   1.10 Errores de formateador al analizar el archivo de registro
   1.11 Problemas de configuración al analizar registros

1.0 Limitaciones, problemas y soluciones conocidas

1.1 No se ha procesado el último registro durante la ejecución continua del adaptador de anotaciones genérico

El adaptador de anotaciones genérico se incluye con Agent Controller. El adaptador de anotaciones genérico permite crear un adaptador para formatos de registro personalizados. Si un adaptador de anotaciones genérico supervisa de forma continuada un archivo de registro, no procesará el último registro en el caso de que no se haya especificado ningún patrón final. El último registro sólo se procesará cuando se cierre el adaptador de anotaciones genérico.

Para garantizar el procesamiento del último registro durante la supervisión, proporcione un patrón final para los registros en el archivo de configuración del adaptador de anotaciones genérico.

1.2 Limitación al analizar los registros de WebSphere Application Server en UNIX

Cuando se analiza actividad binaria de WebSphere® Application Server o registros de servicios en plataformas UNIX™ utilizando el adaptador de anotaciones genérico, el usuario debe tener privilegios similares o superiores a los del instalador de WebSphere Application Server.

Para solucionar esta limitación, mueva la actividad binaria o los registros de servicios a un directorio con los mismos privilegios que el usuario del adaptador de anotaciones genérico antes de analizar los registros.

1.3 Limitación al analizar los registros de error de WebSphere MQ en UNIX

Al analizar los registros de error de WebSphere MQ en plataformas UNIX mediante el adaptador de anotaciones genérico, el usuario deberá tener los mismos o más privilegios que el programa de instalación de WebSphere MQ.

Para solucionar esta limitación, mueva los registros de error MQ a un directorio con los mismos privilegios que el usuario del adaptador de anotaciones genérico antes de analizar los registros.

1.4 Información de registro cronológico del adaptador de anotaciones genérico

Cuando el adaptador de anotaciones genérico se ejecuta en modalidad autónoma, fuera del entorno Eclipse, registra mensajes y errores en un archivo denominado hgla.log en el directorio de trabajo actual. Si el archivo hgla.log ya existe en el directorio de trabajo actual, se creará un archivo de registro nuevo denominado hgla.nnnnnnnn.log donde nnnnnnnn es un número exclusivo. Cuando el adaptador de anotaciones genérico se ejecuta como parte de una operación de importación de registro, los mensajes de error que se registran se muestran en un diálogo de error del analizador de rastreo y registro.

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

El adaptador de anotaciones genérico registra sucesos con los niveles de registro 5, 10, 20, 30, 50 y 60, en función de la definición del nivel de registro para los contextos y componentes del archivo de configuración del adaptador. El archivo hgla.log puede importarse al analizador de rastreo y registros, como tipo de archivo Common Base Event XML para diagnosticar los problemas detectados por el adaptador de anotaciones genérico al analizar el archivo de registro.

1.5 No se ha realizado ninguna validación en el tipo de archivo de registro

El adaptador de anotaciones genérico no ha realizado ninguna validación para determinar si el tipo de archivo de registro que se está analizando coincide con la configuración del archivo del adaptador.  Por ejemplo, si el archivo de registro especificado en la configuración del sensor del archivo del adaptador no es del tipo para el cual se han diseñado las reglas de sustitución y configuración del extractor de la configuración del analizador, es posible que se produzcan resultados imprevisibles.  Es posible que el análisis se realice correctamente sin errores pero que los datos del Common Base Event sean incorrectos.  Es posible que el análisis falle y contenga mensajes de error que indiquen la detección de datos incorrectos.

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

1.6 Limitación al analizar archivos de registro generados en un entorno local diferente

Al analizar archivos de registro que contienen indicaciones de hora en un entorno local diferente del entorno local en el que se ejecuta el adaptador de anotaciones genérico, utilizando un archivo de adaptador basado en reglas para utilizar el atributo de formato de hora en la regla de sustitución para creationTime, es posible que la indicación de hora y otros datos de grabación de registro no se analicen correctamente. Por ejemplo, es posible que los valores creationTime de los sucesos Common Base Event resultantes sean cero y que el campo msg de Common Base Event aparezca en blanco.

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

1.7 Es posible que el análisis de archivos de registros con símbolos de huso horario de tres letras no exclusivos devuelvan horas de creación de sucesos incorrectas

Cuando se convierten archivos de registro que utilizan símbolos de zonas horarias de tres letras al formato Common Base Event utilizando el adaptador de anotaciones genérico, es posible que se produzcan horas de creación incorrectas para los sucesos de registros si el símbolo de zona horaria de tres letras no es exclusivo. Por ejemplo, el símbolo de tres letras "IST" también se podría interpretar como Israeli Standard Time (hora estándar de Israel), Indian Standard Time (hora estándar de la India), Iran Standard Time (hora estándar de Irán) o Irish Summer Time (hora de verano de Irlanda). 

1.8 Los sucesos Common Base Events analizados para el registro DB2 Express Diagnostic no cumplen la especificación.

 Si analiza un registro de IBM® DB2® Express Diagnostic con los adaptadores en GLA_INSTALL\GenericLogAdapter\config\DB2\diag\tool, los sucesos Common Base Event resultantes escritos en el archivo de salida infringen algunas de las especificaciones de Common Base Event. Esto se debe a un error en el programa de utilidad db2diag.exe que se utiliza para converir los registros de DB2 Diagnostic en sucesos Common Base Event. Esto no debería, en caso alguno, afectar a la operación de análisis. No hay solución alternativa conocida hasta que se corrija db2diag.exe.

1.9 Error de validación del adaptador al analizar el archivo de registro

El hecho de analizar un archivo de registro con un archivo de adaptador creado mediante una versión anterior del editor de configuración del adaptador puede provocar que el mensaje de error siguiente se escriba en el archivo de registro del adaptador de anotaciones genérico, 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 configuración del adaptador han creado archivos de adaptador sin el atributo del extractor lineBreakSymbol necesario. Este atributo debe estar presente en el elemento Extractor, aunque tenga un valor vacío. Ahora, el adaptador de anotaciones genérico valida el archivo del adaptador con el esquema del adaptador de anotaciones genérico antes de utilizarlo y lineBreakSymbol es un atributo obligatorio del esquema.

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

1.10 Errores del formateador al analizar un archivo de registro

El hecho de analizar un archivo de registro con un archivo de adaptador mediante una versión anterior del editor de configuración del adaptador puede provocar que mensajes de error como el siguiente se escriban en el archivo de registro del adaptador de anotaciones genérico hgla.log:

IWAT0438E El formateador de evento base común (CBE) N76D20B0042411D98000E0362B33D6F0 no puede crear un CommmonBaseEvent porque falta la propiedad necesaria sourceComponentId.

Este mensaje indica que el componente del formateador de del adaptador de anotaciones genérico no ha podido crear un Common Base Event porque sourceComponentId es una propiedad requerida de Common Base Event y falta. El adaptador de anotaciones genérico comprueba que todas las propiedades necesarias estén presentes en el Common Base Event y si faltan propiedades, no se devolverá Common Base Event. Es posible que el archivo del adaptador no haya analizado reglas de las propiedades indicadas en los mensajes o que las reglas de análisis no sean correctas.

Para solucionar este problema, añada reglas de análisis al archivo del adaptador para las propiedades Common Base Event requeridas que faltan o verifique que las reglas existentes son correctas.

1.11 Problemas de configuración al analizar registros

Al analizar registros, es posible que se escriban los mensajes de error siguientes en la consola:

IWAT0310E El adaptador de anotaciones genérico no se ha podido iniciar debido a problemas de configuración.
IWAT0317E Error al construir el componente AdapterLogSensor.
IWAT0319E No se puede crear una instancia de la clase org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor.  Excepción = org/eclipse/emf/ecore/EObject

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