Sondas del Perfilador de peticiones J2EE

Introducción

Este ejemplo contiene la Sonda del Perfilador de peticiones J2EE utilizada para recoger datos de las aplicaciones J2EE. La sonda puede inyectarse en cualquier aplicación J2EE siguiendo las instrucciones que se indican más adelante. Para obtener más información acerca de el Kit de sondas de Hyades, consulte los archivos de ayuda. Para obtener más información acerca del Perfilador de peticiones J2EE, consulte en el archivo readme.html el 'Ejemplo del Perfilador de peticiones J2EE' seleccionando Nuevo > Ejemplo.

Contenido

Archivo JAR Descripción
j2rp_probe.probe Esta es la Sonda del Perfilador de peticiones J2EE utilizada para recoger datos de las aplicaciones J2EE.
sdrt.jar Contiene el Perfilador de peticiones J2EE con las colaboradores inhabilitados. La Sonda anterior se utiliza para realizar el trabajo de los colaboradores.

Requisitos

Es necesario WebSphere Application Server (versión 5.0 o posterior) para ejecutar este ejemplo.
Nota:
esta aplicación no se suministra.

Suposiciones

Al conectarse a un Perfilador de peticiones J2EE mediante el entorno de trabajo, el controlador de agentes debe estar instalado y en ejecución.

Pasos de ejecución

Siga las instrucciones que se indica a continuación para aplicar la sonda a una aplicación J2EE e iniciar el perfilado:

  1. Detenga WebSphere Application Server (versión 5.0 o posterior).
  2. Añada el archivo sdrt.jar de este ejemplo al directorio lib de WebSphere Application Server, por ejemplo, x:\Program Files\WebSphere\AppServer\lib en Windows o /opt/WebSphere/AppServer/lib en UNIX.
  3. Pulse con el botón derecho del ratón j2rp_probe.probe > Kit de sondas > Compilar
  4. La compilación de la sonda debe haber generado una clase Java y un archivo de script de sonda. Si selecciona la opción 'Construir automáticamente', la clase Java se compilará y se visualizarán algunos errores de vía de acceso de construcción. Pulse el proyecto con el botón derecho del ratón y pulse > Propiedades > Vía de acceso de construcción Java > Bibliotecas > Añadir archivos JAR externos > Seleccione la ubicación del archivo sdrt.jar incluido en este ejemplo. Puede visualizar la ubicación de este archivo pulsando sobre él con el botón derecho del ratón y seleccionando Propiedades. Añada también el archivo j2ee.jar del directorio lib de WebSphere (es decir, <INICIO_WAS>\lib\j2ee.jar). Los errores de vía de acceso de construcción deberían haberse resuelto.
  5. Al construir el proyecto, se generan cuatro archivos .class bajo el directorio bin del proyecto (es decir, <Inicio_entorno_trabajo>\<Workspace>\<Nombre_proyecto>\bin). Estos cuatro archivos de clase deben ser j2rp_probe_probe.class, j2rp_probe_probe$Probe_0.class, j2rp_probe_probe$Probe_1.class y j2rp_probe_probe$Probe_2.class. Copie estas clases en el mismo directorio que la aplicación J2EE.
  6. Asegúrese de que la variable de entorno CLASSPATH contiene la vía de acceso completa y el nombre de archivo del archivo probekit.jar. El archivo probekit.jar se encuentra en la subcarpeta org.eclipse.hyades.probekit de la carpeta de conectores de Eclipse. Asegúrese de que la variable de entorno CLASSPATH contiene la vía de acceso completa a una subcarpeta de org.eclipse.hyades.probekit adecuada a la plataforma.
         os\win32\x86 para Windows
         os/solaris/sparc para Solaris
         os/linux/x86 para Linux
    Otras plataformas tienen sus propios subdirectorios.
  7. Vaya al directorio <Inicio_entorno_trabajo>\<Workspace>\<Nombre_proyecto>\bin.
    Aplique la sonda a la aplicación J2EE mediante el siguiente mandato: java ProbeInstrumenter j2rp_probe.probescript "C:\miservlet\miclase.class". También puede aplicar la sonda a un grupo de clases especificando un directorio o un archivo JAR para el mandato anterior. Consulte el archivo de ayuda del Kit de sondas para obtener más información acerca del mandato anterior.
    Tenga en cuenta que no puede aplicar las sondas a clases que ya se hayan instrumentado. Si aplica las sondas a las clases y desea aplicar una versión modificada de la sonda posteriormente en el mismo conjunto de clases, debe cambiar el nombre de todos los archivos *.class.bak por *.class antes de aplicar las sondas.
  8. Inicie WebSphere Application Server.
  9. Habilite el perfilado en las preferencias de perfilado y anotación del entorno de trabajo:
    1. En la barra de herramientas, seleccione Ventana > Preferencias.
    2. Seleccione Perfilado y anotación.
    3. En el panel Perfilado y anotación, seleccione Habilitar perfilado.
    4. Seleccione Aceptar para aplicar los cambios.
  10. Abra la perspectiva Perfilado y anotación en el entorno de trabajo:
    1. Seleccione Ventana > Abrir perspectiva > Otras.
    2. Seleccione Perfilado y anotación.
    3. Seleccione Aceptar.
  11. Conéctese al agente de perfilado del Perfilador de peticiones J2EE:
    1. Seleccione Perfilar en la barra de herramientas. Se abrirá la ventana de configuraciones de lanzamiento.
    2. Seleccione Conectar - Proceso Java en la lista Configuraciones.
    3. Pulse Nueva para crear una configuración.
    4. En el panel de configuración nueva, especifique un nombre para la configuración de perfil en el campo Nombre.
    5. Seleccione la pestaña Agentes.
    6. Seleccione el Perfilador de peticiones J2EE en la lista Agentes mediante las teclas de flecha.
    7. Pulse Perfilar para empezar a perfilar la aplicación.
  12. En la vista Supervisor de perfilado, pulse el agente de perfilado con el botón derecho del ratón y seleccione Iniciar supervisión. Ahora, se recogerán datos.
  13. Ejecute la aplicación J2EE.
  14. Abra una de las vistas de perfilado de la perspectiva Perfilado y anotación para ver los datos de perfilado recogidos. Para abrir una vista:
    1. En la vista Supervisor de perfilado, pulse el agente de perfilado con el botón derecho del ratón y seleccione Abrir con.
    2. Seleccione una de las vistas de la lista.
    Nota: puede encontrar más información sobre el perfilado de aplicaciones y las vistas de perfilado de la perspectiva Perfilado en la documentación en línea (Ayuda > Contenido de la ayuda > Buscar: > 'Perspectiva Perfilado de aplicaciones' > IR).
  15. En el Supervisor de perfilado, pulse el botón Renovar vista para renovar las vistas.
  16. Tenga en cuenta que puede modificar las sondas de cualquier modo que desee y reaplicarlas a las clases. Por ejemplo, puede destinar las sondas a clases y métodos específicos incluyendo sentencias <target> como la siguiente:
                         <target type='exclude' package='*' method='miMétodo'/>
    Es muy aconsejable leer los archivos de ayuda del kit de sondas para determinar cómo pueden modificarse los archivos de sonda para que se ajusten a las necesidades del usuario.



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