NAME

Log::Dispatch::Twilio - Log output via Twilio SMS Message

SYNOPSIS

use Log::Dispatch;

my $logger = Log::Dispatch->new(
    outputs => [
        [ 'Twilio',
          min_level   => 'emergency',
          account_sid => '<your-twilio-account-sid>',
          auth_token  => '<your-twilio-auth-token>',
          from        => '<number-to-send-msg-from>',
          to          => '<number-to-send-msg-to>',
        ],
    ],
);

DESCRIPTION

This module provides a Log::Dispatch output that sends log messages via Twilio.

While you probably don't want every logged message from your application to go out via Twilio, I find it particularly useful to set it up as part of my Log::Dispatch configuration for critical/emergency errors. In the event that something dire happens, I'll receive an SMS message through Twilio right away.

Required Options

When adding Twilio output to your Log::Dispatch configuration, the following options are required:

• account_sid

  Your Twilio "Account Sid".

• auth_token

  Your Twilio "Auth Token".

• from

  The telephone number from which the SMS messages will appear to be sent from.

  This number must be a number attached to your Twilio account.

• to

  The telephone number to which the SMS messages will be sent to.

Additional Options

• max_messages (default 1)

  Maximum number of SMS messages that can be generated from a single logged item. Defaults to 1.

METHODS

• new

  Constructor.

  Implemented as per the Log::Dispatch::Output interface.

• log_message

  Logs message, by sending it as an SMS message to the configured number via the Twilio API.

  Implemented as per the Log::Dispatch::Output interface.

AUTHOR

Graham TerMarsch (cpan@howlingfrog.com)

COPYRIGHT

Copyright (C) 2012, Graham TerMarsch. All Rights Reserved.

This is free software, you can redistribute it and/or modify it under the Artistic-2.0 license.

SEE ALSO

Log::Dispatch, http://www.twilio.com/.