1Log::Any::Adapter::SyslUosge(r3)Contributed Perl DocumenLtoagt:i:oAnny::Adapter::Syslog(3)
2
3
4
6 Log::Any::Adapter::Syslog - Send Log::Any logs to syslog
7
9 version 1.710
10
12 use Log::Any::Adapter 'Syslog';
13 # ... or ...
14 use Log::Any::Adapter;
15 Log::Any::Adapter->set('Syslog');
16
17 # You can override defaults:
18 Log::Any::Adapter->set(
19 'Syslog',
20 # name defaults to basename($0)
21 name => 'my-name',
22 # options default to "pid"
23 options => "pid,ndelay",
24 # facility defaults to "local7"
25 facility => "mail"
26 );
27
29 Log::Any is a generic adapter for writing logging into Perl modules;
30 this adapter use the Sys::Syslog module to direct that output into the
31 OS's logging system (even on Windows).
32
34 "Log::Any::Adapter::Syslog" is designed to work out of the box with no
35 configuration required; the defaults should be reasonably sensible.
36
37 You can override the default configuration by passing extra arguments
38 to the "Log::Any::Adapter" method:
39
40 name
41 The name argument defaults to the basename of $0 if not supplied,
42 and is inserted into each line sent to syslog to identify the
43 source.
44
45 options
46 The options configure the behaviour of syslog; see Sys::Syslog for
47 details.
48
49 The default is "pid", which includes the PID of the current process
50 after the process name:
51
52 example-process[2345]: something amazing!
53
54 The most likely addition to that is "perror" (non-POSIX) which
55 causes syslog to also send a copy of all log messages to the
56 controlling terminal of the process.
57
58 facility
59 The facility determines where syslog sends your messages. The
60 default is "local7", which is not the most useful value ever, but
61 is less bad than assuming the fixed facilities.
62
63 See Sys::Syslog and syslog(3) for details on the available
64 facilities.
65
66 log_level
67 Minimum log level. All messages below the selected level will be
68 silently discarded. Default is debug.
69
70 If LOG_LEVEL environment variable is set, it will be used instead.
71 If TRACE environment variable is set to true, level will be set to
72 'trace'. If DEBUG environment variable is set to true, level will
73 be set to 'debug'. If VERBOSE environment variable is set to true,
74 level will be set to 'info'.If QUIET environment variable is set to
75 true, level will be set to 'error'.
76
78 • Jonathan Swartz <swartz@pobox.com>
79
80 • David Golden <dagolden@cpan.org>
81
82 • Doug Bell <preaction@cpan.org>
83
84 • Daniel Pittman <daniel@rimspace.net>
85
86 • Stephen Thirlwall <sdt@cpan.org>
87
89 This software is copyright (c) 2017 by Jonathan Swartz, David Golden,
90 and Doug Bell.
91
92 This is free software; you can redistribute it and/or modify it under
93 the same terms as the Perl 5 programming language system itself.
94
95
96
97perl v5.34.0 2022-01-21 Log::Any::Adapter::Syslog(3)