使用 Log4J 日志记录样本
此样本演示 TPTP 支持使用 Apache Log4J 日志记录 API 来记录公共基本事件。用户将体验把公共基本事件记录到控制台和日志记录代理程序。
如果尚未通过选择文件 > 新建 > 示例... > Apache Log4J 日志记录样本来创建此示例,则完成此任务。
样本内容包括将公共基本事件记录到 Apache Log4J 记录器时所需的 Java 源代码、依赖项和配置文件。
要编译和执行此样本,需要 Apache Log4J 1.2.8(已包括在样本内容中)或更高版本。
假设
- 当从工作台的“概要分析和日志记录”透视图启动此应用程序时,应用程序启动配置或者代理控制器应用程序或服务类路径包含 Apache Log4J 1.2.8 或更高版本。
- “log4j.configuration”环境变量设置为 Apache Log4J 日志记录配置文件(HyadesLoggingLog4JSample.xml )的绝对路径和名称(URL 格式),例如,file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml。
- 将把 <Apache Log4J 日志记录 JAR>/org/apache/log4j/xml/log4j.dtd
中定义的 Apache Log4J 文档类型定义(DTD)复制到
<workspace>/HyadesLoggingLog4JProject/cfg/ 目录中,以供
Apache Log4J 日志记录配置文件(file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml)使用。
要运行此样本并自动连接到日志记录代理程序,请执行下列步骤:
- 确认已更正所有编译错误。
- 如果您使用的是代理控制器(AC)的独立安装版本,则确保它已启动(非必要)。此外,也可以使用直接连接(这是工作台中包括的有限数目的 AC 服务)。
- 打开“概要分析和日志记录”透视图(窗口 > 打开透视图 > 其他... > 概要分析和日志记录)。
-
从“概要分析和日志记录”透视图中运行样本类(运行 > 概要分析... > 创建 Java 应用程序类型的新启动配置
> 将项目名设置为示例的项目名 > 将 Main 类设置为“HyadesLoggingLog4JSample”>
切换到“参数”选项卡并指定以下 JVM 属性:-Dlog4j.configuration="file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml"
> 切换到“监视”选项卡 > 取消选择“Java 概要分析”并选择“代理程序探索器”> 概要分析)。
- 在几秒钟之后,应该会自动检测到日志记录代理程序并与其连接。选择已发现的日志记录代理程序,然后在“概要分析和日志记录”透视图中打开日志视图,以查看已记录的公共基本事件日志记录(窗口 > 显示视图 > 其他... > 概要分析和日志记录 > 日志视图 > 确定)。
- 在“概要分析和日志记录”透视图中刷新日志视图(<右键单击“HyadesLoggingLog4JSample”日志记录代理程序> > 刷新)。
此外,要运行此样本并手工连接至日志记录代理程序,请执行下列步骤:
- 确认已更正所有编译错误。
- 如果您使用的是代理控制器(AC)的独立安装版本,则确保它已启动(非必要)。此外,也可以使用直接连接(这是工作台中包括的有限数目的 AC 服务)。
-
从 Java 透视图中运行样本类(运行 > 运行... > 创建 Java 应用程序类型的新启动配置 > Main 类 >
搜索... > HyadesLoggingLog4JSample > 确定 > 切换到“参数”选项卡并指定以下
JVM 属性:-Dlog4j.configuration="file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml"
> 运行)。
- 打开“概要分析和日志记录”透视图(窗口 > 打开透视图 > 其他... > 概要分析和日志记录)。
- 在“概要分析和日志记录”透视图中连接至“HyadesLoggingLog4JSample”日志记录代理程序(运行 > 概要分析...
> 连接 - Java 进程 > 新建 >“主机”选项卡 > 如果您使用的不是代理控制器的独立安装版本,则使用“本地直接连接”。否则,请使用有效的主机名和端口。>“代理程序”选项卡 >
双击 HyadesLoggingLog4JSample 代理程序 > 选择“目标”选项卡 > 概要分析项目 >
浏览... >“HyadesLoggingLog4JProject”> 确定 > 概要分析)。
- 开始监视“HyadesLoggingLog4JSample”日志记录代理程序(<右键单击“HyadesLoggingLog4JSample”日志记录代理程序> > 开始监视)。
- 在“概要分析和日志记录”透视图中打开日志视图,以查看已记录的公共基本事件日志记录(窗口 > 显示视图 > 其他... > 概要分析和日志记录 > 日志视图 > 确定)。
- 在“概要分析和日志记录”透视图中刷新日志视图(<右键单击“HyadesLoggingLog4JSample”日志记录代理程序> > 刷新)。
(C) Copyright IBM Corporation 2000, 2006.