Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Perl
Pull request Compare This branch is 29 commits ahead of daniel-pittman:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
examples
lib/Log/Any/Adapter
t
.gitignore
Changes
README.md
dist.ini

README.md

NAME

Log::Any::Adapter::Syslog - Send Log::Any logs to syslog

VERSION

version 1.5

SYNOPSIS

use Log::Any::Adapter;
Log::Any::Adapter->set('Syslog');

# You can override defaults:
use Unix::Syslog qw{:macros};
Log::Any::Adapter->set(
    'Syslog',
    # name defaults to basename($0)
    name     => 'my-name',
    # options default to LOG_PID
    options  => LOG_PID|LOG_PERROR,
    # facility defaults to LOG_LOCAL7
    facility => LOG_LOCAL7
);

DESCRIPTION

Log::Any is a generic adapter for writing logging into Perl modules; this adapter use the Unix::Syslog module to direct that output into the standard Unix syslog system.

CONFIGURATION

Log::Any::Adapter::Syslog is designed to work out of the box with no configuration required; the defaults should be reasonably sensible.

You can override the default configuration by passing extra arguments to the Log::Any::Adapter method:

  • name

The name argument defaults to the basename of $0 if not supplied, and is inserted into each line sent to syslog to identify the source.

  • options

The options configure the behaviour of syslog; see Unix::Syslog for details.

The default is LOG_PID, which includes the PID of the current process after the process name:

example-process[2345]: something amazing!

The most likely addition to that is LOG_PERROR which causes syslog to also send a copy of all log messages to the controlling terminal of the process.

WARNING: If you pass a defined value you are setting, not augmenting, the options. So, if you want LOG_PID as well as other flags, pass them all.

  • facility

The facility determines where syslog sends your messages. The default is LOCAL7, which is not the most useful value ever, but is less bad than assuming the fixed facilities.

See Unix::Syslog and syslog(3) for details on the available facilities.

AUTHORS

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Stephen Thirlwall.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

Something went wrong with that request. Please try again.