Metricly (Netuitive) Integration

Metricly (Formerly Netuitive) provides an adaptive monitoring and analytics platform for cloud infrastructure and web applications.

353

​What does Opsgenie offer Metricly users?

Opsgenie has a specific API integration with Metricly. Metricly sends alert notification messages to Opsgenie API with detailed information. Opsgenie acts as a dispatcher for these alerts, determines the right people to notify based on on-call schedules– notifies via email, text messages (SMS), phone calls, and iPhone & Android push notifications, and escalates alerts until the alert is acknowledged or closed.

Functionality of the integration

  • When an alert is created in Metricly, an alert is also created in Opsgenie automatically through the integration.
  • When a Metricly alert has images attached to it, those images are also attached to the Opsgenie alert.

Add Netuitive integration in Opsgenie

  1. Please create an Opsgenie account if you haven't done so already.
  2. Go to Opsgenie's Netuitive Integration page.

🚧

For Essentials plan, you can only add the integrations from the Team Dashboards, please use the alternative instructions given below to add this integration.

  1. Specify who is notified of Metricly alerts using the Teams field. Auto-complete suggestions are provided as you type.

📘

An alternative for Step 2) and Step 3) is to add the integration from the Team Dashboard of the team which will own the integration. To add an integration directly to a team, navigate to the Team Dashboard and open Integrations tab. Click Add Integration and select the integration that you would like to add.

  1. Copy the integration API Key to use in Metricly configuration.
  2. Click Save Integration.
1030

Configuration on Metricly

  1. In Metricly, go to Notifications page.
454
  1. Select "Opsgenie" tab.
1288
  1. Click "Add Opsgenie".
  2. Paste the API key copied previously into "API Key".
  3. If account is in the EU instance, please fill the API URL field with the URL given in the Integration configuration page.
  4. Click Save.
932
  1. Keep in mind that Opsgenie notifications need to be enabled from policy configuration.
698

Advanced Configuration Settings in Opsgenie

In order to attach images to an alert, enable "Append Attachment" field in Advanced Settings.

1946

Sample payload sent from Metricly

{
  "apiKey": "CUSTOMER_GENERATED_OPS_GENIE_API_KEY",
  "message": "CRITICAL, 'EC2 Utilization at 100%' fired for 'mon01-usw2a'",
  "alias": "d7be1059-ac53-4f36-8e4d-3678741ed131",
  "teams": [
    "team01",
    "team02"
  ],
  "recipients": [
    "recipient01",
    "recipient02",
    "[email protected]"
  ],
  "description": "a user defined description",
  "tags": [
    "tag01",
    "tag02",
    "tag03"
  ],
  "event": {
    "type": "EXTERNAL_INFO",
    "category": "CRITICAL",
    "elementFqn": "us-west-2:i-81d9718a",
    "elementName": "mon01-usw2a",
    "elementType": "EC2",
    "elementTags": {
      "tag02": "tag02Value",
      "tag01": "tag01Value"
    },
    "elementLocation": "location",
    "timestamp": "2015-03-26T18:05:10Z",
    "policy": {
      "name": "EC2 Utilization at 100%",
      "scope": {
        "elementName": "",
        "elementTags": {
          "tag01": "value01",
          "tag02": "value02"
        }
      },
      "conditions": [
        {
          "analytic": "actual",
          "metric": "Utilization",
          "operator": ">",
          "level": 99
        },
        {
          "analytic" : "analytics",
          "metric" : "metric",
          "operator" : "op",
          "level" : 9000
        }
      ]
    }
  },
  "eventLink": "https://uat.netuitive.com#/metrics?timeRangeDuration=14400&endTime=2017-06-19T21:09:05.230Z&event_id=6d840ad7-8ccb-4408-9f58-3caa5a56c5cd",
  "policyLink": "https://uat.netuitive.com#/policies/970f2e8e-1813-49f7-97df-7db8c6e1636d",
  "externalEvent": {
    "source": "ing.custom.event.source",
    "title": "ing.custom.event.title",
    "tags": [
      {
        "name": "ing-custom-event-tag",
        "value": "ing-custom-event-tag-value"
      }
    ],
    "data": {
      "level": "INFO",
      "message": "warning event on ing.custom.server"
    }
  },
  "images": [{
    "elementFqn": "rss-home",
    "metricFqn": "netuitive.linux.network.eth0.packets",
    "url": "https://s3.amazonaws.com/com-netuitive-uat-use1-images/6ca80d50-b141-4336-a88a-b4cc8fe18220/2017/06/19/21-09-04-image-e5f713c8-4a36-4168-adb2-f11c3919b485.png"
  }]
}
}

Sample alert

2437