NAME

Log::Log4perl::Appender::Lumberjack - log appender writing to a lumberjack server

VERSION

version 1.00

SYNOPSIS

  use Log::Log4perl;

  my $conf = q(
    log4perl.category = INFO, Remote
    # ...
    log4perl.appender.Remote = Log::Log4perl::Appender::Lumberjack
    log4perl.appender.Remote.host = 127.0.0.1
    log4perl.appender.Remote.port = 5044
    log4perl.appender.Remote.keepalive = 0
    log4perl.appender.Remote.frame_format = json
    #log4perl.appender.Remote.use_ssl = 1
    #log4perl.appender.Remote.ssl_verify = 1
    # these two options prevent the message from being stringified
    log4perl.appender.Remote.layout = Log::Log4perl::Layout::NoopLayout
    log4perl.appender.Remote.warp_message = 0
  );

  Log::Log4perl::init( \$conf );

  my $log = Log::Log4perl::get_logger("Foo::Bar");
  $log->info('just for information...');

OPTIONS

host (default: '127.0.0.1')

Host to connect to.

port (default: 5044)

TCP port to connect to.

keepalive (default: 0)

If enabled connection will be keept open between send_data() calls. Otherwise it will be closed and reopened on every call.

Needs to be disabled for logstash-input-beats since it expects only one bulk of frames per connection.

frame_formt (default: 'json')

The following frame formats are supported:

'json', 'v2'

Uses json formatted data frames as defined in lumberjack protocol v2. (type 'J')

'data', 'v1'

Uses lumberjack DATA (type 'D') frames as defined in lumberjack protocol v1.

This format only supports a flat hash structure.

use_ssl (default: 0)

Enable SSL transport encryption.

ssl_verify (default: 1)

Enable verification of SSL server certificate.

ssl_ca_file (default: emtpy)

Use a non-default CA file to retrieve list of trusted root CAs.

Otherwise the system wide default will be used.

ssl_ca_path (default: emtpy)

Use a non-default CA path to retrieve list of trusted root CAs.

Otherwise the system wide default will be used.

ssl_version (default: empty)

Use a non-default SSL protocol version string.

Otherwise the system wide default will be used.

Check IO::Socket::SSL for string format.

ssl_hostname (default: emtpy)

Use a hostname other than the hostname give in 'host' for SSL certificate verification.

This could be used if you use a IP address to connecting to server that only lists the hostname in its certificate.

ssl_cert (default: empty)

ssl_key (default: empty)

If 'ssl_cert_file' and 'ssl_key_file' is the client will enable client side authentication and use the supplied certificate/key.

AUTHOR

Markus Benning <ich@markusbenning.de>

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 by Markus Benning.

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