HPEL 文本日志配置设置

可对文本日志配置高性能可扩展日志记录 (HPEL) 设置。

受支持的配置: 仅当服务器配置为使用 HPEL 日志和跟踪方式时,才能访问此页面。

要查看此管理控制台页面,请单击 故障诊断> 日志和跟踪> server_name > 配置 HPEL 文本日志

启用文本日志

允许将记录和跟踪记录写至文本日志文件。

指定记录系统除了以二进制格式写入记录和跟踪记录以外,还以文本格式写入这些记录。 可将文本日志配置为使用基本方式 SystemOut.log 文件使用的任一格式。

避免麻烦: 写入文本日志的所有内容也会写入日志存储库或跟踪存储库。 启用文本日志会降低频繁创建日志或跟踪条目的应用程序的性能。

目录路径

指定日志文件将写至的目录。

文本日志的文件名格式为 TextLog_<yy.mm.dd>_<hh.mm.ss>,其中 文本日志 _ 是固定前缀, <yy.mm.dd> 是文件中第一个记录的日期 (年,月,日) , <hh.mm.ss> 是时间 (小时,分钟,秒)

避免麻烦: 无法在服务器之间共享此路径。 服务器将创建一个扩展名为 .owner 的文件,用来帮助检测是否有两个或两个以上的服务器试图对 HPEL 输出使用同一路径。

启用日志记录缓冲区

指定记录系统避免在每次创建日志记录时都写至磁盘。 记录系统创建一个可以保存许多日志记录的缓冲区,并在该缓冲区已满时写入已缓冲的事件。 几秒后日志记录系统还会写入缓存事件,即使缓冲区未满。

选择此设置将显著提高记录性能,然而,如果服务器意外停止,那么可能不会将内容写至文本日志文件。

最佳实践: 在几乎所有情况下启用日志记录缓冲。 仅当服务器意外故障并且在停止之前无法将缓冲内容写入到磁盘时,才会禁用日志记录缓冲。

每天在 <time> 开始新日志文件

启用记录框架以关闭日志文件并在指定的时间启动新文件。 关闭这些文件会使得容易将其复制到归档中。

最佳实践: 如果要自动归档日志文件,请将备份程序设置为在为要启动的新日志配置的时间之后复制文件。 请将备份过程配置为比配置的新日志启动时间至少晚 10 分钟进行,以确保服务器已关闭先前的文件。

开始清除最早记录

指定要用于从文本日志目录中自动清除最旧的日志记录或配置的空间中不再适合的日志记录的日志清除设置。

选择当日志大小接近最大值时以将日志文件自动清除过程配置为在文本日志文件的总大小接近配置的最大大小时开始。

选择当最旧的记录达到时限时以将日志文件自动清除过程配置为在日志内容达到指定的时限时开始。

选择当达到时限或大小限制时以将日志文件自动清除过程配置为在满足上述任一条件时开始。

无论选择了哪个选项,都将按写入文本日志文件的顺序从文本日志目录中删除文本日志文件。

日志记录时间限制

指定日志记录可以保留在文本日志目录中的预期使用期限(以小时计),在该预期使用期限之后,服务器可以自动删除这些日志记录。 当文本日志文件中的所有记录存在的时间都超过指定的时限时,那么该文件将成为服务器的删除目标。

最大日志大小

指定服务器允许文本日志文件达到的最大总大小(以兆字节计)。 当文本日志文件的总大小接近此大小限制时,服务器将从文本日志记录中删除最旧的文本日志文件,以便为新的日志记录腾出空间。

空间不足时的操作

指定服务器在无法将内容添加到文本日志目录时如何反应。

选择停止服务器以指定在服务器无法写至文本日志目录时停止服务器。

选择清除旧记录以指定服务器继续运行,并且在服务器无法写至文本日志目录时,将立即除去包含最旧的日志记录的文件。

选择停止日志记录以指定服务器继续运行,但服务器在无法写至文本日志目录时不能继续写至日志。

文本输出格式

指定在文本日志文件中要使用的格式。

选择基本以指定一种较短的格式,每个记录各占一行。

选择高级以指定一种较长的格式,以指定一种使用完整记录器名称的较长格式和有关每个记录的更多详细信息。

包括跟踪记录

指定文本日志文件中是否包含跟踪记录和日志记录。

同时将运行时更改保存到配置中

指定对正在运行的服务器的动态状态和服务器配置都进行了更改,这些更改在下次重新启动时生效。 如果未选中此复选框,那么服务器不会将这些设置复制到服务器配置中。