| … | |
… | |
| 2 | |
2 | |
| 3 | AnyEvent::Log - simple logging "framework" |
3 | AnyEvent::Log - simple logging "framework" |
| 4 | |
4 | |
| 5 | =head1 SYNOPSIS |
5 | =head1 SYNOPSIS |
| 6 | |
6 | |
| 7 | # simple use: |
7 | Simple uses: |
| 8 | |
8 | |
| 9 | use AnyEvent; |
9 | use AnyEvent; |
| 10 | |
10 | |
| 11 | AE::log debug => "hit my knee"; |
11 | AE::log debug => "hit my knee"; |
| 12 | AE::log warn => "it's a bit too hot"; |
12 | AE::log warn => "it's a bit too hot"; |
| 13 | AE::log error => "the flag was false!"; |
13 | AE::log error => "the flag was false!"; |
| 14 | AE::log fatal => "the bit toggled! run!"; # never returns |
14 | AE::log fatal => "the bit toggled! run!"; # never returns |
| 15 | |
15 | |
| 16 | # "complex" use (for speed sensitive code): |
16 | "Complex" uses (for speed sensitive code): |
| 17 | |
17 | |
| 18 | use AnyEvent::Log; |
18 | use AnyEvent::Log; |
| 19 | |
19 | |
| 20 | my $tracer = AnyEvent::Log::logger trace => \$my $trace; |
20 | my $tracer = AnyEvent::Log::logger trace => \$my $trace; |
| 21 | |
21 | |
| 22 | $tracer->("i am here") if $trace; |
22 | $tracer->("i am here") if $trace; |
| 23 | $tracer->(sub { "lots of data: " . Dumper $self }) if $trace; |
23 | $tracer->(sub { "lots of data: " . Dumper $self }) if $trace; |
| 24 | |
24 | |
| 25 | # configuration: |
25 | Configuration (also look at the EXAMPLES section): |
| 26 | |
26 | |
| 27 | # set logging for the current package to errors and higher only |
27 | # set logging for the current package to errors and higher only |
| 28 | AnyEvent::Log::ctx->level ("error"); |
28 | AnyEvent::Log::ctx->level ("error"); |
| 29 | |
29 | |
| 30 | # set logging level to suppress anything below "notice" |
30 | # set logging level to suppress anything below "notice" |
| … | |
… | |
| 34 | # regardless of (most) other settings |
34 | # regardless of (most) other settings |
| 35 | $AnyEvent::Log::COLLECT->attach (new AnyEvent::Log::Ctx |
35 | $AnyEvent::Log::COLLECT->attach (new AnyEvent::Log::Ctx |
| 36 | level => "critical", |
36 | level => "critical", |
| 37 | log_to_syslog => 0, |
37 | log_to_syslog => 0, |
| 38 | ); |
38 | ); |
| 39 | |
|
|
| 40 | # see also EXAMPLES, below |
|
|
| 41 | |
39 | |
| 42 | =head1 DESCRIPTION |
40 | =head1 DESCRIPTION |
| 43 | |
41 | |
| 44 | This module implements a relatively simple "logging framework". It doesn't |
42 | This module implements a relatively simple "logging framework". It doesn't |
| 45 | attempt to be "the" logging solution or even "a" logging solution for |
43 | attempt to be "the" logging solution or even "a" logging solution for |
