© 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.
En las Notas de release de TPTP V4.2 encontrará información adicional asociada al adaptador de anotaciones genéricas (GLA) de TPTP.
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).
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
Al analizar las anotaciones, pueden aparecer los mensajes siguientes en la consola:
IWAT0310E No se ha podido iniciar el adaptador de anotaciones genéricas (GLA) debido a problemas de configuración. IWAT0317E Se ha producido un 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/EObjectPara 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: