Notas de releas del Adaptador de anotaciones genétrico

© 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

1.0 El último registro no se procesa cuando Generic Log Adapter 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 del registro de anotaciones de Generic Log Adapter
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 Common Base Events mostrados para el registro de 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 con Generic Log Adapter de TPTP.

1.0 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.1 Limitación al analizar las anotaciones de WebSphere Application Server en UNIX

Al analizar la actividad binaria o las anotaciones de servicio de WebSphere(R) Application Server en plataformas UNIXTM 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, mueva las anotaciones de servicio binarias o de servicio a un directorio con los mismos privilegios que el usuario de Generic Log Adapter 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 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.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

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.7 Información del registro de anotaciones de Generic Log Adapter

Cuando Generic Log Adapter 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érico 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.

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

El Adaptador de anotaciones genérico 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 en el Analizador de anotaciones y rastreo, como tipo de archivo XML de Common Base Event, para diagnosticar problemas encontrados por Generic Log Adapter al analizar el archivo de anotaciones.

1.8 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.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 de Common Base Event.

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 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, los valores de creationTime en los Common Base Events resultantes pueden ser cero y el campo msg de Common Base Event 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 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 Common Base Event utilizando el Adaptador de anotaciones, 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 Common Base Events mostrados para el registro de anotaciones de DB2 Express Diagnostic no cumplen con la especificación

Si analiza unas anotaciones de IBM(R) DB2(R) Express Diagnositic con los adaptadores de % GLA_Install%\GenericLogAdapter\config\DB2\diag\tool, los Common Base Events resultantes escritos en el archivo de salida rompen parte de la especificación de Common Base Event. Esto es debido a un error del programa de utilidad db2diag.exe que se utiliza para convertir anotaciones de Diagnóstico de DB2 en Common Base Events. 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 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é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 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érico valida el archivo del adaptador con el esquema del Adaptador de anotaciones genérico antes de utilizarlo y lineBreakSymbol es un atributo necesario en el esquema.

Para solucionar este problema, abra el archivo adaptador en el Editor de configuraciones de adaptador, añada un valor no vacío al campo lineBreakSymbol del elemento Extractor, guarde el archivo adaptador, suprima el valor si no es necesario y vuelva a guardar el archivo. El archivo 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 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érico hgla.log:

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

Este mensaje indica que el componente formateador del Adaptador de anotaciones genérico no ha podido crear un Common Base Event debido a que sourceComponentId es una propiedad necesaria de Common Base Event que no se encuentra. Ahora, el Adaptador de anotaciones genérico valida que todas las propiedades estén presenten en el Common Base Event y si faltan propiedades, no se devuelve el Common Base Event. Puede ser que el archivo 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 adaptador para las propiedades de Common Base Event necesarias faltantes 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:



Avisos

Esta información se ha escrito para productos y servicios ofrecidos en Estados Unidos de América.

IBM puede no ofrecer los productos, servicios o características tratados en este documento en otros países. Consulte con el representante local de IBM para obtener información acerca de los productos y servicios que actualmente están disponibles en su localidad. Las referencias hechas a productos, programas o servicios IBM no pretenden afirmar ni dar a entender que únicamente puedan utilizarse dichos productos, programas o servicios IBM. Puede utilizarse en su lugar cualquier otro producto, programa o servicio funcionalmente equivalente que no vulnere ninguno de los derechos de propiedad intelectual de IBM. No obstante, es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM.

IBM puede tener patentes o solicitudes de patente pendientes de aprobación que cubran alguno de los temas tratados en este documento. La entrega de este documento no le otorga ninguna licencia sobre dichas patentes. Puede enviar las consultas sobre licencias, por escrito, a la siguiente dirección:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
Estados Unidos de América

Para consultas sobre licencias relativas a la información de doble byte (DBCS), póngase en contacto con el departamento de propiedad intelectual de IBM en su país o envíe las consultas, por escrito, a:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japón

El párrafo siguiente no se aplica en el Reino Unido ni en ningún otro país en el que tales disposiciones sean incompatibles con la legislación local: INTERNATIONAL BUSINESS MACHINES CORPORATION SUMINISTRA ESTA PUBLICACIÓN "TAL CUAL", SIN GARANTÍA DE NINGUNA CLASE, YA SEA EXPLÍCITA O IMPLÍCITA, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LAS GARANTÍAS IMPLÍCITAS DE NO VULNERACIÓN, DE COMERCIALIZACIÓN O IDONEIDAD PARA UN PROPÓSITO DETERMINADO. Algunas legislaciones no contemplan la declaración de limitación de responsabilidad, ni implícitas ni explícitas, en determinadas transacciones, por lo que cabe la posibilidad de que esta declaración no se aplique en su caso.

Esta información puede contener imprecisiones técnicas o errores tipográficos. Periódicamente, se efectúan cambios en la información incluida en este documento; estos cambios se incorporarán en nuevas ediciones de la publicación. IBM puede efectuar mejoras y/o cambios en los productos y/o programas descritos en esta publicación en cualquier momento y sin previo aviso.

