Log4j2配置 |
您所在的位置：网站首页 › log4j2配置详解及使用 › Log4j2配置 |
|
Log4j 2
配置
可以自动加载配置，配置文件包括四种格式：properties,yml,json,xml，配置文件优先级依次为 log4j2.configurationFile > log4j2-test.properties > log4j2-test.yaml或log4j2-test.yml > log4j2-test.json或log4j2-test.jsn > log4j2-test.xml > log4j2.properties > log4j2.yaml或log4j2.yml > log4j2.json或log4j2.jsn > log4j2.xml > DefaultConfiguration，配置文件需要放在classpath路径下 配置文件示例在实际项目中用过properties和xml格式，yml和json没用过 log4j2.properties # 名称 name=PropertiesConfig # 全局日志级别 status=INFO # 过滤器 # 过滤器类型 filter.threshold.type = ThresholdFilter # 过滤级别 filter.threshold.level = debug # console # 指定输出源的类型与名称 appender.console.type=Console appender.console.name=Console appender.console.layout.type=PatternLayout # 输出模板 appender.console.layout.pattern=%d%p[%c]-%m%n # rolling file appender.rolling.type=RollingFile appender.rolling.name=RollingFile appender.rolling.fileName=logs/properties.log # 指定当发生Rolling时，文件的转移和重命名规则 appender.rolling.filePattern=logs/properties.%d{YYYYMMdd}.log appender.rolling.layout.type=PatternLayout appender.rolling.layout.pattern=%d%p[%c]-%m%n # 指定记录文件的封存策略，该策略主要是完成周期性的日志文件封存工作 appender.rolling.policies.type=Policies # 基于时间的触发策略 appender.rolling.policies.time.type=TimeBasedTriggeringPolicy # 当前记录周期为每天生成一个文件 appender.rolling.policies.time.interval=1 # 设置是否按小时来计算封存周期，否则以文件名格式 appender.rolling.policies.time.modulate = false # 含有包含关系的类包，被子包的需要放在父包前面 loggers=org.hibernate.util.JDBCExceptionReporter,org.hibernate logger.org.hibernate.util.JDBCExceptionReporter.name=org.hibernate.util.JDBCExceptionReporter logger.org.hibernate.util.JDBCExceptionReporter.level=OFF logger.org.hibernate.util.JDBCExceptionReporter.appenderRef.stdout.ref=Console logger.org.hibernate.util.JDBCExceptionReporter.appenderRef.rolling.ref=RollingFile logger.org.hibernate.util.JDBCExceptionReporter.additivity=false logger.org.hibernate.name=org.hibernate logger.org.hibernate.level=FATAL logger.org.hibernate.appenderRef.stdout.ref=Console logger.org.hibernate.appenderRef.rolling.ref=RollingFile logger.org.hibernate.additivity=false # rootLogger, 根记录器，所有记录器的父辈 # 指定根日志的级别 rootLogger.level=info # 指定输出的appender引用 rootLogger.appenderRef.stdout.ref=Console rootLogger.appenderRef.rolling.ref=RollingFile log4j2.yml Configuration: status: warn name: YAMLConfigTest properties: property: name: filename value: target/test-yaml.log thresholdFilter: level: debug appenders: Console: name: STDOUT target: SYSTEM_OUT PatternLayout: Pattern: "%m%n" File: name: File fileName: ${filename} PatternLayout: Pattern: "%d %p %C{1.} [%t] %m%n" Filters: ThresholdFilter: level: error Loggers: logger: - name: org.apache.logging.log4j.test1 level: debug additivity: false ThreadContextMapFilter: KeyValuePair: key: test value: 123 AppenderRef: ref: STDOUT - name: org.apache.logging.log4j.test2 level: debug additivity: false AppenderRef: ref: File Root: level: error AppenderRef: ref: STDOUT log4j2.json { "configuration": { "status": "debug", "name": "RoutingTest", "packages": "org.apache.logging.log4j.test", "properties": { "property": { "name": "filename", "value" : "target/rolling1/rollingtest-$${sd:type}.log" } }, "ThresholdFilter": { "level": "debug" }, "appenders": { "appender": [ { "type": "Console", "name": "STDOUT", "PatternLayout": { "pattern": "%m%n" }, "ThresholdFilter": { "level": "debug" }}, { "type": "Routing", "name": "Routing", "Routes": { "pattern": "$${sd:type}", "Route": [ { "RollingFile": { "name": "Rolling-${sd:type}", "fileName": "${filename}", "filePattern": "target/rolling1/test1-${sd:type}.%i.log.gz", "PatternLayout": {"pattern": "%d %p %c{1.} [%t] %m%n"}, "SizeBasedTriggeringPolicy": { "size": "500" } } }, { "AppenderRef": "STDOUT", "key": "Audit"} ] } } ] }, "loggers": { "logger": [ { "name": "EventLogger", "level": "info", "additivity": "false", "AppenderRef": { "ref": "Routing" }}, { "name": "com.foo.bar", "level": "error", "additivity": "false", "AppenderRef": { "ref": "STDOUT" }} ], "root": { "level": "error", "AppenderRef": { "ref": "STDOUT" }} } } } log4j2.xml 配置参数 appender组件列表 append 描述 AsyncAppender 用于接受其他类型appender的引用，并使用单独线程异步写入log CassandraAppender 将日志写入Cassandra数据库中，需要提前建立keyspace和table ConsoleAppender 其日志写入System.out或System.err，默认为System.out FailoverAppender 故障转移appender，可以指定主appender，并且包含一组appender集合，当主appender写入失败，则会依次使用其他append写入，直至写入成功或者全部appender写入失败 FileAppender 将日志写入文件，使用FileManager执行io FlumeAppender 将日志序列化后发送给Flume代理。 可选组件，由单独的jar提供。 JDBCAppender 使用标准JDBC将日志写入关系数据库表，必须使用连接池 JMS Appender 将日志发送至JMS中 JPAAppender 通过JPA将日志写入关系型数据库表，需要有单独的persistence.xml配置文件 HttpAppender 通过http请求发送日志，使用HttpURLConnection实现，响应2XX状态码为成功，否则抛出异常 KafkaAppender 将日志事件发送到Kafka的topic中 MemoryMappedFileAppender 2.1新增功能，将指定日志文件的一部分映射至内存，并将新日志事件写入此内存，达到阈值时将此内存刷新至存储设备 NoSQLAppender 使用内部轻量级Provider接口将日志事件写入NoSQL数据库。目前只有MongoDB和Apache CouchDB的Provider实现 NoSQLAppender for MongoDB 2.0.11开始，提供两个MongoDB模块：log4j-mongodb2、log4j-mongodb3 NoSQLAppender for MongoDB 2 使用MongoDB驱动程序版本2将日志写入MongoDB中 NoSQLAppender for MongoDB 3 使用MongoDB驱动程序版本3将日志写入MongoDB中 NoSQLAppender for Apache CouchDB 使用内部轻量级Provider将日志写入CouchDB中 OutputStreamAppender OutputStreamAppender不能直接配置，只是作为基础组件提供给其他Appender使用，如可以将日志事件写入输出流的File和Socket RandomAccessFileAppender 与FileAppender相比，使用的I/O实现类不同，FileAppender使用FileOutputStream，RandomAccessFileAppender 使用RandomAccessFile。bufferedIO=true(默认是true)时，性能提高20-200％ 。 RewriteAppender 用于在日志被其他Appender写入文件之前，通过RewritePolicy修改日志事件 RollingFileAppender 将日志写入文件，并根据TriggeringPolicy和RolloverPolicy规则将文件归档、清理 RollingRandomAccessFileAppender 与RollingFileAppender相比，使用的I/O实现类不同，RollingFileAppender使用FileOutputStream，RollingRandomAccessFileAppender使用RandomAccessFile。bufferedIO=true(默认是true)时，性能提高20-200％ 。 RoutingAppender 配置不同的规则，将日志路由到不同的Appender进行输出 SMTPAppender 发生指定日志事件时，发送电子邮件 ScriptAppenderSelector 根据Script脚本的执行结果来选择AppenderSet中配置的Appender，并将结果输出至ScriptAppenderSelector的name中 SocketAppender 通过tcp或者udp，将日志写入远程目标中 SyslogAppender SyslogAppender是一个SocketAppender，它将其输出以符合BSD Syslog或RFC 5424格式的日志写入到远程目标 ZeroMQ/JeroMQ Appender ZeroMQ Appender使用JeroMQ库将日志事件发送到一个或多个ZeroMQ端点 ConsoleAppenderConsoleAppender比较简单，就是把日志写入System.out或者System.err中，基本配置如下：
Console一般使用基本配置就可以，唯一要注意的就是输出格式pattern，pattern的配置释义如下： 参数 描述 %c或%logger 输出logName，如 Logger log = LoggerFactory.getLogger(“com.test.logName”); 则输出为“com.test.logName” ，如果格式为%c{参数}，则输出内容参考官网： %C或%class 输出为所在类的全路径名 d{pattern}或date{pattern} 输出时间，其中pattern可以是保留字，也可以是SimpleDateFormat中的字符。如 %d{DEFAULT} --> 2012-11-02 14:34:02,781 %d{DEFAULT_MICROS} --> 2012-11-02 14:34:02,123456 %d{yyyy-MM-dd HH:mm:ss.SSS} --> 2020-03-31 23:25:13.321 详见log4j PatternLayout %F或%file 输出所在类名.java，如所在类为com.test.LogTest，则输出为LogTest.java %l 输出错误的完整位置，全路径类名.方法名(类名.java:行号)，如，com.test.LogTest.testLog(LogTest.java:31) %L 输出行号 %m或%msg或%message 输出log.error(text)中的text内容 %M或%method 输出方法名 %n 换行符 %t或%thread 输出线程名 %u{“RANDOM”| “TIME”}或uuid 输出uuid %sn或%sequenceNumber 输出自增序列 %r或%relative 输出从JVM启动到当前时刻的毫秒数 %T或%tid或%threadId 输出线程id %t或%tn或%thread或%threadName 输出线程id %tp或%threadPriority 输出线程优先级 RollingFileAppenderRollingFileAppender是一个OutputStreamAppender，可以根据TriggeringPolicy和RolloverPolicy将文件切割归档，通过RollingFileManager（扩展了OutputStreamManager）来实际执行文件I / O并执行归档。参数如下： 参数 类型 描述 append boolean 默认为true。如果为true，记录将附加到文件末尾。设置为false时，将在写入新记录之前清除文件 bufferedIO boolean 默认为true。如果为true，数据先写入缓冲区，如果缓冲区满或者immediateFlush 为true时，数据才被写入磁盘，如果为false直接写入磁盘。文件锁定不能与bufferedIO一起使用 bufferSize int 缓冲区大小。bufferedIO为true时，此参数有效，默认为8192 bytes createOnDemand boolean 默认为false。按需创建文件。仅当日志事件通过所有Filter并且路由到该append时，append才创建文件 filter Filter 确定事件是否应由此Appender处理，通过CompositeFilter（对应标签为）可以使用多个过滤器 fileName String 要写入的文件名，如果不存在或者父目录不存在，则创建对应的文件或目录 filePattern String 归档文件的模式，取决于所使用的RolloverPolicy immediateFlush boolean 默认为true。如果为true，每次写操作后都会将数据刷新入磁盘，可能会影响性能。 每次写入后刷新仅在使用同步appender时才有用。即使设置为false，异步appender也将在一批事件结束后自动刷新，这也可以确保效率更高的将数据写入磁盘。 layout Layout 格式化日志输出格式。如果未设置，则默认为’%m%n’ name String append名称 policy TriggeringPolicy 用于确定归档的触发条件 strategy RolloverStrategy 用于确定归档的文件名称、路径及归档方式 ignoreExceptions boolean 默认为true。设置为true时，如果记录日志发生异常，此条日志和异常将被忽略。设置为false时，异常将被抛出到调用方。如果此append用在FailoverAppender中，则必须设置为false。 filePermissions String 创建文件时指定文件的rwx权限，前提是文件系统应支持POSIX文件属性视图 fileOwner String 文件所有者。出于安全原因，更改文件的所有者可能受到限制，并且不允许操作时会抛出IOException。 如果_POSIX_CHOWN_RESTRICTED对路径有效，则只有有效用户ID等于文件用户ID或具有适当特权的进程才可以更改文件的所有权，前提是文件系统应支持文件所有者属性视图 fileGroup String 文件组。，前提是文件系统应支持POSIX文件属性视图 TriggeringPolicyTriggeringPolicy是控制日志文件归档的触发条件。总共有四种类型的TriggeringPolicy，可以组合（CompositeTriggeringPolicy）多种触发策略来控制归档，标签为，如果配置了多种策略，则只要有一种策略返回true，就返回true。
四种类型如下： OnStartupTriggeringPolicy 如果日志文件的时间比JVM的启动时间早，或者达到minSize的值，则会触发归档。 minSize：触发文件归档的最小值，默认为1。 SizeBasedTriggeringPolicy 当文件达到指定大小后，触发归档。大小可以通过size指定，单位为KB、MB、GB。与TimeBasedTriggeringPolicy配合使用时，filePattern中必须包含%i，否则文件每次归档时都会覆盖当前文件，因为TimeBasedTriggeringPolicy不会让文件名中的时间戳改变。如果不使用TimeBasedTriggeringPolicy，则SizeBasedTriggeringPolicy会让时间戳改变。 TimeBasedTriggeringPolicy 当前时间与当前日志文件时间不匹配时，TimeBasedTriggeringPolicy会触发归档。参数如下： 参数 描述 interval 基于filePattern中配置的最小时间单位进行来控制归档频率，默认值为1。如：filePattern中最小时间单位为小时，如果interval=1，则1小时归档一次；如果interval=2，则2小时归档一次。 modulate 默认为false。指明是否对interval进行调节，若modulate为true，会以0为开始对interval进行偏移计算。例如，最小时间粒度为小时，当前为3:00，interval为4，则后面归档时间依次为4:00，8:00，12:00，16:00 maxRandomDelay 指示随机延迟过渡的最大秒数。默认情况下，该值为0，表示没有延迟。此设置在配置了多个应用程序以同时滚动日志文件的服务器上很有用，并且可以在整个时间上分散这样做的负担。 CronTriggeringPolicy 基于cron表达式触发归档。此策略由计时器控制，并且与处理日志事件异步，因此上一个或下一个时间段的日志事件可能会出现在当前日志文件的开头或结尾。filePattern属性应包含一个时间戳，否则目标文件将在每次归档时被覆盖。参数如下： 参数 描述 schedule cron表达式，该表达式与Quartz调度程序中允许的表达式相同。详见CronExpression EvaluationOnStartup 启动时，将根据文件的最后修改时间戳评估cron表达式。如果cron表达式指示应该在该时间和当前时间之间归档，则文件将立即被归档。 RolloverPolicy用来控制文件归档方式，目前有两种类型：DefaultRolloverStrategy和DirectWriteRolloverStrategy DefaultRolloverStrategy通过接收filePattern属性中日期/时间模式（%d）和整数（%i）来控制归档方式。如果存在日期/时间模式，则将在归档时使用当前时间替换filePattern中配置的日期/时间部分，如果模式包含整数，则它将在每次归档时递增。如果归档时在模式中同时包含日期/时间和整数，则整数将递增，直到日期/时间部分也将被替换。如果文件模式以“ .gz”，“.zip”，“.bz2”，“.deflate”，“.pack200”或“ .xz”结尾，则将使用与后缀匹配的压缩方案来压缩文件。 bzip2, Deflate, Pack200 and XZ格式要求有Apache Commons Compress组件，另外xz格式还要求有XZ for Java组件。 DefaultRolloverStrategy参数如下： 参数 描述 fileIndex 默认值为max。可选值为：min、max，2.8之后新增nomax。文件归档及新文件创建规则后面介绍。 min 计数器的最小值。预设值为1。 max 计数器的最大值。一旦达到此值，较旧的归档文件将在以后的转换中被删除。预设值为7。 compressionLevel 将压缩级别设置为0-9，其中0 =无，1 =最佳速度，直到9 =最佳压缩。仅针对ZIP文件实现 tempCompressedFilePattern 压缩期间归档日志文件的文件名的模式。fileIndex设值不同，则文件归档及新文件创建及计数器递增方法都不同，计数器递增有三种方式，如下： 方式一：fileIndex值为max 假设将DefaultRolloverStrategy的min属性设置为1，将max属性设置为3，fileName是“ foo.log”，filePattern是“ foo-％i.log”,归档规则如下： 归档数 当前日志文件 归档文件 描述 0 foo.log - 所有日志记录都将转到初始文件 1 foo.log foo-1.log 第一次归档，foo.log重命名为foo-1.log。创建新的foo.log文件并继续写入 2 foo.log foo-2.log，foo-1.log 第二次归档，foo.log重命名为foo-2.log。创建新的foo.log文件并继续写入 3 foo.log foo-3.log，foo-2.log，foo-1.log 第三次归档，foo.log重命名为foo-3.log。创建新的foo.log文件并继续写入 4 foo.log foo-3.log，foo-2.log，foo-1.log 第四次和随后的归档，foo-1.log被删除，foo-2.log被重命名为foo-1.log，foo-3.log被重命名为foo-2.log，foo.log被重命名为foo-3.log。创建新的foo.log文件并继续写入。 方式二：fileIndex值为min假设将DefaultRolloverStrategy的min属性设置为1，将max属性设置为3，fileName是“ foo.log”，filePattern是“ foo-％i.log”,归档规则如下： 归档数 当前日志文件 归档文件 描述 0 foo.log - 所有日志记录都将转到初始文件 1 foo.log foo-1.log 第一次归档，foo.log重命名为foo-1.log。创建新的foo.log文件并继续写入 2 foo.log foo-1.log，foo-2.log 第二次归档，将foo-1.log重命名为foo-2.log，并将foo.log重命名为foo-1.log。创建新的foo.log文件并继续写入 3 foo.log foo-1.log，foo-2.log，foo-3.log 第三次归档，将foo-2.log重命名为foo-3.log，将foo-1.log重命名为foo-2.log，将foo.log重命名为foo-1.log。创建新的foo.log文件并继续写入 4 foo.log foo-1.log，foo-2.log，foo-3.log 第四次和随后的归档，删除foo-3.log，将foo-2.log重命名为foo-3.log，将foo-1.log重命名为foo-2.log，将foo.log重命名为foo -1.log。创建新的foo.log文件并继续写入。 方式三：fileIndex值为nomax nomax为2.8新增属性，设置为nomax时，将忽略DefaultRolloverStrategy的最大值和最小值，每次归档生成的新文件相对于前一个文件编号加1，没有最大文件数限制。 DirectWriteRolloverStrategy将日志事件直接写入由filePattern表示的文件。使用此策略文件不会执行重命名。如果是基于大小的触发策略，将在指定的时间段内写入多个文件，它们从1开始编号，并不断递增直到发生基于时间归档。 注意：如果filePattern的后缀表示应该进行压缩，则在关闭应用程序时不会压缩当前文件。此外，如果时间更改使得filePattern不再与当前文件匹配，则启动时也不会对其进行压缩。 DirectWriteRolloverStrategy模式参数如下： 参数 描述 maxFiles 与文件格式匹配的时间段内允许的最大文件数。如果超出文件数量，则最早的文件将被删除。如果指定，则该值必须大于1。如果该值小于零或省略，则文件数量将不受限制。 compressionLevel 将压缩级别设置为0-9，其中0 =无，1 =最佳速度，直到9 =最佳压缩。仅针对ZIP文件实现。 tempCompressedFilePattern 压缩期间归档日志文件的文件名的模式。 归档保留策略DefaultRolloverStrategy模式下，Log4j-2.5引入了Delete（删除）操作（标签为），与 max属性所提供的功能相比，Log4j-2.5使用户可以更好地控制在归档时删除哪些文件。删除操作使用户可以配置一个或多个条件，以选择要相对于基本目录删除的文件。 注意：可以删除任何文件，而不仅仅是删除日志文件，因此请谨慎使用此操作！使用testMode参数，可以测试配置，而不会意外删除错误的文件。 delete参数如下： 参数 描述 basePath 必需。从此处开始扫描要删除的文件的基本路径。 maxDepth 要访问的目录的最大级别数。值为0表示仅访问起始文件，除非安全管理器拒绝。Integer.MAX_VALUE的值指示应访问所有级别。默认值为1，表示仅指定基本路径中的文件。 followLinks 是否遵循符号链接。默认为false。 testMode 如果为true，则不会删除文件，而是在INFO级别打印一条消息到状态记录器。使用此功能可以测试配置是否按预期工作。默认为false。 pathSorter 一个实现PathSorter 接口的插件， 用于在选择要删除的文件之前对文件进行排序。默认设置是首先对最近修改的文件进行排序。 pathConditions 如果未指定ScriptCondition，则为必需。可以指定一个或多个PathCondition元素。如果指定了多个PathCondition元素，则需要所有的PathCondition结果都为true才会进行删除。PathCondition也可以嵌套。如果进行嵌套，则是先判断外层的PathCondition，然后进行内层的判断。如果没有嵌套，则是按顺序进行判断。也可以创建自定义条件或使用内置条件：IfFileName 如果文件名与此参数匹配则结果为true，此参数为正则表达式或 glob的文件。IfLastModified 最后修改时间早于或等于此参数则结果为true，此参数为duration。IfAccumulatedFileCount 文件数超过指定个数则结果为true，此参数为整型。IfAccumulatedFileSize 所有文件总大小达到此参数则结果为true，此参数为KB、MB、GB。IfAll 如果此标签下的所有条件都配置成功（逻辑与），则结果为true。IfAny 如果此标签下的任何一个条件匹配成功（逻辑或），则结果为true。IfNot 如果此标签下的所有条件都不匹配（逻辑非），则结果为true。 scriptCondition 如果未指定PathConditions，则为必需。指定脚本的ScriptCondition元素。ScriptCondition应该包含一个Script，ScriptRef或ScriptFile元素，该元素指定要执行的逻辑。（有关配置ScriptFiles和ScriptRefs的更多示例，另请参阅ScriptFilter文档。）该脚本传递了许多参数，包括在basePath下找到的路径列表（最大maxDepth），并且必须返回包含要删除的路径的列表。 |
今日新闻 |
推荐新闻 |
| CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |