如何为Log4j2自定义ALERT级别设置Syslog Severity为1

问题根源 #

Log4j2的Syslog Appender默认不会为自定义日志级别分配对应Syslog Severity，会统一 fallback 到默认值（此处为5，对应Syslog的NOTICE级别）。要实现自定义级别到Syslog Severity的映射，需通过Rfc5424Layout配置级别重写策略来解决，这是最简洁规范的方案。

具体解决方案 #

1. 修改Syslog Appender配置，替换为Rfc5424Layout #

Rfc5424是Syslog的标准规范，支持明确的级别映射配置。将原配置中的PatternLayout替换为Rfc5424Layout，并添加级别重写规则：

appender.syslog.type = Syslog
appender.syslog.name = syslog
appender.syslog.host = rsyslog-server.hostname
appender.syslog.port = 2514
appender.syslog.facility = USER # 建议指定合法facility，如USER，<nil>可能引发默认值问题
appender.syslog.protocol = TCP
# 替换为Rfc5424Layout以支持级别映射
appender.syslog.layout.type = Rfc5424Layout
appender.syslog.layout.pattern = [%d{ISO8601}][%-5p][%-25c{1.}] %marker%m%n
appender.syslog.layout.characterSet = UTF-8
# 配置自定义级别到Syslog Severity的映射
appender.syslog.layout.levelRewritePolicy.type = LevelRewritePolicy
appender.syslog.layout.levelRewritePolicy.level.type = CustomLevelMapping
appender.syslog.layout.levelRewritePolicy.level.name = ALERT
# 可直接指定Syslog Severity名称或数字（1对应ALERT）
appender.syslog.layout.levelRewritePolicy.level.syslogSeverity = ALERT
# 也可以写为：appender.syslog.layout.levelRewritePolicy.level.syslogSeverity = 1

rootLogger.appenderRef.syslog.ref = syslog
rootLogger.level = info

2. 优化自定义级别注册（可选） #

若之前是通过代码手动创建ALERT级别，建议直接在Log4j2配置文件中定义，避免代码耦合：

levels.ALERT = 100

之后在代码中直接使用LOGGER.log(Level.getLevel("ALERT"), "Message Details: " + s)即可。

3. 验证Rsyslog接收结果 #

可通过tcpdump抓取发送到rsyslog的数据包，或查看rsyslog的调试日志，确认自定义ALERT级别的日志Severity字段已被设置为1。

补充说明 #

Syslog Severity数字对应关系：0(EMERG)、1(ALERT)、2(CRIT)、3(ERR)、4(WARNING)、5(NOTICE)、6(INFO)、7(DEBUG)

内容的提问来源于stack exchange，提问作者dewsingh