J2EE 请求概要分析程序探针

简介

此样本包含用来从任何 J2EE 应用程序收集数据的 J2EE 请求概要分析程序探针。可通过遵循下面提供的指示信息将探针插入到任何 J2EE 应用程序中。有关 Hyades Probekit 的更多信息,请参阅帮助文件。有关 J2EE 请求概要分析程序的更多信息,请通过转至新建 > 示例参阅“J2EE 请求概要分析程序样本”的 readme.html 文件。

内容

JAR 文件 描述
j2rp_probe.probe 这是用来从 J2EE 应用程序收集数据的 J2EE 请求概要分析程序探针。
sdrt.jar 包含禁用了协调程序的 J2EE 请求概要分析程序。上面的探针用来完成协调程序的工作。

要求

执行此样本需要 WebSphere Application Server(V5.0 或更高版本)。
注意:
未提供此应用程序。

假设

当使用工作台连接至 J2EE 请求概要分析程序时,代理控制器已安装并且正在运行。

执行步骤

遵循下面的指示信息来将探针应用于 J2EE 应用程序并开始概要分析:

  1. 停止 WebSphere Application Server(V5.0 或更高版本)。
  2. 将 sdrt.jar 文件从此样本添加至 WebSphere Application Server 的 lib 目录,例如,x:\Program Files\WebSphere\AppServer\lib(在 Windows 上)或 /opt/WebSphere/AppServer/lib(在 UNIX 上)。
  3. 右键单击 j2rp_probe.probe > probekit > 编译
  4. 编译探针应已生成一个 java 类和一个 probescript 文件。如果选择了“自动构建”选项,则会编译 java 类并会显示一些构建路径错误。右键单击项目 > 属性 > Java 构建路径 > > 添加外部 JAR>,选择此样本附带包括的 sdrt.jar 文件的位置。可以通过右键单击此文件并选择“属性”来查看它的位置。同时添加 WebSphere 的 lib 目录中的 j2ee.jar 文件(即,<WAS_HOME>\lib\j2ee.jar)。现在应解决了构建路径错误。
  5. 构建了项目之后,在项目的 bin 目录(即,<Workbench_Home>\<Workspace>\<Project_Name>\bin)下面就生成了四个 .class 文件。这四个类文件应是 j2rp_probe_probe.class、j2rp_probe_probe$Probe_0.class、j2rp_probe_probe$Probe_1.class 和 j2rp_probe_probe$Probe_2.class。将这些类复制到 J2EE 应用程序所在的目录中。
  6. 确保 CLASSPATH 环境变量包含 probekit.jar 文件的完整路径和文件名。probekit.jar 文件位于 Eclipse 插件文件夹的 org.eclipse.hyades.probekit 子文件夹中。 确保 PATH 环境变量包含适合于您的平台的 org.eclipse.hyades.probekit 子文件夹的完整路径:
         对于 Windows:os\win32\x86
         对于 Solaris:os/solaris/sparc
         对于 Linux:os/linux/x86
    其它平台将有它们自己的子目录。
  7. 切换到 <Workbench_Home>\<Workspace>\<Project_Name>\bin 目录。
    通过使用以下命令将探针应用于 J2EE 应用程序:java ProbeInstrumenter j2rp_probe.probescript "C:\myservlet\myclass.class" 还可以通过对以上命令指定目录或 JAR 文件来将探针应用于一组类。有关以上命令的更多信息,请参阅 probekit 帮助文件。
    注意,不能将探针应用于已经检测的类。如果将探针应用于类并希望在以后将修改过的探针版本应用于同一组类,则应将所有 *.class.bak 文件重命名回 *.class,然后再应用探针。
  8. 启动 WebSphere Application Server。
  9. 在工作台的“概要分析和记录”首选项中启用概要分析:
    1. 从工具栏中选择窗口 > 首选项
    2. 选择概要分析和记录
    3. 在“概要分析和记录”窗格中,选择启用概要分析
    4. 选择确定以应用更改。
  10. 在工作台中打开“概要分析和记录”透视图:
    1. 选择窗口 > 打开透视图 > 其它
    2. 选择概要分析和记录
    3. 选择确定
  11. 连接至 J2EE 请求概要分析程序概要分析代理程序:
    1. 从工具栏中选择概要文件。将打开“启动配置”窗口。
    2. 配置列表中选择连接 - Java 进程
    3. 单击新建以创建新的配置。
    4. 在新建配置窗格中,在名称字段中指定概要文件配置的名称。
    5. 选择代理程序选项卡。
    6. 使用方向键从代理程序列表中选择 J2EE 请求概要分析程序
    7. 单击概要分析以开始对应用程序进行概要分析。
  12. 在“概要分析监视器”视图中,右键单击概要分析代理程序并选择开始监视。现在将会收集数据。
  13. 运行 J2EE 应用程序。
  14. 打开其中一个“概要分析和记录”透视图的概要分析视图以查看所收集的概要分析数据。要打开视图:
    1. 在“概要分析监视器”视图中,右键单击概要分析代理程序并选择打开方式
    2. 选择列示的其中一个视图。
    注意:有关应用程序概要分析和“概要分析”透视图的概要分析视图的更多信息可在联机文档中找到(帮助 > 帮助内容 > 搜索:> 应用程序概要分析透视图 > 执行)。
  15. 在“概要分析监视器”中,选择刷新视图按钮以刷新视图。
  16. 注意,可以用您想用的任何方法修改探针并将它重新应用于类。例如,可以通过包括 <target> 语句来将探针的目标确定为特定的类/方法,如下所示:
                         <target type='exclude' package='*' method='myMethod'/>
    强烈建议用户阅读 probekit 帮助文件来确定可如何修改探针文件以便更满足他们的需要。



(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.