红帽全球峰会11.5.5. 配置 Periodic 大小轮转日志处理程序
本节介绍如何使用管理 CLI 配置定期大小轮转日志处理程序。您还可以通过使用管理控制台配置定期大小日志处理程序，导航到 Configuration
用于配置定期大小日志处理器的主要任务有：
如果您要为日志记录配置集配置此日志处理程序，则命令的开头为 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 而不是 /subsystem=logging/。
此外，如果您在受管域中运行，请在命令前加上 /profile=PROFILE_NAME。
添加定期大小日志处理程序
在添加定期大小日志处理程序时，您必须使用 file 属性指定文件路径，该属性由 path 和 relative -to 属性组成。使用 path 属性设置日志的文件路径，包括名称，如 my-log.log。（可选）使用 relative-to 属性设置 路径 相对于指定路径，如 jboss.server.log.dir。
您还必须使用 suffix 属性为轮转日志设置后缀。这的格式必须可以被 java.text.SimpleDateFormat（ 如 .yyyyyy-MM-dd-HH） 理解。轮转期间会基于此后缀自动计算。
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH},suffix=SUFFIX)
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH},suffix=SUFFIX)配置定期大小日志处理程序设置
根据您的需要，您可能需要设置以下一个或多个定期大小日志处理程序属性：有关可用定期大小日志处理程序属性及其描述的完整列表，请参阅 Periodic Sandler Attributes。
设置日志级别。
为处理程序设置适当的日志级别。默认值为
ALL。有关所有可用选项，请参阅日志级别。/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)Copy to Clipboard Copied! Toggle word wrap Toggle overflow 设置轮转大小。
设置在轮转之前文件能够达到的最大大小。默认值为
2m(2 MB)。/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=rotate-size, value=ROTATE_SIZE)
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=rotate-size, value=ROTATE_SIZE)Copy to Clipboard Copied! Toggle word wrap Toggle overflow 设置要保留的最大备份日志数。
设置要保留的备份数。默认值为
1。/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=max-backup-index, value=MAX_BACKUPS)
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=max-backup-index, value=MAX_BACKUPS)Copy to Clipboard Copied! Toggle word wrap Toggle overflow 设置是否在引导时轮转日志。
默认情况下，服务器重启时不会创建新的日志文件。您可以将此项设置为
true，以在服务器重启时轮转日志。/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=rotate-on-boot, value=ROTATE_ON_BOOT)
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=rotate-on-boot, value=ROTATE_ON_BOOT)Copy to Clipboard Copied! Toggle word wrap Toggle overflow 设置附加行为。
默认情况下，JBoss EAP 将在服务器重启时将日志消息附加到同一文件中。您可以将
append属性设置为false，使其在服务器重启时覆盖文件。/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=append,value=APPEND)
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=append,value=APPEND)Copy to Clipboard Copied! Toggle word wrap Toggle overflow 设置编码.
设置处理程序的编码，如
utf-8。/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)Copy to Clipboard Copied! Toggle word wrap Toggle overflow 设置日志格式器。
设置处理程序的格式字符串。例如，默认格式字符串为
%d{HH:mm:ss,SSS} %-5p [%c](%t)%s%e%n。务必在引号中包含FORMAT值。/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注意如果要引用 保存的格式器，请使用
named-formatter属性。设置自动刷新.
设置是否在每次写入后自动清空。默认值为
true。/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)Copy to Clipboard Copied! Toggle word wrap Toggle overflow 设置过滤器表达式。
设置表达式，以过滤处理程序的日志消息。务必用引号转义任何逗号和引号。例如，对于过滤器表达式
not（match("WFLY")，需要将以下WFLY\")"。FILTER_EXPRESSION可替换变量替换为"not（match(\"/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)Copy to Clipboard Copied! Toggle word wrap Toggle overflow 有关可用过滤器表达式的更多信息，请参阅 Filter Expressions 部分。
将 Periodic Size Log Handler 分配给日志记录器
要激活日志处理程序，您必须将其分配到日志记录器。
以下管理 CLI 命令将定期大小日志处理程序分配给根日志记录器：
/subsystem=logging/root-logger=ROOT:add-handler(name=PERIODIC_SIZE_HANDLER_NAME)
/subsystem=logging/root-logger=ROOT:add-handler(name=PERIODIC_SIZE_HANDLER_NAME)
以下管理 CLI 命令将定期大小日志处理程序分配给由 CATEGORY 指定名称的日志记录器：
/subsystem=logging/logger=CATEGORY:add-handler(name=PERIODIC_SIZE_HANDLER_NAME)
/subsystem=logging/logger=CATEGORY:add-handler(name=PERIODIC_SIZE_HANDLER_NAME)删除定期大小日志处理程序
可以使用 remove 操作移除日志处理程序。如果当前分配给日志记录器或异步日志处理程序，则无法移除日志处理程序。
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:remove
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:remove
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}