Twitter - Alerting Extension

Twitter Alerting Extension

 

Use Case

 

The Twitter alerting extension enables AppDynamics to post custom notifications as tweets on Twitter. Twitter followers can see a brief description of the health rule violation or event and get more detail on AppDynamics by following the URL provided in the tweet.

 

Installation

 

Prerequisites

 

  • You have a Twitter account.
  • You have set the account type to "protected". How to protect your tweets
  • You have added and approved followers to the Twitter account.
  • You have created a Twitter app on dev.twitter.com/apps and have the consumer key and secret for the application. (Consumer key and secret can be found under application details.)

 

Steps

 

  1. Download the TwitterAlert zip file into the <controller install dir> directory.
  2. Unzip the file. You will see a prompt if you already have a custom.xml file in the /custom/actions/ directory. Don't let the unzip process overwrite it. Instead, merge the contents.
  3. Copy the consumer key and secret from your Twitter application detail page and paste them in custom/actions/update-twitter-status/consumer.conf.
  4. cd into /custom/actions/authenticate-twitter-extension and run auth.sh (On Windows systems, run auth.bat).
  5. Follow the URL shown in the command line and authorize the app.
  6. Enter the PIN shown on the page in the command prompt.

 

Now you are ready to use this extension as a custom action. In the AppDynamics UI, go to Alert & Respond -> Actions. Click Create Action. Select Custom Action and click OK. In the drop-down menu you can find the action called 'update-twitter-status'.

 

Note: Twitter has a posting limit of 1000 tweets per day and about 15 tweets in a burst; any tweets that exceed this limit will be ignored. Therefore, this extension should not be used for any frequently occurring events or notifications.

 

Contributing

Always feel free to fork and contribute any changes directly via GitHub.

 

Support

For any support questions, please contact ace@appdynamics.com.

 

Version:

1.1

Last Update:

12/17/2013

 

Note: This extension works only with a dedicated SaaS controller or an on-prem controller. Alerting extensions, currently do not support multi-tenant SaaS controllers. 

 

 Release Notes:

 

1.1: Twitter's URL shortening does not work with localhost or private IPs. This version fixes that by using tinyurl's URL shortener.

Attachments: