isabella232 / opsgenie-graylog-plugin

OpsGenie Graylog Alarm Callback Plugin

OpsGenie Graylog Integration Plugin

OpsGenie has a specific alert plugin for Graylog. Using this plugin, Graylog sends stream alerts to OpsGenie, with detailed information. OpsGenie acts as a dispatcher for Graylog alerts, determining the right people to notify based on on-call schedules, using email, text messages (SMS), phone calls and iPhone & Android push notifications, and escalating alerts until the alert is acknowledged or closed.

Installing the Plugin

• Download the plugin.
• Copy the .jar file into your plugins directory, as explained here.
• You should give read permission to the .jar file.
• Restart graylog-server.

Add API integration in OpsGenie

• Please create an OpsGenie account if you haven't done already
• Go to Graylog Integration page
• Specify the teams should be notified for Graylog alerts using the "Teams" field. Auto-complete suggestions will be provided as you type.
• Copy the integration API Key by clicking on the copy button or selecting. You'll be using this in the Graylog configuration.
• Click "Save Integration".

Configuration on Graylog

• In Graylog, Go to Alert page and click "Manage notifications".
• Click "Add new notification".
• Select your desired stream.
• Under notification type, select OpsGenie alarm callback and click "Add notification".
• Paste the API key you copied into "OpsGenie API Key" field. And paste the API URL into the "OpsGenie API URL" field. You can optionally specify Teams and Tags here also.
• Click Save.

Building the Plugin

This project is using Maven 3 and requires Java 7 or higher. The plugin will require Graylog 1.0.0 or higher.

• Clone this repository.
• Run mvn package to build a JAR file.
• Optional: Run mvn jdeb:jdeb and mvn rpm:rpm to create a DEB and RPM package respectively.
• Copy generated JAR file in target directory to your Graylog plugin directory.
• Restart the Graylog.