Log::Any::Adapter::Journal - Adapter for Log::Any that outputs with a priority prefix that systemd's journal can parse
version 1.0
use Log::Any::Adapter;
Log::Any::Adapter->set( 'Journal',
# min_level => 'debug', # default is 'warning'
# colors => { }, # customize colors
# use_color => 1, # force color even when not interactive
# stderr => 0, # print to STDOUT instead of the default STDERR
# formatter => sub { "LOG: $_[1]" }, # default none
);
When sending log messages to systemd's journal, the priority can be set by prefixing the message with the priority (as a number) in angled brackets. This adapter will format Log::Any messages to accomodate the systemd's log parser.
By default, systemd will parse the output from commands run as systemd
services/units for the priority prefix (both STDOUT and STDERR). Users can
also pipe output through the systemd-cat
command to enable parsing of
priority for scripts.
Journald doesn't support the trace (8) log level. If the min_level is set to 'trace', then logs will be sent to journald with the debug (7) log level. This behavior changed in version 1.0 of Log::Any::Adapter::Journal. Prior to version 1.0, trace logs were treated as if they were debug logs, so they were sent to with debug (7) log level even if min_level was 'debug'.
This adapter is based on the Log::Any::Adapter::Screen, and accepts the same
optional settings. We assume you want color output when running interactively
and the priority prefix otherwise. More precisely, the priority prefix will be
added when ! -t STDIN
or !!use_color
. See Log::Any::Adapter::Screen
for more information on the various options.
Log::Any, Log::Any::Adapter::Screen, systemd-cat
Please report any bugs or feature requests on the bugtracker website http://github.com/mvgrimes/Log-Any-Adapter-Journal/issues
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
Mark Grimes mgrimes@cpan.org
Source repository is at https://github.com/mvgrimes/Log-Any-Adapter-Journal.
This software is copyright (c) 2016 by Mark Grimes mgrimes@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.