系统安全-O2OA日志输出设置log4j2.xml-平台部署与配置-O2OA企业应用开发平台-人人都是协同系统开发专家

系统安全-O2OA日志输出设置log4j2.xml

时间：2023-03-08

内容导读

本篇说明 O2OA 平台日志输出配置文件的修改方法。平台日志基于开源日志组件实现，较新版本改用新版配置方式，配置文件位于平台程序目录的 commons 子目录下。文中介绍默认日志文件的存放位置、运行日志的重定向方式，以及如何调整根日志级别和按模块单独设置日志级别，并提示生产环境宜采用较高的错误级别以降低 IO 开销，便于运维人员按需保留关键线索。

本篇主要介绍如何在 O2OA 中定制日志的输出级别与存储位置。O2OA 平台运行时会产生大量日志信息，管理员常通过日志排查错误与异常；日志基于 log4j 与 log4j2 实现，配置得当可以减少磁盘占用并保留有效线索。

一、先决条件：

1、O2Server 服务器正常运行，系统安装部署请参考文档《如何在服务器上安装部署 O2OA》2、以拥有管理员权限的用户账号登录 O2OA 平台，如：xadmin

二、日志输出设置

O2OA 日志基于 log4j 实现，v7.0 以后版本改为 log4j2，相较于旧版本，日志配置方式有所区别。

1、日志输出文件

在默认情况下，日志文件产生在 o2server 目录的 logs 子目录下，即 o2server/logs/out.log。

2、日志重定向

O2OA 服务器运行期间的 out、err 等日志，也会被重定向，合并输出到 o2server/logs/out.log。

3、log4j2配置文件

log4j2的配置文件在 o2server 的 commons 目录下，如：o2server/commons/log4j2.xml，默认配置内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration name="DefaultLogger" status="INFO">
<Appenders>
<RollingRandomAccessFile name="outFile" fileName="logs/out.log" filePattern="logs/out.%d{yyyy-MM-dd}.%i.log.gz">
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %p %c - %m%n" charset="UTF-8" />
<Policies>
<OnStartupTriggeringPolicy />
<TimeBasedTriggeringPolicy interval="1" modulate="true" />
</Policies>
<DefaultRolloverStrategy>
<Delete basePath="logs" maxDepth="1">
<IfFileName glob="out.*.*.log.gz" />
<IfLastModified age="30d" />
</Delete>
</DefaultRolloverStrategy>
</RollingRandomAccessFile>
</Appenders>
<Loggers>
<Root level="WARN">
<AppenderRef ref="outFile" />
</Root>
<Logger name="com.x" level="INFO" additivity="true"></Logger>
<Logger name="System.out" level="INFO" additivity="false">
<appender-ref ref="outFile" />
</Logger>
<Logger name="System.err" level="INFO" additivity="false">
</Loggers>
</Configuration>

1）调整日志级别

O2OA 默认的日志级别为"INFO"；：

<Logger name="com.x" level="INFO" additivity="true"></Logger>

管理员可以将日志级别修改为 DEBUG，或者 TRACE、ERROR 等其他输出级别。DEBUG 级别会输出代码调试信息，内容较多，同时将占用大量的系统 IO，建议在生产环境中将日志级别设置为 ERROR。

2）制定指定模块的日志级别

O2OA 支持针对指定模块单独设置日志级别，例如在 log4j2 配置文件中增加以下内容：

<Logger name="com.x" level="INFO" additivity="true"></Logger>
<Logger name="com.x.query.assemble.surface.jaxrs" level="DEBUG" additivity="true"></Logger>

<Logger name="com.x.query.assemble.surface.jaxrs" level="DEBUG"additivity="true">；以上配置内容表示将数据中心（com.x.query.assemble.surface.jaxrs）访问模块的日志级别设置为 DEBUG。请注意，配置完成后需要重启使配置生效。

以上内容主要说明了 O2OA 的 log4j2 配置文件修改方式，希望对您有所帮助。