Quantcast
Channel: OpsGenie Blog
Viewing all articles
Browse latest Browse all 204

OpsGenie Webhook Callbacks

$
0
0
<p>OpsGenie is fundamentally an alert router for operations teams. It receives alerts from operations management systems via email or API, and notifies the right people using the defined rules. OpsGenie also supports <a href="http://support.opsgenie.com/customer/portal/articles/1072547">"callbacks"</a>, and can forward alert activity to external systems via webhooks. Every time an alert is created, acknowledged, commented, closed or when an action is executed by a user, OpsGenie makes a web request to the URL specified in the webhook configuration. The web request includes subset of the alert data in the body of the request in JSON format. Passed data includes the alert messages, as well as the alertId and the alias fields that can be used to retrieve the rest of the alert data via the OpsGenie <a href="http://support.opsgenie.com/customer/portal/articles/1102275-alert-api">Alert API</a>. OpsGenie users can configure callbacks to be triggered for all alert data or can define matching rules to forward only a subset of alerts. Webhooks provide a very flexible way to export the alert data that is aggregated in OpsGenie, and are used in many different ways. Some example uses we&#8217;ve seen include:</p><ul><li>Passing user actions back to the monitoring systems where the alert originated. For example, some Nagios users enable alert recipients to acknowledge an alert in Nagios using OpsGenie apps, passing the user action via the webhook callback mechanism.</li><li>Passing alert activity to an IRC channel or to other chat systems, along with a link to the alert details page</li><li>Storing alerts as well as user actions as an archive</li><li>Annotating graphs to be able correlate metric data and alerts</li></ul><p><img alt="image" src="http://media.tumblr.com/e8cccffa908dca1ef798c10638851018/tumblr_inline_mu3gge6oHu1soq1dj.png"/></p><p><br/>To configure webhooks, go to the Callbacks section of the <a href="https://www.opsgenie.com/customer/settings">account settings</a> page, click on Webhooks tab, and specify a name for the webhook and the URL. <a href="http://requestb.in/">Request.bin</a> is a very useful free service to test and play with webhooks, that we use often when we&#8217;re integrating with other tools. Hope you have fun with it! :) <a href="http://twitter.com/berkay">@berkay</a></p>

Viewing all articles
Browse latest Browse all 204

Trending Articles