Loghub Log4j Appender介绍

Log4j是Apache的一个开放源代码项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件、甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等；我们也可以控制每一条日志的输出格式；通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是，这些可以通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。

Log4j由三个重要的组件构成：日志信息的优先级，日志信息的输出目的地，日志信息的输出格式。日志信息的优先级从高到低有ERROR、WARN、INFO、DEBUG，分别用来指定这条日志信息的重要程度；日志信息的输出目的地指定了日志将打印到控制台还是文件中；而输出格式则控制了日志信息的显示内容。

使用Loghub Log4j Appender，您可以控制日志的输出目的地为阿里云日志服务，有一点需要特别注意，Loghub Log4j Appender不支持设置日志的输出格式，写到日志服务中的日志的样式如下：

level:ERROR
location:test.TestLog4jAppender.main(TestLog4jAppender.java:18)
message:test log4j appender
thread:main
time:2016-05-27T03:15+0000

level是日志级别，location是日志打印语句的代码位置，message是日志内容，thread是线程名称，time是日志打印时间。

使用Loghub Log4j Appender的好处

1. 客户端日志不落盘：既数据生产后直接通过网络发往服务端。
2. 对于已经使用log4j记录日志的应用，只需要简单修改配置文件就可以将日志传输到日志服务。
3. 异步高吞吐，Loghub Log4j Appender会将用户的日志merge之后异步发送，提高网络IO效率。

使用方法

Step 1： maven工程中引入依赖。

<dependency>
    <groupId>com.aliyun.openservices</groupId>
    <artifactId>log-loghub-log4j-appender</artifactId>
    <version>0.1.3</version>
</dependency>

Step 2: 修改log4j.properties文件(不存在则在项目根目录创建)，配置根Logger，其语法为：

log4j.rootLogger = [level] , appenderName1, appenderName2, …

其中，level 是日志记录的优先级，优先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别，您可以控制到应用程序中相应级别的日志信息的开关。比如在这里定义了INFO级别，则应用程序中所有DEBUG级别的日志信息将不被打印出来。
appenderName就是指定日志信息输出到哪个地方。您可以同时指定多个输出目的地，这里的每个appender会对应到具体某一种appender类型，每种appender都会提供一些配置参数。

使用loghub appender的配置如下：

log4j.rootLogger=WARN,loghub
log4j.appender.loghub = com.aliyun.openservices.log.log4j.LoghubAppender
log4j.appender.loghub.projectName = [you project]
log4j.appender.loghub.logstore = [you logstore]
log4j.appender.loghub.endpoint = [your project endpoint]
log4j.appender.loghub.accessKeyId = [your accesskey id]
log4j.appender.loghub.accessKey = [your accesskey]

配置中中括号内的部分是需要填写的，具体含义见下面的说明。

loghub appender配置参数

Loghub Log4j Appender可供配置的参数如下，其中注释为必选参数的是必须填写的，可选参数在不填写的情况下，使用默认值。

#日志服务的project名，必选参数
log4j.appender.loghub.projectName = [you project]
#日志服务的logstore名，必选参数
log4j.appender.loghub.logstore = [you logstore]
#日志服务的http地址，必选参数
log4j.appender.loghub.endpoint = [your project endpoint]
#用户身份标识，必选参数
log4j.appender.loghub.accessKeyId = [your accesskey id]
log4j.appender.loghub.accessKey = [your accesskey]
#当使用临时身份时必须填写，非临时身份则删掉这行配置
log4j.appender.loghub.stsToken=[your ststoken]
#被缓存起来的日志的发送超时时间，如果缓存超时，则会被立即发送，单位是毫秒，可选参数
log4j.appender.loghub.packageTimeoutInMS=5000
#每个缓存的日志包中包含日志数量的最大值，不能超过4096，可选参数
log4j.appender.loghub.logsCountPerPackage=4096
#每个缓存的日志包的大小的上限，不能超过5MB，单位是字节，可选参数
log4j.appender.loghub.logsBytesPerPackage = 5242880
#Appender实例可以使用的内存的上限，单位是字节，默认是100MB，可选参数
log4j.appender.loghub.memPoolSizeInByte=1048576000
#后台用于发送日志包的IO线程的数量，默认值是1，可选参数
log4j.appender.loghub.ioThreadsCount=1
# 输出到日志服务的时间格式，使用java中SimpleDateFormat格式化时间，默认是ISO8601，可选参数
log4j.appender.loghub.timeFormat=yyyy-MM-dd'T'HH:mmZ
log4j.appender.loghub.timeZone=UTC