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/.

