© 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.
1.0 Analizador de anotaciones y rastreo
1.1 Vistas
1.1.1 Problemas con las funciones de filtrado y resaltado en la vista Anotaciones
1.2 Importar anotaciones
1.2.1 Problemas al importar archivos de anotaciones remotos
1.2.2 Importar archivos de anotaciones en Linux y AIX
1.2.3 Importar trace.log de WebSphere Application Server
1.2.4 Algunos archivos de anotaciones no pueden importarse utilizando IBM Agent Controller V5
1.2.5 Excepción de memoria insuficiente al importar grandes archivos de anotaciones y catálogos de
síntomas
1.2.6 Los Common Base Events mostrados para las anotaciones de DB2 Express Diagnostic no cumplen con la especificación
1.2.7 No se lleva a cabo ninguna validación por parte del Analizador de anotaciones y rastreo en el tipo de archivo de anotaciones que se importa
1.2.8 Limitación al importar archivos de anotaciones generados en un entorno local distinto
1.2.9 La importación de las anotaciones de actividad de WebSphere Application Server con el analizador
de reglas de AIX falla
1.2.10 No se puede crear una correlación basada en la hora con Apache Derby, versión 10.1.2.1
1.2.11 Ralentización del rendimiento al crear y mostrar una correlación para grandes registros de anotaciones
1.3 Soporte de base de datos
1.3.1 El acceso simultáneo de clientes con la misma cuenta de base de datos no está soportado
1.3.2 Conflicto de vía de acceso de recursos
1.3.3 Las preferencias de soporte de recursos grandes permanecen inhabilitadas a pesar de una selección válida
1.3.4 Mejorar el rendimiento del soporte de anotaciones grande
1.3.5 Reiniciar DB2 después de crear una base de datos y unas tablas
1.3.6 Excepción de SQL intermitente
1.3.7 La conexión de prueba devuelve un error si no ha aplicado las preferencias
1.3.8 La expresión de XPath CommonBaseEvent no está soportada cuando se analizan anotaciones grandes
1.3.9 Solo se visualiza un contextDataElement para anotaciones grandes
1.4 Otros
1.4.1 El asistente Correlación de anotaciones nueva no se visualiza correctamente en el controlador Linux GTK
1.4.2 No se respetan las modificaciones en el nivel de anotaciones de un conector después de iniciar el entorno de trabajo por primera vez
1.4.3 Anomalía al crear un ejemplo en Red Hat Linux v8.0 con la JVM de IBM
1.4.4 Solo se pueden crear bases de datos de síntomas de formato TPTP desde la barra de herramientas del Navegador de anotaciones y el menú emergente
1.4.5 El Analizador de anotaciones de IBM solo procesa mensajes con 1024 bytes como máximo
1.4.6 El editor de síntomas genera reglas de XPATH que no son válidas cuando se utilizan elementos
complejos
1.4.7 El editor de síntomas genera reglas de XPATH que no coinciden con Common Base Event de entrada
2.0 Herramienta de perfilado
2.1 Las vistas de interacción de agentes y procesos no están soportadas en la vista Diagrama de secuencia
2.2 El mandato Renovar vistas del Navegador de perfilado no funciona para Interacciones de rastreo
2.3 La creación de perfiles en Windows mediante Sun JDK 1.4.x puede terminar con un informe de error de Microsoft(R)
En la vista Anotaciones, las funciones de filtrado y resaltado no funcionan sobre elementos complejos de Common Base Event (por ejemplo, sourceComponentId). Se proporcionará un arreglo en el paquete de arreglos siguiente.
Al importar un archivo de anotaciones remoto (Archivo > Importar... > Archivo de anotaciones), no se visualizan entradas de anotaciones en la vista Anotaciones después de renovar las vistas del Supervisor de perfilado (Perfilar > Renovar vistas) o se visualiza un diálogo Mensaje de anotación en el que se afirma que el cliente local no empezado la supervisión del analizador de anotaciones remoto tras esperar 30 segundos.
Este problema es debido a el estado latente de la red y puede arreglarse aumentando el tiempo durante el que Agent Controller espera al cliente local para empezar a supervisar el analizador de anotaciones remoto. Para solucionar este problema, intente lo siguiente:
<Application configuration="default" executable="RemoteLogParserLoader" extends="default" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%"> ... <Parameter position="prepend" value="-Dorg.eclipse.hyades.logging.parsers.maxWaitTimeInMillis=xxxxx"/> ... </Application>donde xxxxx es tiempo de espera máximo en milisegundos (es decir, mayor que 30000).
Algunas importaciones del archivo de anotaciones no funcionan en absoluto en las plataformas Linux(R) y AIX(R).
Esto ocurre cuando el usuario no tiene los permisos adecuados para acceder a los archivos de anotaciones. Para resolver este tema, los archivos de anotaciones, deben copiarse en el directorio inicial del usuario e importarse desde ahí.
1.2.3 Importar trace.log de WebSphere Application ServerSe crea una correlación interna cuando se importa un archivo WebSphere(R) Application Server trace.log.
El usuario no debe suprimir estas correlaciones ya que contienen información relacionada con la estructura interna del agente correspondiente.
1.2.4 Algunos archivos de anotaciones no pueden importarse utilizando IBM Agent Controller V5Los archivos de anotaciones remotos que no sean activity.log no pueden importarse utilizando IBM(R) Agent Controller V5. Al importar remotamente los archivos de anotaciones, IBM Agent Controller en el sistema remoto debe estar al mismo nivel o a un nivel superior que el Analizador de anotaciones y rastreo de IBM para Eclipse.
Para solucionar este limitación, instale el IBM Agent Controller proporcionado con el Analizador de anotaciones y rastreo de IBM para Eclipse en el sistema remoto.
1.2.5 Excepción de memoria insuficiente al importar grandes archivos de anotaciones y catálogos de síntomasPuede importar archivos de anotaciones y catálogos de síntomas hasta 25 MB en el área de trabajo y abrirlos en el Analizador de anotaciones y rastreo.
El tiempo necesario para abrir el archivo de anotaciones depende del número de registros de anotaciones en el archivo y puede obtener una excepción de "memoria insuficiente". Para solucionar este problema, utilice la característica de soporte de anotaciones grandes.
Si obtiene una excepción de "memoria insuficiente" al importar grandes catálogos de síntomas, aumente el tamaño del almacenamiento dinámico añadiendo el vmargs siguiente:
-vmargs -Xmx1000m
Si el problema de la excepción de "memoria insuficiente" al importan anotaciones grandes, no se arregla utilizando la característica de soporte de anotaciones grandes, el aumento del tamaño del almacenamiento dinámico debería ayudar.
Si importa un registro de anotaciones de IBM DB2(R) Express Diagnostic, los Common Base Events mostrados en el Analizador de anotaciones y rastreo rompen con 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 importación. No habrá ninguna solución para este problema hasta que se arregle db2diag.exe.
No se lleva a cabo ninguna validación por parte del Analizador de anotaciones y rastreo en el tipo de archivo de anotaciones que se importa. Al importar un archivo de anotaciones asegúrese de elegir el tipo y la versión de anotaciones correcta para el archivo de anotaciones que se está importando. Si se produce un problema durante la importación, no se muestran registros en la vista Anotaciones o los registros mostrados no son correctos y se visualizará un mensaje de error. Para obtener información más detallada acerca del error, consulte los detalles del diálogo de error.
Al importar archivos de anotaciones que contienen indicaciones de la hora en un entorno local distinto a aquel en el que se está ejecutando el Analizador de anotaciones y rastreo, el analizador archivos de anotaciones basado en reglas a veces no analiza la indicación de la hora ni otros datos de registros de anotaciones correctamente. Por ejemplo, al importar un archivo de anotaciones de acceso a IBM HTTP Server en inglés en el Analizador de anotaciones y rastreo que se está ejecutando en un sistema en japonés, los valores de creationTime de Common Base Events resultante tendrán un valor cero y el campo msg de Common Base Event estará en blanco.
Para solucionar este problema, al importar archivos de anotaciones que contengan indicaciones de la hora en otro entorno local que no sea el entorno local del sistema actual, especifique el entorno local del archivo de anotaciones en la pestaña Detalles del asistente Importar anotaciones si es que existe un campo de entorno local.
La importación de las anotaciones de actividad binarias de WAS con el analizador de reglas de un sistema AIX falla y se muestra el error siguiente en el diálogo de error:
IWAT0030E Se ha producido un error durante la ejecución del analizador de anotaciones remoto "com.ibm.etools.logging.adapter.config.StaticParserExtension": IWAT0412E Se han producido errores al analizar el archivo de anotaciones /home/tfoun/logs/activity.log. java.lang.Exception: IWAT0239E El mandato conversor ha fallado: java.lang.Exception: IWAT0238E El proceso conversor ha finalizado con el valor de salida 1
El mandato conversor para convertir el archivo de anotaciones binario en texto de forma que pueda analizarse falla en AIX. Para solucionar este problema, utilice el analizador estático para importar el archivo de anotaciones de actividad binario o convierta éste último a texto utilizando el programa de utilidad showlog de WAS e importe el archivo de texto resultante en el Analizador de anotaciones y rastreo. El programa de utilidad showlog de WAS se encuentra en el directorio bin del directorio de instalación de WAS. Por ejemplo, utilice el mandato siguiente para convertir el archivo de anotaciones binario en un archivo de texto llamado activity.txt:
/opt/WebSphere/AppServer/bin/showlog activity.log activity.txt
A continuación, importe activity.txt en el Analizador de anotaciones y rastreo.
Aunque no está oficialmente soportado por TPTP, un usuario de TPTP intentó utilizar Derby 10.1.2.1 conjuntamente con un soporte de anotaciones grandes y experimentó este problema. Al intentar crear una correlación basada en la hora con unas anotaciones grandes, se produjo una excepción ArrayIndexOutOfBoundsException que originó la ejecución continua de la correlación sin detención. Esto es una problema conocido de Derby que está arreglado en la versión 10.2.0.0 de Derby. Para obtener más información, consulte la descripción del problema de Derby en el sitio http://www.archivum.info/derby-dev@db.apache.org/2006-03/msg01624.html.
Tenga en cuenta que esta excepción se produce en el lado del servidor y que no se ve en el entorno de trabajo del usuario. Se muestra en la ventana de mandatos en la que se emite el mandato para iniciar el servidor Derby.
Al crear o mostrar una correlación para un registro de anotaciones grande, el rendimiento puede ralentizarse con Apache Derby y DB2.
Para mejorar el rendimiento al crear una correlación, importe las anotaciones con un filtro de importación de modo que los eventos innecesarios o no relacionados no se incluyan en la base de datos. La utilización de un filtro "Mostrar solo eventos correlacionados" puede mejorar el rendimiento al abrir la correlación en la vista Interacciones de anotación.
El acceso simultáneo de clientes a una base de datos puede bloquear algunas tablas. Para desbloquear las tablas, reinicie el Entorno de trabajo y el servidor de base de datos.
Si utiliza la misma base de datos y la misma cuenta de base de datos para varios espacios de trabajo, pueden producirse conflictos de vía de acceso de recursos y los recursos no persistirán en la base de datos.
Para solucionar este problema, utilice diferentes nombres de proyecto y supervisor en cada espacio de trabajo para evitar conflictos de vía de acceso
En Linux/GTK, en la página de preferencias Soporte de recursos grandes, los campos de los valores de la base de datos permanecerán inhabilitados aunque se haya seleccionado un tipo de base de datos válido.
Para solucionar este problema, seleccione DB2 como el tipo de base de datos y aplique los valores. Cierre y vuelva a abrir el diálogo de preferencias; se habilitarán los campos.
Para mejorar el rendimiento del soporte de anotaciones grande, ejecute el mandato siguiente después de importar anotaciones grandes:
db2 -tvf plugins/com.ibm.etools.ac.resources.database_x_x_x /scripts/runStatsForAllHyadesTablesDB2-8.1.sqldonde x_x_x es el número de versión del directorio del plug-in.
Después de ejecutar el script de creación de base de datos y tablas, CreateDatabaseAndTablesDB2-8.1.sql, debe reiniciar DB2. Desde un indicador de mandatos de DB2, ejecute db2stop y después db2start para aplicar los cambios en los parámetros de configuración hechos por el script.
También puede producirse la excepción SQL siguiente:
com.ibm.db2.jcc.b.SQLException: NULLID.SYSSH203 0X5359534C564C3031
Cuando se produzca este problema, reinicie el entorno de trabajo y la base de datos si está utilizando DB2 o CloudscapeTM en modalidad de red. Las anotaciones importadas cuando se produce esta excepción no son válidas y deben volver a importarse.
En la página Soporte de anotaciones grandes de la sección Registro de anotaciones del diálogo Preferencias, si pulsa Probar conexión antes de haber aplicado cambios a los valores, obtendrá un error de conexión. Para evitarlo, pulse Aplicar después de cambiar los valores necesarios y después pulse Probar conexión.
La expresión de XPath siguiente no está soportada por IBM Log Analyzer cuando se analizan anotaciones grandes.
<expression:xpathExpression>/CommonBaseEvent</expression:xpathExpression>
Si DB2 se utiliza para el soporte de anotaciones grandes, solo se muestra un contextDataElement para un evento en la vista Anotaciones, incluso aunque haya varios para ese evento contextDataElements.
En el asistente Correlación de anotaciones nueva, solo se muestra la lista Anotaciones disponibles y la lista está vacía. Esto es debido al hecho de que solo se visualiza la parte izquierda de la página del asistente.
Para solucionar este problema, intente redimensionar la página del asistente para que se muestre la lista Anotaciones seleccionadas y los botones de acciones. Una solución alternativa consiste en seleccionar los archivos de anotaciones para la correlación en la vista Navegador de anotaciones antes de pulsar el botón Correlación de anotaciones nueva.
Si modifica el nivel de anotaciones de un conector en el archivo plugin.xml (a través de los puntos de ampliación com.ibm.etools.common.logging.commonLoggingOptions o com.ibm.etools.logging.util.loggingOptions) después del primer inicio de un entorno de trabajo, el cambio no se respeta en los lanzamientos subsiguientes del entorno de trabajo. El nivel de anotaciones especificado en el archivo plugin.xml del conector queda en la menoria caché del tiempo de ejecución de Eclipse la primera vez que se inicia el entorno de trabajo. Los inicios subsiguientes del entorno de trabajo utilizan el valor en memoria caché del nivel de anotaciones del conector a pesar de la modificación del archivo plugin.xml.
Para solucionar este problema, reinicie el entorno de trabajo con el argumento de línea de mandatos -clean. Esta opción limpiará la memoria caché utilizada para almacenar los datos de resolución de dependencias de paquete compuesto y los datos de registro de ampliación de Eclipse y forzará a Eclipse a reinicializar estas memorias caché. Añada la opción después de eclipse.exe en <directorio de instalación del entorno de trabajo>\eclipse\ac.bat (Windows(R)) o <directorio de instalación del entorno de trabajo>/eclipse/ac.sh (Linux). También puede modificar el nivel de anotaciones del conector en la página de preferencias de anotación (Ventana > Preferencias > Anotación) y reiniciar el entorno de trabajo.
Al crear un ejemplo en el Analizador de anotaciones y rastreo utilizando el asistente Creación de ejemplo (Nuevo > Ejemplo), el Entorno de trabajo sufre una anomalía. Esto sucede cuando el asistente Creación de ejemplos intenta abrir el archivo readme.html como parte de los pasos de creación. Este problema se ha encontrado en Red Hat Linux v8.0 con la máquina virtual JavaTM (JVM) de IBM y es un problema de SWT ( https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515).
Para solucionar este problema, intente añadir -Xj9 como argumento de JVM en ac.sh para lanzar utilizando la JVM J9 de IBM. (Por ejemplo, ./eclipse -vmargs -Xj9 -Xmx500m). Para obtener más información acerca de cómo ejecutar SWT en Red Hat Linux v8.0, consulte la página Web SWT FAQ(http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html).
Nota: tal como se indica en la tabla de plataformas de referencia de Eclipse Eclipse reference platforms (http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_0.html#TargetOperatingEnvironments), solo están soportados los sistemas Linux siguientes: versión 2.2.1 del kit de herramientas de widget GTK+ y bibliotecas asociadas (GLib, Pango); el visor SWT HTML necesita Mozilla 1.4GTK2. Para Motif en otros sistemas Linux: Open Motif 2.1 (incluido); el visor SWT HTML necesita Mozilla 1.4GTK2.
Debido a una limitación de TPTP los usuarios no pueden crear ambos tipos de bases de datos de síntomas desde el botón de la barra de herramientas del navegador y el menú de contexto. Una solución consiste en seleccionar Archivo > Nuevo > Otro > Perfilado y anotación en el menú del entorno de trabajo y elegir el tipo de base de datos de síntomas que desea crear.
En las reglas de XPATH y las reglas de correlación de IBM, la serie de la propiedad msg de Common Base Event no debe tener más de 1024 bytes. Si la serie tiene más de 1024 bytes, el analizador de anotaciones de IBM no podrá procesarlos todos.
Al utilizar elementos complejos de Common Base Event (por ejemplo, sourceComponentID), el editor de síntomas genera reglas de XPATH que no son válidas. Se proporcionará un arreglo en el paquete de arreglos siguiente.
Si alguno de los ExtendedDataElements está seleccionado al crear una expresión XPATH nueva, el catálogo de síntomas
resultante contiene extendedDataElement
en lugar de extendedDataElements
.
Como resultado, el editor de síntomas genera reglas XPATH que no coinciden con ningún Common Base Event de entrada.
La vista Interacciones de agente y la vista Interacciones de proceso no están soportadas en la vista Diagrama de secuencia para archivos de anotaciones.
Actualmente no hay ninguna solución para este problema.
2.2 El mandato Renovar vistas del Navegador de perfilado no funciona para Interacciones de rastreoEl mandato Renovar vistas del Navegador de perfilado no funciona para Interacciones de rastreo, Sin embargo, las interacciones de rastreo se renuevan automáticamente a intervalos regulares.
Una solución consiste en seleccionar otro nodo en el árbol de perfilado y volver a seleccionar el nodo anterior.
2.3 La creación de perfiles en Windows mediante Sun JDK 1.4.x puede terminar con un informe de error de MicrosoftDefecto de Bugzilla: 103058
El perfilado de la aplicación finaliza con el mensaje "java.exe ha encontrado un problema y debe cerrarse. Disculpen las molestias.". El mensaje contiene información y opciones para someter un informe de error a Microsoft. Consulte bugzilla 103058 para obtener una captura de pantalla del mensaje.
Este problema se ha observado en varias modalidades: Análisis de tiempo (con o sin ";Mostrar instancias"), Análisis de memoria y en combinaciones de estas modalidades. Puede solucionar el problema volviendo a ejecutar el perfilado de la aplicación con JIT desactivado, es decir proporcionando "-Djava.compiler=NONE" como argumento de JVM. El problema se ha producido con SUN JDK 1.4.2_08-b03 para Windows.