Log4j 发送 EMail 的配置

项目上线后，运行时往往也还会有异常发生，在异常抛出时，希望即时的得到反馈。所以需要配置LOG4J的发送EMAIL功能。

项目中原来使用的的Log4j版本为1.2.9 ，但此版本并不支持邮件服务的认证功能 ，遂重新下载了最新的版本1.2.14 ，查看源代码
此版本支持认证功能 ，下面是 log4j.properties 的具体配置 :

## ROOT
log4j.rootLogger=INFO,CONSOLE,A_default,MAIL

## CONSOLE
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.Threshold=INFO
log4j.appender.CONSOLE.Target=System.out
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
#log4j.appender.CONSOLE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
log4j.appender.CONSOLE.layout.ConversionPattern=[调试信息]%-5p %c %x - %m%n

## A_default
log4j.appender.A_default=org.apache.log4j.RollingFileAppender
log4j.appender.A_default.Threshold=INFO
log4j.appender.A_default.File=${webframe.root}/WEB-INF/logs/railstone.log
log4j.appender.A_default.MaxFileSize=4000KB
log4j.appender.A_default.MaxBackupIndex=10
log4j.appender.A_default.layout=org.apache.log4j.PatternLayout
log4j.appender.A_default.layout.ConversionPattern=[调试信息]%-5p %c %x - %m%n

## MAIL
log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
# 日志的错误级别
log4j.appender.MAIL.Threshold=ERROR
# 缓存文件大小，日志达到512K时发送Email
log4j.appender.MAIL.BufferSize=512
# 发送邮件的服务器
log4j.appender.MAIL.SMTPHost=smtp.163.com
# 邮件的标题
log4j.appender.MAIL.Subject=Log4J ErrorMessage
# 用户名
log4j.appender.MAIL.SMTPUsername=邮箱用户名
# 密码
log4j.appender.MAIL.SMTPPassword=邮箱密码
# 发件人地址
log4j.appender.MAIL.From=test@163.com
# 日志邮件的接收者
log4j.appender.MAIL.To=test@163.com
# 日志PatternLayout
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
# 日志的格式
log4j.appender.MAIL.layout.ConversionPattern=[ErrorMessage ] %d - %c -%-4r [%t] %-5p %c %x - %m%n

在配置完毕后，发现 即使是将 log4j.appender.MAIL.Threshold=ERROR 修改为 INFO 级别 ，也只有在日志输出级别为 ERROR （即代码中调用logger.error("message")方法）时才会发送邮件，不知道是什么原因，

Log4J发日志邮件给多个接收者及标题、正文乱码问题

利用javamail发送邮件，你需要导入包mail.jar和activation.jar这两个包 ，否则是没法发邮件的 ，下边配置文件里绿色行显示的就是发给两个接收者ac和ae。

这里会出现中文乱码问题，主要有两方面的乱码，一是标题乱码；二是正文乱码。下边具体说明这两种乱码的解决方案。
一、 标题乱码
Log4J日志邮件的标题在配置文件log4j.properties里设定，如下
log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
log4j.appender.MAIL.Threshold=FATAL
log4j.appender.MAIL.BufferSize=10
log4j.appender.MAIL.From=ab@163.com
log4j.appender.MAIL.SMTPHost=smtp@163.com
log4j.appender.MAIL.Subject= Log4J提醒您：系统发生了严重错误
log4j.appender.MAIL.To=ac @163.com,ae@163.com
log4j.appender.MAIL.layout=com.sun.DefineLayOut
log4j.appender.MAIL.layout.LocationInfo=true

灰色的行就是标题，log4J配置文件默认的读取方式是ISO-88591，遇到中文会出现乱码，我们可以把这个配置文件log4j.properties用jdk的工具native2asii转换一下编码方式。
命令：native2asii log4j.properties log4jxx.properties
把这个log4jxx.properties改名为log4j.properties取代原来的log4j.properties就ok了。
灰色行重新编码后是：
log4j.appender.MAIL.Subject=Log4J\u63d0\u9192\u60a8\uff1a\u7cfb\u7edf\u53d1\u751f\u4e86\u4e25\u91cd\u9519\u8bef

二、 正文乱码
正文乱码，解决也比较简单。阅读Log4J的源码类SMTPAppender，我们可以发现sendBuffer()方法中有这样一句：
part.setContent(sbuf.toString(), layout.getContentType());
我们继续追踪发现layout就是配置文件里的layout属性对应的布局模式。但是这些布局模式都是继承自Layout，而contentType是只 可通过getContentType方法取得，不能修改。所有的布局模式getContentType方法返回的都是”text/plain”；
为处理中文乱码，我们可以写一个布局模式。如果你要使用HTMLLayout，我们就写一个HTMLLayout的子类，覆盖HTMLLayout的 getContentType方法即可。假如我要用org.apache.log4j.HTMLLayout。我们就可以写一个DefineLayOut 类，代码如下：
package com.sun;

