Circonus Integration

  combines multiple monitoring, alerting, event reporting, and analytical tools into one unified solution. Use any data, in any application, from any system, and visualize it in real-time. OpsGenie is an alert and notification management solution that is highly complementary to Circonus.

What does OpsGenie offer to Circonus users? 

Stay connected when you're mobile

Using OpsGenie, Circonus users can receive notifications for critical alerts via  SMS, phone calls, and iPhone & Android push notifications, and can respond to the alerts  directly from their mobile devices using OpsGenie apps.

Consolidated alert & notification management

Circonus users can leverage OpsGenie to aggregate and manage alerts not only from Circonus but also from other sources. OpsGenie enables users to maintain their own notifications information and preferences, eliminating the burden to keep this information current and accurate in multiple disparate tools.

 
Alert life cycle management

For Circonus users, OpsGenie integration provides full alert life cycle management capabilities. Using OpsGenie, users can not only receive notifications for critical problems detected by Circonus, but also acknowledge alerts, take or assign ownership of the alerts, comment on them, etc. rapidly no matter when and where they may receive the alerts. OpsGenie keeps track of all alert activity seamlessly: when the alert was created, who was notified when and how, whether and when recipients have seen the alert, acknowledged it, who executed which action, etc. OpsGenie can also automatically close alerts when host/service comes back up.

 
Alerts that empower

A short text message (SMS) typically used to notify users often fails to convey sufficient information to enable the recipients to assess the problem and determine the right course of action.  OpsGenie alerts are not limited to couple hundred characters of text, includes many fields, tags, and attached files. Recipients can not only see the alert message but all the supporting information, charts, etc. and figure out what to do next. You can attach any information that you think as relevant to the alert and make it available to the recipients, either via the API or the web UI.


Functionality of the integration

  • When Circonus triggers an alert, an alert is created in OpsGenie automatically through the integration.
  • When the alert condition is no longer valid, Circonus will make another HTTP POST request to OpsGenie and OpsGenie will close the alert automatically.
  • When the alert is acknowledged/unacknowledged by OpsGenie, alert is acknowledged/unacknowledged automatically in Circonus as well (optional).

Add Circonus integration to OpsGenie

Basic Configuration

OpsGenie Circonus integration provides sensible defaults. Basic configuration settings contain the minimum configuration information required to make the integration work. 

  1. Please create an OpsGenie account if you haven't done already
  2. Go to OpsGenie Circonus Integration page, 
  3. Specify who should be notified for the Circonus alerts using the "Recipients" field. User(s), group(s), escalations policies and on-call schedules can be specified as the alert recipients. Auto-complete suggestions will be provided as you type. 
  4. Click on "Save Integration"
  5. Copy the integration URL by clicking on the copy button or selecting. URL includes OpsGenie endpoint as well as the API key.

Advanced Configuration Settings

OpsGenie Circonus integration uses sensible configuration defaults to make the integration as easy as possible. However, it is also possible to customize the integration. Advanced settings allow:

  • defining different rules to notify different people for different alerts
  • modifying alert content using Circonus webhook payload

The following variables from Circonus alert webhook payload are available when defining filters and when setting the alert fields values:

  • Alert Type
  • Account Name
  • Severity
  • Metric Name
  • Check Name
  • Host
  • Agent
  • Alert Value
  • Alert Time
  • Clear Value
  • Clear Time
  • Alert Url
  • Metric Notes

You can create multiple rules with filters using the variables from Circonus webhook payload. For each rule, alert fields can have different values, hence different people can be notified, alerts can have different tags, etc.

​​

Acknowledging/Unacknowledging alerts in Circonus via OpsGenie

OpsGenie Circonus integration provides outgoing actions, too. If you choose to do that OpsGenie can acknowledge/unacknowledge alerts in Circonus.

  1. Click Send Alert Actions to Circonus. Available actions will be visible. Then you can choose the actions you'd like to send back to Circonus.
  2. Click on "Save Integration"

Configuring a webhook in Circonus

  1. Go to Menu next to Circonus logo.
  2. Click on Contact Groups.

  3. Click on NEW CONTACT GROUP +.
  4. Enter a name for your contact group.
  5. From Use Third Party drop-down menu choose OpsGenie.

  6. Copy the URL in the OpsGenie Circonus configuration page. Paste it to the OpsGenie API URL field.
  7. Copy the URL in the Webhook URL field. Paste it to the Circonus Webhook URL field in OpsGenie Circonus configuration page.
  8. Click Save.

  9. Then create a new Ruleset that will trigger an alert, and add your new OpsGenie Contact Group to that.

Sample payload sent from Circonus to OpsGenie

{
  "check_name": "54.214.23.46 http",
  "metric_link": null,
  "check_id": 81313,
  "alert_value": "212.0",
  "check_bundle_id": 60426,
  "alert_url": "https://circonus.com/account/opsgenie/fault-detection?alert_id=7438967",
  "host": "54.214.23.46",
  "metric_notes": "METRIC NOT",
  "alert_time": "Fri, 24 Jan 2014 18:17:37",
  "clear_time": "Fri, 24 Jan 2014 18:23:36",
  "metric_name": "duration",
  "clear_value": "220.0",
  "agent": "Ashburn, VA, US",
  "severity": "2",
  "alert_id": "7438967",
  "account_name": "opsgenie"
}

This payload is parsed by OpsGenie as:

{
  "check_name": "54.214.23.46 http",
  "alert_value": "212.0",
  "alert_url": "https://circonus.com/account/opsgenie/fault-detection?alert_id=7438967",
  "host": "54.214.23.46",
  "metric_notes": "METRIC NOT",
  "alert_time": "Fri, 24 Jan 2014 18:17:37",
  "clear_time": "Fri, 24 Jan 2014 18:23:36",
  "metric_name": "duration",
  "clear_value": "220.0",
  "agent": "Ashburn, VA, US",
  "severity": "2",
  "alert_id": "7438967",
  "account_name": "opsgenie"
}

Sample payload sent from OpsGenie to Circonus

Sample payload for Acknowledge action
{
    "source":{
        "name":"",
        "type":"web"
    },
    "alert":{
        "updatedAt":1420452224764002246,
        "tags": [
            "tag1", "tag2"
        ],
        "message":"test alert",
        "username":"fili@ifountain.com",
        "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c",
        "source":"fili@ifountain.com",
        "alias":"aliastest",
        "tinyId":"23",
        "createdAt":1420452191104,
        "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d",
        "entity":"",
        "alert_id":64657364
    },
    "action":"Acknowledge",
    "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d",
    "integrationName":"Integration1"
}
}
Sample payload for Unacknowledge action
{
    "source":{
        "name":"",
        "type":"web"
    },
    "alert":{
        "updatedAt":1420452224764002246,
        "tags": [
            "tag1", "tag2"
        ],
        "message":"test alert",
        "username":"fili@ifountain.com",
        "alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c",
        "source":"fili@ifountain.com",
        "alias":"aliastest",
        "tinyId":"23",
        "createdAt":1420452191104,
        "userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d",
        "entity":"",
        "alert_id":64657364
    },
    "action":"UnAcknowledge",
    "integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d",
    "integrationName":"Integration1"
}