NAME

Log::Agent::Driver::Mail - email driver for Log::Agent

SYNOPSIS

 use Log::Agent;
 require Log::Agent::Driver::Mail;

 my $driver = Log::Agent::Driver::Mail->make(
     -to      => 'oncall@example.org',
     -cc      => [ qw( noc@example.org admin@example,net ) ],
     -subject => "ALERT! ALERT!",
     -mailer  => [ 'smtp', Server => 'mail.example.net' ]
 );
 logconfig(-driver => $driver);

DESCRIPTION

This driver maps the logxxx() calls to email messages. Each call generates a separate email message. The Mail::Mailer module is required.

CONSTRUCTOR

make OPTIONS

The OPTIONS argument is a hash with the following keys:

-prefix

An optional prefix for the message body.

-to

The destination addresses, may be a scalar containing a valid email address or a reference to an array of addresses.

-reply_to

The reply-to addresses, may be a scalar containing a valid email address or a reference to an array of addresses.

-from

The source address, must be a scalar containing a valid email address.

-subject

The subject line of the email message.

-cc

The carbon copy addresses, may be a scalar containing a valid email address or a reference to an array of addresses.

-bcc

The blind carbon copy addresses, may be a scalar containing a valid email address or a reference to an array of addresses.

-priority

The priority level for the email message. This is NOT related to the logging priority.

-mailer

A reference to an array containing the optional arguments to Mail::Mailer->new(). Generally, this can be omitted.

NOTES

Thanks to Shirley Wang for the idea for this module.

AUTHOR

Mark Rogaski <mrogaski@pobox.com>

LICENSE

Copyright (C) 2002 Mark Rogaski; all rights reserved.

See Log::Agent(3) or the README file included with the distribution for license information.

SEE ALSO

Mail::Mailer, Log::Agent::Driver(3), Log::Agent(3).