Cualquier referencia hecha en esta información a sitios Web no de IBM se proporciona únicamente para su comodidad y no debe considerarse en modo alguno como promoción de dichos sitios Web. Los materiales de estos sitios web no forman parte de los materiales de IBM para este producto y el uso que se haga de estos sitios web es de la entera responsabilidad del usuario.

IBM puede utilizar o distribuir la información que usted le suministre del modo que IBM considere conveniente sin incurrir por ello en ninguna obligación para con usted.

Los licenciatarios de este programa que deseen obtener información acerca del mismo con el fin de: (i) intercambiar la información entre los programas creados independientemente y otros programas (incluido éste) y (ii) utilizar mutuamente la información que se ha intercambiado, deben ponerse en contacto con:

IBM Corporation
U59/600
3600 Steeles Ave East,
Markham, ON; L3R 9Z7
Canadá

Tal información puede estar disponible, sujeta a los términos y a las condiciones adecuadas, incluyendo en algunos casos el pago de una cuota.

IBM proporciona el programa bajo licencia descrito en este documento, así como todo el material bajo licencia disponible, según los términos del Acuerdo de Cliente de IBM, del Acuerdo Internacional de Programas bajo Licencia de IBM o de cualquier otro acuerdo equivalente entre ambas partes.

Cualesquiera datos de rendimiento contenidos aquí se han determinado en un entorno controlado. Por lo tanto, los resultados obtenidos en otros entornos operativos pueden variar significativamente. Algunas medidas pueden haberse hecho sobre sistemas que estén desarrollándose y no hay ninguna garantía de que estas medidas sean iguales en sistemas disponibles generalmente. Además, algunas medidas pueden haberse estimado por extrapolación. Los resultados reales pueden variar. Los usuarios de este documento deben verificar los datos aplicables a su entorno específico.

La información concerniente a productos no IBM se ha obtenido de los suministradores de dichos productos, de sus anuncios publicados o de otras fuentes de información pública disponibles. IBM no ha comprobado dichos productos y no puede afirmar la exactitud en cuanto a rendimiento, compatibilidad u otras características relativas a productos no IBM. Las consultas acerca de las posibilidades de los productos no IBM deben dirigirse a los suministradores de los mismos.

LICENCIA DE COPYRIGHT:

Esta información contiene programas de aplicación de ejemplo en lenguaje fuente, que ilustran las técnicas de programación en diversas plataformas operativas. Puede copiar, modificar y distribuir los programas de ejemplo de cualquier forma, sin tener que pagar a IBM, con intención de desarrollar, utilizar, comercializar o distribuir programas de aplicación que estén en conformidad con la interfaz de programación de aplicaciones (API) de la plataforma operativa para la que están escritos los programas de ejemplo. Los ejemplos no se han probado minuciosamente bajo todas las condiciones. Por lo tanto, IBM no puede garantizar ni dar por sentada la fiabilidad, la facilidad de mantenimiento ni el funcionamiento de los programas.

Cada copia o cada parte de los programas de ejemplo o de los trabajos que se deriven de ellos debe incluir un aviso de copyright como se indica a continuación:

(C) (el nombre de su empresa) (el año.) Algunas partes de este código se derivan de programas de ejemplo de IBM Corp. (C) Copyright IBM Corp. 2006. Reservados todos los derechos.

Si está viendo esta información en copia software, es posible que las fotografías y las ilustraciones en color no aparezcan.

Interfaz de programación

La información de las interfaces de programación está destinada a ayudarle a crear software de aplicaciones mediante este programa.

Las interfaces de programación de uso general le permiten escribir software de aplicaciones que obtengan los servicios de las herramientas de este programa.

Sin embargo, aquí también puede haber información de diagnóstico, modificación y ajuste. La información de diagnóstico, modificación y ajuste que se proporciona está destinada a ayudarle a depurar el software de las aplicaciones.

Aviso: no utilice la información de diagnóstico, modificación y ajuste como interfaz de programación porque está sujeta a cambios.

Marcas registradas y marcas de servicio

Los términos siguientes son marcas registradas de IBM Corporation en los Estados Unidos y/o en otros países:

Java y todas las marcas basadas en Java son marcas registradas de Sun Microsystems, Inc. en los Estados Unidos de América y/o en otros países.

Microsoft, Windows, Windows NT y el logotipo de Windows son marcas registradas de Microsoft Corporation en Estados Unidos y/o en otros países.

Intel, Intel Xeon y Pentium son marcas registradas o marcas comerciales de Intel Corporation o de sus empresas subsidiarias en Estados Unidos y/o en otros países.

UNIX es una marca registrada de The Open Group en Estados Unidos y en otros países.

Linux es una marca registrada de Linus Torvalds en Estados Unidos y/o en otros países.

Los demás nombres de compañías, productos o servicios pueden ser marcas registradas o de servicio de terceros.


(C) Copyright IBM Corporation 2000, 2006. Reservados todos los derechos.