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 La configuración actualizará el Instalador de Windows a 2.0
3.5 Error 1920 durante la instalación
3.6 Otros errores producidos durante la instalación y desinstalación
3.7 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 Datos
de clase y método duplicados tras reconectar el agente
4.9 IBM
HTTP Server 1.3.26.2 no figura en la lista del asistente de importación
4.10 No es
posible cambiar las propiedades de agente después de lanzar o conectar
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
Perfilar un applet Java
Para perfilar un applet Java creado en Eclipse:tenga en cuenta que el proceso también puede perfilarse en modalidad Habilitada. Consulta la documentación de RAC para obtener más detalles.
- 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.
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.
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.
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-0Una vez desinstalada la versión antigua, podrá instalar la nueva con el mandato:rpm -U ibmrac-5.1.0-0.i386.rpm
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.
Si el Instalador de Windows es anterior a 2.0, la configuración lo actualizará automáticamente. Esto requerirá reiniciar el sistema. La instalación de Agent Controller se reanudará automáticamente después del reinicio del sistema.
Si detecta el error 1920 del Instalador de Windows durante la instalación, indica un problema de inicio del servicio de IBM Agent Controller. Generalmente, se produce como resultado de la existencia de un archivo llamado Program en la unidad del sistema Por ejemplo si Windows está instalado en la unidad D:, la existencia de un archivo llamado Program en D:\ impedirá que se inicie el servicio de Agent Controller si éste está instalado en la ubicación por omisión D:\Program Files\IBM\IBM Agent Controller. Este es el resultado del intento de Windows de iniciar el servicio de Agent Controller como D:\Program Files\IBM\IBM Agent Controller\bin\RAServer.exe, lo cual es incorrecto.Para evitar este problema, siga estos pasos:
- Elimine o redenomine el archivo llamado Program.
- Instale Agent Controller utilizando un directorio sin espacios (por ejemplo, D:\IBM_Agent_Controller).
- En el registro de Windows, bajo el nombre de clave HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IBM Agent Controller\ImagePath, añada comillas antes y después del nombre del archivo ejecutable de Agent Controller. Por ejemplo:
"D:\Program Files\IBM\IBM Agent Controller\bin\RAServer.exe"
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:
- Cierre el entorno de trabajo.
- Termine todos los procesos java.exe que contengan el Agente de perfilado Java o el Perfilador de peticiones J2EE.
- Cierre la ventana Servicios.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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
(C) Copyright IBM Corporation 2000, 2003. Reservados todos los derechos.