1Appender::RRDs(3) User Contributed Perl Documentation Appender::RRDs(3)
2
3
4
6 Log::Log4perl::Appender::RRDs - Log to a RRDtool Archive
7
9 use Log::Log4perl qw(get_logger);
10 use RRDs;
11
12 my $DB = "myrrddb.dat";
13
14 RRDs::create(
15 $DB, "--step=1",
16 "DS:myvalue:GAUGE:2:U:U",
17 "RRA:MAX:0.5:1:120");
18
19 print time(), "\n";
20
21 Log::Log4perl->init(\qq{
22 log4perl.category = INFO, RRDapp
23 log4perl.appender.RRDapp = Log::Log4perl::Appender::RRDs
24 log4perl.appender.RRDapp.dbname = $DB
25 log4perl.appender.RRDapp.layout = Log::Log4perl::Layout::PatternLayout
26 log4perl.appender.RRDapp.layout.ConversionPattern = N:%m
27 });
28
29 my $logger = get_logger();
30
31 for(10, 15, 20, 25) {
32 $logger->info($_);
33 sleep 1;
34 }
35
37 "Log::Log4perl::Appender::RRDs" appenders facilitate writing data to
38 RRDtool round-robin archives via Log4perl. For documentation on RRD and
39 its Perl interface "RRDs" (which comes with the distribution), check
40 out <http://rrdtool.org>.
41
42 Messages sent to Log4perl's RRDs appender are expected to be numerical
43 values (ints or floats), which then are used to run a "rrdtool update"
44 command on an existing round-robin database. The name of this database
45 needs to be set in the appender's "dbname" configuration parameter.
46
47 If there's more parameters you wish to pass to the "update" method, use
48 the "rrdupd_params" configuration parameter:
49
50 log4perl.appender.RRDapp.rrdupd_params = --template=in:out
51
52 To read out the round robin database later on, use "rrdtool fetch" or
53 "rrdtool graph" for graphic displays.
54
56 Copyright 2002-2013 by Mike Schilli <m@perlmeister.com> and Kevin Goess
57 <cpan@goess.org>.
58
59 This library is free software; you can redistribute it and/or modify it
60 under the same terms as Perl itself.
61
63 Please contribute patches to the project on Github:
64
65 http://github.com/mschilli/log4perl
66
67 Send bug reports or requests for enhancements to the authors via our
68
69 MAILING LIST (questions, bug reports, suggestions/patches):
70 log4perl-devel@lists.sourceforge.net
71
72 Authors (please contact them via the list above, not directly): Mike
73 Schilli <m@perlmeister.com>, Kevin Goess <cpan@goess.org>
74
75 Contributors (in alphabetical order): Ateeq Altaf, Cory Bennett, Jens
76 Berthold, Jeremy Bopp, Hutton Davidson, Chris R. Donnelly, Matisse
77 Enzer, Hugh Esco, Anthony Foiani, James FitzGibbon, Carl Franks, Dennis
78 Gregorovic, Andy Grundman, Paul Harrington, Alexander Hartmaier David
79 Hull, Robert Jacobson, Jason Kohles, Jeff Macdonald, Markus Peter,
80 Brett Rann, Peter Rabbitson, Erik Selberg, Aaron Straup Cope, Lars
81 Thegler, David Viner, Mac Yang.
82
83
84
85perl v5.28.1 2017-02-21 Appender::RRDs(3)