http://developerworks.github.io/2011/05/16/erlang-use-log4erl/
Erlang 使用Log4erl
all = debug < info < warn < error < fatal < none
更新历史:
- 2014-09-25 23:34:31
功能
- 支持多日志
- 当前文件Appender仅支持基于大小的日志文件滚动
- 支持默认Logger,未指定Logger时系统提供默认Logger
- 5个预定义的日志级别(debug, info, warn, error, fatal)
- 一个error_logger的日志处理器
- 支持用户指定日志级别
- 支持日志格式化
- 支持控制台日志
- 支持smtp formatter
- 支持XML格式的日志
- 支持syslog
- 支持在运行时改变Appender的格式和级别.
Step1. Checkout from repository
你可以从 -Google code 或者- Github上获取Log4erl的源代码, Google code上的代码已经旧了,建议从Github上clone 代码
1 | git clone git://github.com/ahmednawras/log4erl.git log4erl |
Clone a copy from github
Checkout a copy from google code
Log4erl目录结构
编译Log4erl
Step2. 编译
如图4, 进入Log4erl源代码目录src执行:
1 | make:all([{outdir, "../ebin"}]). |
Step3. 安装
你要让Erlang能够找到Log4erl,两种方式
- 把整个Log4erl目录复制到$ERLANG_HOME/lib目录下面.看上面第三张图.
- 命令行指定
1 | erl -pz /path/to/log4erl |
Step4. 使用
1 | application:start(log4erl). |
创建配置文件并调用log4erl:conf(file)初始化
1 | log4erl:conf("priv/log4erl.conf"). |
同样你可以用编程的方式对Log4erl进行配置
1 | log4erl:add_logger(messages_log). |
好了,现在可以使用它了.
1 | log4erl:info("Information message"). |
Log4erl配置文件格式
1 | logger [<name>] { |
<name>
指定了Logger的名称,你可以去任意你喜欢的名字.如果不指定任何名字,那么log4erl将把它作为默认的Logger使用,例如:
1 | %% default logger |
在一个Logger中,可以有一到多个Appender,例如
1 | %% Default logger |
Appender的配置格式如下
1 | <appender_type> <name> { |
在Appender中你可以用’property=value’的格式来设置Appender的属性,属性剑以’,’逗号分隔.每种Appender有不同的属性集合.
公共属性:
1 | level = <Level> => 日志级别 (例如: warn) |
file_appender
1 | dir => 输出路径 (例如: /var/log/my_app) |
smtp_appender
1 | ip => SMTP服务器IP地址 |
syslog_appender
1 | facility => Facility (例如: ftp) |
新建一个测试项目test
新建module,test_log,代码如下
-module(test_log). -export([init/0,log/0]). init()-> init_log4erl(). log()-> log4erl:warn("warn3 msg"). init_log4erl() -> application:start(log4erl), log4erl:add_file_appender(app,{"/ide/erlang/workspace/log", "app", {size, 100000}, 10, log, info}), log4erl:change_format(app, "%j %T [%L] %l%n"), log4erl:add_console_appender(cmd_logs, {info, "%j %T [%L] %l%n"}).
log格式的配置,可以参看log4erl自带的README.txt,和API.txt
验证
1)启动 test_log:init().
2)使用 test_log:log().
结果:
2012-05-30 13:57:02.180647 [error] check_pid_is_alive error!
本文源码:
https://github.com/developerworks/skypebot/tree/master/src/erlang/log4erl_example
参考资料: