log::handler::output::socket(3pm) [debian man page]
Log::Handler::Output::Socket(3pm) User Contributed Perl Documentation Log::Handler::Output::Socket(3pm)NAME
Log::Handler::Output::Socket - Send messages to a socket.
SYNOPSIS
use Log::Handler::Output::Socket;
my $sock = Log::Handler::Output::Socket->new(
peeraddr => "127.0.0.1",
peerport => 44444,
proto => "tcp",
timeout => 10
);
$sock->log(message => $message);
DESCRIPTION
With this module it's possible to send messages over the network.
METHODS
new()
Call "new()" to create a new Log::Handler::Output::Socket object.
The following options are possible:
peeraddr
The address of the server.
peerport
The port to connect to.
proto
The protocol you wish to use. Default is TCP.
timeout
The timeout to send message. The default is 5 seconds.
persistent and reconnect
With this option you can enable or disable a persistent connection and re-connect if the connection was lost.
Both options are set to 1 on default.
dump
Do you like to dump the message? If you enable this option then all messages will be dumped with "Data::Dumper".
dumper
Do you want to use another dumper as "Data::Dumper"? You can do the following as example:
use Convert::Bencode_XS;
dumper => sub { Convert::Bencode_XS::bencode($_[0]) }
# or maybe
use JSON::PC;
dumper => sub { JSON::PC::convert($_[0]) }
connect
This option is only useful if you want to pass your own arguments to "IO::Socket::INET" and don't want use "peeraddr" and "peerhost".
Example:
connect => {
PerrAddr => "127.0.0.1",
PeerPort => 44444,
LocalPort => 44445
}
This options are passed to "IO::Socket::INET".
log()
Call "log()" if you want to send a message over the socket.
Example:
$sock->log("message");
connect()
Connect to the socket.
disconnect()
Disconnect from socket.
validate()
Validate a configuration.
reload()
Reload with a new configuration.
errstr()
This function returns the last error message.
PREREQUISITES
Carp
Params::Validate;
IO::Socket::INET;
Data::Dumper;
EXPORTS
No exports.
REPORT BUGS
Please report all bugs to <jschulz.cpan(at)bloonix.de>.
If you send me a mail then add Log::Handler into the subject.
AUTHOR
Jonny Schulz <jschulz.cpan(at)bloonix.de>.
COPYRIGHT
Copyright (C) 2007-2009 by Jonny Schulz. All rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
perl v5.14.2 2012-11-21 Log::Handler::Output::Socket(3pm)
Check Out this Related Man Page
Log::Handler::Output::Sendmail(3pm) User Contributed Perl Documentation Log::Handler::Output::Sendmail(3pm)NAME
Log::Handler::Output::Sendmail - Log messages with sendmail.
SYNOPSIS
use Log::Handler::Output::Sendmail;
my $email = Log::Handler::Output::Sendmail->new(
from => 'bar@foo.example',
to => 'foo@bar.example',
subject => 'your subject',
);
$email->log(message => $message);
DESCRIPTION
With this output module it's possible to log messages via "sendmail".
METHODS
new()
Call "new()" to create a new Log::Handler::Output::Sendmail object.
The following options are possible:
from
The sender address (From).
to The receipient address (To).
cc Carbon Copy (Cc).
bcc Blind Carbon Copy (Bcc)
subject
The subject of the mail.
sender
This option is identical with "sendmail -f".
header
With this options it's possible to set your own header.
my $email = Log::Handler::Output::Sendmail->new(
from => 'bar@foo.example',
to => 'foo@bar.example',
header => 'Content-Type: text/plain; charset= UTF-8',
);
Or
my $email = Log::Handler::Output::Sendmail->new(
header => {
From => 'bar@foo.example',
To => 'foo@bar.example',
Subject => 'my subject',
'Content-Type' => text/plain; charset= UTF-8',
}
);
Or
my $email = Log::Handler::Output::Sendmail->new(
header => [
'From: bar@foo.example',
'To: foo@bar.example',
'Subject: my subject',
'Content-Type: text/plain; charset= UTF-8',
]
);
sendmail
The default is set to "/usr/sbin/sendmail".
params
Parameters for "sendmail".
The default is set to "-t".
maxsize
Set the maximum size of the buffer in bytes.
All messages will be buffered and if "maxsize" is exceeded the buffer is flushed and the messages will be send as email.
The default is set to 1048576 bytes.
Set 0 if you want no buffering and send a mail for each log message.
debug
Set 1 if you want to enable debugging.
The messages can be fetched with $SIG{__WARN__}.
log()
Call "log()" if you want to log a message as email.
$email->log(message => "this message will be mailed");
If you pass the level then its placed into the subject:
$email->log(message => "foo", level => "INFO");
$email->log(message => "bar", level => "ERROR");
$email->log(message => "baz", level => "DEBUG");
The lowest level is used:
Subject: ERROR ...
You can pass the level with "Log::Handler" by setting
message_pattern => '%L'
flush()
Call "flush()" if you want to flush the buffered messages.
validate()
Validate a configuration.
reload()
Reload with a new configuration.
errstr()
This function returns the last error message.
DESTROY
"DESTROY" is defined and called "flush()".
PREREQUISITES
Carp
Params::Validate
EXPORTS
No exports.
REPORT BUGS
Please report all bugs to <jschulz.cpan(at)bloonix.de>.
If you send me a mail then add Log::Handler into the subject.
AUTHOR
Jonny Schulz <jschulz.cpan(at)bloonix.de>.
COPYRIGHT
Copyright (C) 2007-2009 by Jonny Schulz. All rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
perl v5.14.2 2012-11-21 Log::Handler::Output::Sendmail(3pm)