Log4Erl 使用小记

from：http://www.hezhiqiang.info/articles/84/log4erl-a-port-of-java-log4j
功能

支持多日志
当前文件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 代码

git clone git://github.com/ahmednawras/log4erl.git log4erl

Step2. Compile

如图4, 进入Log4erl源代码目录src执行:

make:all([{outdir, "../ebin"}]).

Step3. 安装

你要让Erlang能够找到Log4erl,两种方式

1. 把整个Log4erl目录复制到$ERLANG_HOME/lib目录下面.看上面第三张图.
2. 命令行指定

erl -pz /path/to/log4erl

Step4. 使用

application:start(log4erl).

创建配置文件并调用log4erl:conf(file)初始化

log4erl:conf(“priv/log4erl.conf”).

同样你可以用编程的方式对Log4erl进行配置

log4erl:add_logger(messages_log).
log4erl:add_console_appender(messages_log, cmd_logs, {warn, “[%L] %l%n”}).

好了,现在可以使用它了.

log4erl:info(“Information message”).

关于Log4erl的详细信息请查阅源代码根目录中的 Readme.txt, API.txt, Appenders_API.txt, CONFIGURATION.txt 文件.
Log4erl配置文件格式

logger [] {
…
}

指定了Logger的名称,你可以去任意你喜欢的名字.如果不指定任何名字,那么log4erl将把它作为默认的Logger使用,例如:

%% default logger
logger {
…
}

在一个Logger中,可以有一到多个Appender,例如

%% Default logger
%% it includes a file appender and a console appender
logger{
file_appender app2{
dir = “.”,
level = info,
file = my_app,
type = size,
max = 100000,
suffix = log,
rotation = 5,
format = ‘[%L] %I %l%n’
}
console_appender app1{
level = warn,
format = ‘%T %j [%L] %l%n’
}
}

Appender的配置格式如下

{
…
}

在Appender中你可以用’property=value’的格式来设置Appender的属性,属性剑以’,‘逗号分隔.每种Appender有不同的属性集合.

公共属性:
level = => 日志级别 (例如: warn)
format = => 输出格式 (查看 ‘Appenders.txt’)

file_appender

dir => 输出路径 (例如: /var/log/my_app)
file => 日志文件名称 (例如: my_app_log)
type => size,time. 当前仅实现了基于size的日志滚动
max => 每次日志滚动的最大文件大小
suffix => 日志文件后缀 (例如: log)
rotation => 循环滚动次数,例如为5, 当滚动到第五个日志文件并且日志文件达到指定size的时候就会覆盖前面的日志文件,依次循环

smtp_appender

ip => SMTP服务器IP地址
port => SMTP服务器端口
no_auth
username => 用户名
password => 密码
from => 寄信人地址
to => 收信人地址
tilte => 邮件标题
msg => 邮件内容

syslog_appender

facility => Facility (例如: ftp)
host => 发送syslog消息的目标主机 [可选]
port => syslog 端口[可选]