阅读138 返回首页    go 阿里云

log4j-appender__loghub-采集_用户指南_日志服务-阿里云

Loghub Log4j Appender

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

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

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

  1. level:ERROR
  2. location:test.TestLog4jAppender.main(TestLog4jAppender.java:18)
  3. message:test log4j appender
  4. thread:main
  5. 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工程中引入依赖。

  1. <dependency>
  2.     <groupId>com.aliyun.openservices</groupId>
  3.     <artifactId>log-loghub-log4j-appender</artifactId>
  4.     <version>0.1.3</version>
  5. </dependency>

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

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

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

使用loghub appender的配置如下：

  1. log4j.rootLogger=WARN,loghub
  2. log4j.appender.loghub = com.aliyun.openservices.log.log4j.LoghubAppender
  3. log4j.appender.loghub.projectName = [you project]
  4. log4j.appender.loghub.logstore = [you logstore]
  5. log4j.appender.loghub.endpoint = [your project endpoint]
  6. log4j.appender.loghub.accessKeyId = [your accesskey id]
  7. log4j.appender.loghub.accessKey = [your accesskey]

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

配置参数

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

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

最后更新：2016-12-14 20:33:55

  上一篇：go web tracking__loghub-采集_用户指南_日志服务-阿里云
  下一篇：go producer-lib__loghub-采集_用户指南_日志服务-阿里云