import org.apache.log4j.HTMLLayout;
public class DefineLayOut extends HTMLLayout{
public String getContentType() {
return "text/html;charset=GBK";
}
}
对应的配置文件设置如黄色行所示。

来源：http://jlk.iteye.com/blog/354216

配置方式2：

Log4j发送日志邮件的作用：
项目错误信息能及时（实时）反映给项目维护人员以及相关负责人。

优点：
1.快速响应；
2.共同监督；
3.邮件正文直接显示了错误信息，拷贝信息比登陆服务器再查找要方便；
4.在日志信息继续写入文件的前提下，多了另外一种获取信息的渠道。

补充：Log4j可以实现输出到控制台，文件，回滚文件，发送日志邮件，数据库，自定义标签。
发送邮件的一个重要的类是SMTPAppender，之前用的是 log4j-1.2.8，在1.2.8的版本中，SMTPAppender没有SMTPPassword 和SMTPUsername 属性。这两个属性分别是登录SMTP服务器发送认证的用户名和密码。

依赖的jar包：
log4j-1.2.15.jar（版本低于log4j-1.2.14.jar不支持SMTP认证）
mail.jar
activation.jar

在log4j.properties文件中配置：

### send error through email.
#log4j的邮件发送appender，如果有必要你可以写自己的appender
log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
#发送邮件的门槛，仅当等于或高于ERROR（比如FATAL）时，邮件才被发送
log4j.appender.MAIL.Threshold=ERROR
#缓存文件大小，日志达到10k时发送Email
log4j.appender.MAIL.BufferSize=10
#发送邮件的邮箱帐号
log4j.appender.MAIL.From=xxx@163.com
#SMTP邮件发送服务器地址
log4j.appender.MAIL.SMTPHost=smtp.163.com
#SMTP发送认证的帐号名
log4j.appender.MAIL.SMTPUsername=xxx@163.com
#SMTP发送认证帐号的密码
log4j.appender.MAIL.SMTPPassword=xxx
#是否打印调试信息，如果选true，则会输出和SMTP之间的握手等详细信息
log4j.appender.MAIL.SMTPDebug=false
#邮件主题
log4j.appender.MAIL.Subject=Log4JErrorMessage
#发送到什么邮箱，如果要发送给多个邮箱，则用逗号分隔；
#如果需要发副本给某人，则加入下列行
#log4j.appender.MAIL.Bcc=xxx@xxx.xxx
log4j.appender.MAIL.To=xxx@xxx.com
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
log4j.appender.MAIL.layout.ConversionPattern=[framework]%d - %c -%-4r[%t]%-5p %c %x -%m%n

Log4j的SMTP的级别默认是ERROR级别
默认是ERROR级别，那就是说，只有程序出错了，才可以收到邮件。不过可以自定义的级别，继承TriggeringEventEvaluator类，覆盖里面的一个方法：

@Override
public  boolean isTriggeringEvent(LoggingEvent arg0) {
return arg0.getLevel().isGreaterOrEqual(Level.INFO);
}

SMTPAppender 实现是，每当isTriggeringEvent（）这个方法返回true的时候，它都会发送邮件。这样的话，一个程序执行下来，每个有能力触发的事件都会形成一封邮件。
事件的个数达到bufferSize的一半的时候就会发一封邮件：
继承了SMTPAppender类，重写了append方法 ;

@Override
public void append(LoggingEvent event) {
if (!checkEntryConditions()) {
return;
}
event.getThreadName();
event.getNDC();
event.getMDCCopy();
if (this.getLocationInfo()) {
event.getLocationInformation();
}
cb.add(event);
if (evaluator.isTriggeringEvent(event)) {
if (cb.length() > this.getBufferSize() / 2) {
sendBuffer();
}
}
}

另外一个问题也随之产生了，当程序结束时，还在缓冲里面的事件是不会被发送出来的。因为事件数往往没有bufferSize的一半。

public   *****SMTPAppender() {
Runtime.getRuntime().addShutdownHook(new Thread() {
@Override
public void run() {
if (cb.length() > 0) {
sendBuffer();
}
}
});
}

log4j有网页格式的输出：

log4j.appender.MAIL.layout=org.apache.log4j.HTMLLayout

解决邮件中的中文乱码问题，继承HTMLLayout,覆盖getContentType方法

@Override
public String getContentType() {
return "text/html;charset=GBK";
}