Skip to content

bleargh45/Log-Dispatch-Twilio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 ([email protected])

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