AppDynamics OpsGenie Alerting Integration

##Use Case

OpsGenie is a notification/alerting system that helps you configure how and when your alerts are being delivered.

With this extension you can forward alerts triggered via an AppDynamics 3.6/3.7 event or policy violation to the OpsGenie system for further delivery to the individual recipients.

This extension is configured as a custom action on the AppDynamics controller (see Installation).

##Installation

1. Deploy into Controller directory

   1.1 Either download the OpsGenieAlertingExtension.zip file from AppSphere or type "ant package" (without the quotes) in the root directory of the cloned repository and find the zip file in the 'dist' directory.

   1.2 Copy the zip file into the <Controller-install-dir> directory. Unzip the file. You will see a prompt if you already have a custom.xml in the <Controller-install-dir>/custom/actions/ directory, don't let the unzip process overwrite it. Instead, merge the contents.

2. cd into <Controller-install-dir>/custom/opsgenie/lib and edit the config.properties configuration file:

   ###Parameters #Customer key for the OpsGenie authentication customer-key=<customer-key>

   Comma separated list of emails to receive the alerts

   recipient-list=dbershadsky@appdynamics.com

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

##Debugging

To debug the code:

1. Modify the custom\actions\opsgenie\conf\log4j.xml config file and enable debug level logs.

   <logger name="com.appdynamics" additivity="false">
   	<level value="debug"/>
   

2. Open <custom_action_directory>/logs/opsGenie.log

##Testing

If you'd like to send a test alert for Debug purpose please use the opsGenieSendSampleAlert.sh script. This Script will send a simple alert using the Action Configuration. You can use this to verify that the transmission works and the alert would be received without the need of producing a real error or event.

##Using the jar file as a standalone

The jar file can be used as a standalone. For information enter "--help" when running the jar:

~~~~
java -jar opsGenie.jar --help
~~~~

##Contributing

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

##Community

Find out more in the AppSphere community.

##Support

For any questions or feature request, please contact AppDynamics Center of Excellence.