Herramientas de perfilado y anotaciones: notas de release

1.0 Introducción
2.0 Software soportado y especificaciones
3.0 Limitaciones
   3.1 Característica de seguridad no disponible
   3.2 Actualizar Agent Controller en Linux
   3.3 Es posible que Agent Controller no se inicie en AIX
   3.4 Otros errores producidos durante la instalación y desinstalación
   3.5 Error de falta de memoria
4.0 Problemas conocidos
   4.1 Abrir y ver los archivos de rastreo
   4.2 Importar archivos de anotaciones
   4.3 Visualizar archivos más grandes en la vista Interacciones de anotaciones
   4.4 Ocultar llamadas autorreferenciadas ignoradas por las vistas Interacciones de anotaciones
   4.5 Soporte para las vistas Interacciones de agente e Interacciones de proceso
   4.6 Importar archivos de anotaciones desde Solaris
   4.7 No es posible importar un archivo de anotaciones que contiene caracteres no ASCII
   4.8 No es posible perfilar WebSphere Application Server 5.0.2 autónomo
   4.9 Datos de clase y método duplicados tras reconectar el agente
   4.10 IBM HTTP Server 1.3.26.2 no aparece en el asistente Importar
   4.11 No es posible cambiar las propiedades de agente después de lanzar o conectar

1.0 Introducción

Esta nota de release describe las herramientas de análisis y perfilado de memoria y rendimiento disponibles desde la perspectiva Perfilado y Anotación del entorno de trabajo (incluidas las vistas de anotaciones).

Fuentes adicionales de documentación


Guía para utilizar los ejemplos
Desde el Analizador de anotaciones y rastreo, invoque Archivo > Nuevo > Ejemplo... y seleccione la vista en árbol Ejemplo de analizador de anotaciones y correlación. Seleccione la opción de menú Apache Log Correlation/Analyzer Samples y pulse el botón Siguiente. A continuación, pulse el botón Finalizar. El ejemplo se creará automáticamente.


Guía para crear analizadores, motores de correlación y motores de análisis
Estas guías están disponibles en http://dev.eclipse.org/viewcvs/indextools.cgi/~checkout~/hyades-home/docs/doc.html

2.0 Software soportado y especificaciones

Perfilar un applet Java
Para perfilar un applet Java creado en Eclipse:

1. Utilice el menú Ejecutar para seleccionar Ejecutar...
2. Seleccione Applet Java y pulse Nuevo.
3. Seleccione la pestaña Argumentos.
4. Especifique lo siguiente en Argumentos de VM: -XrunpiAgent:server=controlled
5. Pulse Ejecutar. Tenga en cuenta que la aplicación no se ejecutará hasta que se conecte al proceso.
6. Pase a la perspectiva Perfilado y anotación.
7. Utilice el menú Perfilar para seleccionar Conectar->Proceso Java.
8. Utilice el asistente para conectarse al proceso.
9. Empiece a supervisar el Agente. En este punto debe ejecutarse la aplicación.
tenga en cuenta que el proceso también puede perfilarse en modalidad Habilitada. Consulta la documentación de RAC para obtener más detalles.

El archivo readme Trabajar con el ejemplo de anotación común de Hyades Apache no especifica el nombre correcto del agente de anotación en el paso 3 del apartado dedicado a los pasos de ejecución. El nombre correcto del agente de anotación es org.eclipse.hyades.logging.commons.sample.HyadesLoggingCommonsSample.

3.0 Limitaciones

3.1 Característica de seguridad no disponible

La característica de seguridad de IBM Agent Controller no está disponible. Cuando se le solicite que habilite o active la seguridad durante la instalación, seleccione Inhabilitar o no.

3.2 Actualizar Agent Controller en Linux

Si actualiza Agent Controller en Linux desde la versión 5.0.1 o anterior, primero debe desinstalar esa versión con un mandato como:

rpm -e ibmrac-5.0.1-0
Una vez desinstalada la versión antigua, podrá instalar la nueva con el mandato:
rpm -U ibmrac-5.1.0-0.i386.rpm

3.3 Es posible que Agent Controller no se inicie en AIX

Puede que Agent Controller no se inicie en AIX e indique el siguiente mensaje:

RAServer no ha podido iniciarse.
Esto se produce generalmente si otro proceso ejecutado en el sistema está utilizando el puerto TCP/IP 10002 o si Agent Controller acaba de detenerse.

Solución: Si otro proceso está utilizando el puerto 10002, puede cambiar el número de puerto editando el archivo serviceconfig.xml. Esta operación se describe en la documentación.

3.4 Otros errores producidos durante la instalación y desinstalación

Si detecta errores durante la instalación o desinstalación, pueden ser debidos a al hecho de que los archivos de objetos de Agent Controller se carguen mediante procesos en ejecución. Para asegurarse de que los archivos de objetos puedan modificarse, haga lo siguiente:

  1. Cierre el entorno de trabajo.
  2. Termine todos los procesos java.exe que contengan el Agente de perfilado Java o el Perfilador de peticiones J2EE.
  3. Cierre la ventana Servicios.

3.5 Error de falta de memoria

A veces, el entorno de trabajo puede quedarse sin memoria al tratar con grandes cantidades de datos. Esto ocurrirá en momentos diferentes, dependiendo del JRE utilizado. Por ejemplo, en algunas situaciones, SUN 1.4.1 se quedará sin memoria antes que IBM 1.3.1 o IBM 1.4.1.

Solución: Utilice el argumento JVM -Xmx para aumentar la asignación de almacenamiento dinámico. Aunque es aconsejable -Xmx200M, pueden ser necesarias cantidades mayores en función de la configuración de la máquina y las necesidades de las aplicaciones.

4.0 Problemas conocidos

4.1 Abrir y ver los archivos de rastreo

Los archivos de rastreo de WebSphere Application Server generados mediante el formato de salida de rastreo del Analizador de anotaciones no pueden abrirse y verse con las herramientas de anotación.

Solución: Establezca el formato de salida de rastreo de WebSphere Application Server en Básico o Avanzado antes de generar los archivos de rastreo que deben abrirse y verse con las herramientas de anotación.

4.2 Importar archivos de anotaciones

Pueden importarse archivos de anotaciones de 25MB como máximo en el área de trabajo y abrirse en el analizador de anotaciones y rastreo. El tiempo necesario para abrir el archivo de anotaciones depende del número de registros de anotaciones del archivo, y puede que reciba una excepción de falta de memoria.

Solución: Aumente la memoria iniciando Eclipse de la siguiente forma:

"eclipse.exe -vmargs -Xmx800M" o añada más memoria física a la máquina.

4.3 Visualizar archivos más grandes en la vista Interacciones de anotaciones

Al visualizar archivos grandes en la vista Interacciones de anotación, la vista general Diagrama de secuencia no muestra ningún archivo de anotaciones. El botón Visión general se mueve de la parte inferior a la parte superior de la vista, pero la vista en sí no presenta anchura.

Solución: Ninguna.

4.4 Ocultar llamadas autorreferenciadas ignoradas por las vistas Interacciones de anotaciones

La opción de ocultar llamadas autorreferenciadas que está presente en la página de preferencias de las vistas Diagrama de secuencia (Ventana > Preferencias > Perfilado y anotación > Diagrama de secuencia) se pasa por alto en las vistas Interacciones de anotación.

Solución: Ninguna.

4.5 Soporte para las vistas Interacciones de agente e Interacciones de proceso

Las vistas Interacciones de agente e Interacciones de proceso no están soportadas en la vista Diagrama de secuencia para archivos de anotaciones.

Solución: Ninguna.

4.6 Importar archivos de anotaciones desde Solaris

No pueden importarse adecuadamente archivos de anotaciones desde Solaris.

Solución: Ninguna. El controlador de Solaris no es estable, y se suministrará una actualización en un futuro próximo.

4.7 No es posible importar un archivo de anotaciones que contiene caracteres no ASCII

Si un archivo de anotaciones contiene caracteres no ASCII (por ejemplo, 0xFF 0xFB ... ), no se importará adecuadamente.

Solución: Elimine estos caracteres no ASCII del archivo de anotaciones.

4.8 No es posible perfilar WebSphere Application Server 5.0.2 autónomo

El perfilado de WebSphere Application Server versión 5.0.2 colgará o provocará una anomalía en el servidor a menos que utilice el servidor de aplicaciones incorporado a este producto.

Solución: Si desea perfilar instancias de WebSphere Application Server versión 5.0.2 que no forman parte de este producto, deberá ponerse en contacto con el Soporte de WebSphere para adquirir un arreglo. Puede encontrar más información aquí.

4.9 Datos de clase y método duplicados tras reconectar el agente

La acción de reconectar con el mismo agente bajo el mismo proyecto y destino de supervisor hará que se informe de clases y métodos duplicados.

Resulta útil desconectarse del agente si piensa que otro recurso se conectará al agente.

Manera de evitar el problema: seleccione Pausa de supervisión para dejar de recoger datos de perfilado y, posteriormente, seleccione otra vez Iniciar supervisión para reanudar el perfilado.

4.10 IBM HTTP Server 1.3.26.2 no figura en la lista del asistente de importación

IBM HTTP Server versión 1.3.26.2 no figura en la lista del asistente de importación como formato de anotación soportado. Este servidor se utiliza en WebSphere Application Server versión 5.0.2. Puede importar satisfactoriamente los archivos de anotaciones de IBM HTTP Server 1.3.26.2 utilizando la versión 1.3.26.1.

4.11 No es posible cambiar las propiedades de agente después de lanzar o conectar

Una vez creado un agente mediante lanzamiento o conexión, no pueden aplicarse cambios a las propiedades del agente (por ejemplo, opciones o filtros).

Solución: Desconecte el agente y vuelva a conectarlo a un supervisor diferente con las nuevas opciones y filtros.

Volver al archivo readme principal