对 JPA 启用增强跟踪

在某些情况下,随 WebSphere® Application Server 提供的 Java™ 持久性 API (JPA) 提供程序所生成的跟踪信息可能并不足以诊断问题。在这些情况下,可启用扩展跟踪机制在跟踪文件中生成更多信息。扩展跟踪仅对随 IBM 提供的持久性提供程序有效。它无法与第三方提供程序(包括捆绑在应用程序中的或配置为共享库的各个 OpenJPA 备用版本)一起使用。

关于此任务

注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM® i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.logSystemErr.logtrace.logactivity.log 文件。您还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用 HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。

通过使用 wsadmin 脚本编制或管理控制台,只需执行几个简单步骤即可启用对 WebSphere Application Server 上运行的应用程序进行的增强 JPA 跟踪。本主题中的步骤描述如何使用管理控制台来配置增强跟踪。此过程将更改服务器设置,因此较好的做法是先备份服务器设置,然后再继续操作。

过程

  1. 启用跟踪代理程序。 必须通过向服务器 Java 虚拟机 (JVM) 传递自变量对每个应用程序服务器启用一个跟踪代理程序。可通过管理控制台执行以下步骤来启用跟踪代理程序:
    1. 在导航窗格中,选择服务器。选择应用程序服务器
    2. 在服务器列表窗格中,选择需要执行增强 JPA 跟踪的服务器。如果多个服务器均向您的应用程序提供 JPA 功能,那么必须对每个服务器执行这些步骤。
    3. 在“服务器基础结构”标题下,选择 Java 和进程管理。选择进程定义
    4. 在“其他属性”标题下,选择 Java 虚拟机
    5. 在“通用 JVM 自变量”字段添加以下自变量,其中 <app_server_root> 是应用程序服务器安装目录的标准路径。 确保使用适合于您的操作系统的路径分隔符。
      -javaagent:<app_server_root>/optionalLibraries/IBM/wsjpa/wsjpatrace.jar
      要点: 在管理控制台中使用的通用 JVM 自变量当前不支持带空格的自变量。如果在此字段中指定了空格,那么服务器可能无法启动。在 Windows 环境中更可能发生此问题,这是因为缺省安装路径是 C:\Program Files\IBM\WebSphere\AppServer,此路径包含空格。要在 Windows 环境中解决此问题,请使用缩写路径名作为 <app_server_root>。例如,C:\Progra~1\IBM\WebSphere|AppServer。在 UNIX 类型的系统上,可使用符号链接来清除 <app_server_root> 中的空格。例如,如果 WebSphere Application Server 安装路径是 /opt/app_server_root/AppServer,那么可以在 /opt 中创建一个从 <app_server_root> 到 AppServerRoot 的符号链接,以消除空格。然后,在通用 JVM 自变量中指定 /opt/AppServerRoot/AppServer 作为 <app_server_root>
  2. 启用其他跟踪组件并调整跟踪文件选项。 可使用 wsadmin 脚本编制或管理控制台来完成此步骤。这些步骤描述如何使用管理控制台来调整跟踪文件设置以及启用组件:
    1. 在导航窗格中,选择故障诊断。单击日志和跟踪
    2. 选择要跟踪的服务器的名称。
    3. 常规属性下,选择诊断跟踪
    4. 确保选中启用日志,并根据情况增大最大文件大小最大历史文件数。根据其他跟踪类别的数目以及所选跟踪级别的不同,跟踪文件可能会变得非常大。
    5. 在“其他属性”标题下,选择更改日志详细信息级别
    6. 通过指定下表中的一个或多个跟踪类别来启用各种扩展跟踪类别。示例跟踪字符串是:*=info:JPA=all:openjpa.*=finer:openjpa.kernel=finest。扩展跟踪将在 FINER 或 FINEST 跟踪级别进行跟踪。FINEST 级别的详细程度高于 FINER。如果指定了 ALL,那么扩展跟踪将在 FINEST 级别进行跟踪。
      表 1. 跟踪类别. 在启用增强的跟踪之前,请先备份服务器配置。
      类别 相关跟踪级别 描述
      JPA OFF、ALL、FINER、FINEST 将扩展跟踪添加至 JPA 跟踪组。
      openjpa.* OFF、ALL、FINER、FINEST 常规 OpenJPA 跟踪以及对 OpenJPA 中的所有类别进行扩展跟踪(如果启用了扩展跟踪)。
      openjpa.xtrace.* OFF、ALL、FINER、FINEST 对 OpenJPA 中的所有类别进行扩展跟踪(如果启用了扩展跟踪)。
      openjpa.xtrace.Jdbc OFF、ALL、FINER、FINEST 对 OpenJPA JDBC 类进行扩展跟踪(如果启用了扩展跟踪)。
      openjpa.xtrace.Lib OFF、ALL、FINER、FINEST 对 OpenJPA 库类进行扩展跟踪(如果启用了扩展跟踪)。
      openjpa.xtrace.Persist OFF、ALL、FINER、FINEST 对 OpenJPA 持久性类进行扩展跟踪(如果启用了扩展跟踪)。
      openjpa.xtrace.Kernel OFF、ALL、FINER、FINEST 对 OpenJPA 内核类进行扩展跟踪(如果启用了扩展跟踪)。
      openjpa.xtrace.General OFF、ALL、FINER、FINEST 对未包含在 JDBC、Lib、Persist 或 Kernel 类别中的 OpenJPA 类进行扩展跟踪(如果启用了扩展跟踪)。
      openjpa.xtrace.ApiSpi OFF、ALL、FINER、FINEST 用于为 WsJPA、OpenJPA 和 JPA 定义的公用 API/SPI 接口的扩展跟踪(如果启用了扩展跟踪)。
  3. 保存应用程序服务器配置并重新启动应用程序服务器。

结果

重新启动应用程序服务器后,将使用新的跟踪设置。

下一步做什么

避免故障 避免故障: 跟踪功能会使性能显著降级,因此在不使用时应被禁用。要禁用跟踪,请移除通用 JVM 自变量及对增强跟踪添加的任何跟踪详细级别。gotcha

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tejb_jpatracejee
文件名:tejb_jpatracejee.html