J2EE 组件配置文件

下面列出并描述 J2EE 组件配置文件。

config.properties

如果检测的应用程序服务器正在运行 IBM JVM，则此文件定义哪些 Java 类和软件包显式地从检测中排除出去。这些类包含已经有意排除的 IBM 或容器级别类。在包含这些类之前联系支持人员。修改 <MA_HOME>/app/instrument/lib/config.properties 文件以包含没有检测的类或排除已检测的类。对 config.properties 文件的更改会影响管理代理程序上的所有 J2EE 组件。在对 config.properties 文件做出更改后，必须重新启动应用程序服务器以使更改生效。

deployedJ2EEMonitoringApps.properties

此 deployedJ2EEMonitoringApps.properties 文件包含安装在管理代理程序上的 J2EE 监视组件的当前运行时。该文件在 J2EE 监视组件安装或卸载时更新。当启动或关闭检测的应用程序服务器时也会更新 deployedJ2EEMonitoringApps.properties 文件。该更新指出监视到应用程序服务器是活动的。此文件中的状态信息还可从 IBM Tivoli Monitoring for Transaction Performance 用户界面获取。执行以下步骤以从用户 IBM Tivoli Monitoring for Transaction Performance 访问状态信息：

1. 单击系统管理。
2. 单击处理代理程序。
3. 选择代理程序。
4. 单击查看详细信息。

此 deployedJ2EEMonitoringApps.properties 文件是动态生成的。请勿修改该文件。

属性文件中的键值对如下：

• deployedMonitoringApps=UUID1 UUID2 ...
• UUID1.status=INSTALL_FAILED
• UUID1.statusIsPermanent=true
• UUID2.status=RUNNING
• UUID2.statusIsPermanent=false

属性文件中的值可能以任意顺序列出。属性的顺序无关紧要。deployedMonitoringApps=UUID1 UUID2 ... 属性用于“deployedMonitoringApps”键。此键的值是 J2EE 监视组件的用空格分隔的 UUID 列表，这些组件部署到此管理代理程序。例如，此键值对可能读作“deployedMonitoringApps=102 114”。

每个列出的 UUID 在文件中都有两个附加条目。一个条目使用键“UUID.status”。另一个条目使用键“UUID.statusIsPermanent”。UUID.status 键可以采用几个状态值之一，这些值记录在《IBM Tivoli Monitoring for Transaction Performance 安装指南》的“部署监视组件”一章中。在上述示例中，第一个 UUID 状态为“INSTALL_FAILED”，而第二个 UUID 状态为“RUNNING”。每个的 UUID 的另一个条目为“UUID.statusIsPermanent”。此键的值指示状态值是否必须由正在进行的心跳更新。如果 UUID.statusIsPermanent=true，则更新的状态定期从检测的应用程序服务器发送到管理代理程序。此心跳让管理代理程序知道 J2EE 监视仍是活动的。当丢失心跳时，检测的应用程序服务器不再运行，这可能是由正以宽限方式关闭的应用程序服务器造成的，或者甚至是由应用程序服务器崩溃造成的。当丢失心跳时，监视组件的状态更改为 UNKNOWN，因为它并不清除检测的应用程序服务器发生的情况。

属性	描述	缺省值
deployedMonitoringApps	当前安装的 J2EE 组件。
statusIsPermanent	如果组件到达了终极状态（如，INSTALL_FAILED），则此值为 true	false
status	组件的当前状态	RUNNING

deployedJ2EEMonitoringApps.properties 文件位于 <MA_HOME>/app/instrument/ic/config/ 目录中。

icGeneric.properties

InstrumentationController（IC）是检测的应用程序服务器的 J2EE 组件的控制器。IC 在应用程序服务器的 JVM 的远程进程中运行。IC 通过本地端口与管理代理程序通信。此 icGeneric.properties 文件使您能够修改 IC 的连接行为，包括端口号和端口范围。

jiti.properties

如果检测的应用程序服务器正在运行 Sun JVM，则此文件定义哪些 Java 类和软件包显式地从检测中排除出去。这些类包含已经有意排除的 IBM 或容器级别类，不得包含这些类，除非首先咨询了支持人员。如果要包含一个没在检测的类或排除一个正在检测的类，则可以修改此文件。对此文件的更改会影响管理代理程序上的所有 J2EE 组件。

如果更改了此文件，则必须重新启动检测的应用程序服务器以使更改生效。jiti.properties 文件位于 <MA_HOME>/app/instrument/lib/ 目录中。

logging.properties

此文件控制产品的跟踪行为。每个 IBM Tivoli Monitoring for Transaction Performance 进程都有一个 logging.properties 文件。对于 J2EE 组件，至少存在两个 logging.properties 文件：一个用于管理代理程序，而另一个用于每个检测的应用程序服务器。

管理代理程序的 logging.properties 文件位于 <MA_HOME>/config/ 目录中。J2EE 组件的 logging.properties 文件位于 <MA_HOME>/app/instrument/appServers/<UID>/config/ 目录中。

monitoringApplication.properties

此 monitoringApplication.properties 文件包含用于安装特定 J2EE 组件的配置参数。配置参数的值由用户在组件配置期间通过管理服务器用户界面提供。此 monitoringApplication.properties 文件是在安装期间动态生成的。请勿修改 monitoringApplication.properties 文件。monitoringApplication.properties 文件位于 <MA_HOME>/app/instrument/appServers/<UID>/config/ 目录中。

privacy.properties

此文件为在此管理代理程序上运行的 IBM Tivoli Monitoring for Transaction Performance 组件配置隐私和安全设置。如果已经启用了隐私和安全，则此管理代理程序上的 IBM Tivoli Monitoring for Transaction Performance 组件不收集隐私或安全信息。

一些隐私信息示例包含：

• 用户名
• 远程主机名
• 远程地址

一些安全信息示例包含以下各项：

• 请求参数，可包含：
  • 用户名
  • password
  • 信用卡号
• SQL 语句
• EJB 主键

如果修改 privacy.properties 文件，则必须重新启动管理代理程序以使更改生效。privacy.properties 文件位于 <MA_HOME>/config/ 目录中。

TivoliInstrEJB.properties

TivoliInstrEJB.properties 文件包含通过分析在应用程序服务器上运行的已安装应用程序的部署描述符而收集的信息。EJB 探测使用 TivoliInstrEJB.properties 文件中的信息，以确定各种本地 EJB 的类型并收集其它信息以显示为度量值。当新的应用程序添加到应用程序服务器时，请重新运行 <MA_HOME>/app/instrument/bin/ejbprops.<sh.cmd> 命令以使用最新的信息更新 TivoliInstrEJB.properties 文件。