NS1 Status

Articles in this section

Creating a custom webhook notifier

  • Updated
Follow

If NS1 does not yet integrate with your chosen notification service, you might be able to utilize the Webhook Notifier option to set up a connection.

Note: Currently, NS1 customers can configure notifiers with Slack, PagerDuty, and HipChat.

Using the generic webhook notified, you can choose an external URL to which POST data is sent (in the event of a status change for a monitor). The data sent in these POST requests use JSON format.

If you are unfamiliar with configuring monitoring jobs, step-by-step instructions can be found here:

For example, a "PING monitor down" POST might look like:

{
  "state": "down",
  "since": 1444744828,
  "region": "global",
  "job": {
    "notes": null,
    "name": "ping2",
    "notify_repeat": 0,
    "id": "561d0d482db1564c88776b57",
    "region_scope": "fixed",
    "rapid_recheck": false,
    "frequency": 60,
    "job_type": "ping",
    "notify_delay": 0,
    "notify_list": "560d7d249f782d4d663d7d3d",
    "notify_regional": false,
    "regions": [
      "lga"
    ],
    "policy": "quorum",
    "config": {
      "timeout": 2000,
      "host": "1.1.1.1",
      "count": 4
    },
    "status": {
      "global": {
        "since": 1444744580,
        "status": "up"
      },
      "lga": {
        "since": 1444744580,
        "status": "up"
      }
    },
    "notify_failback": true,
    "rules": [],
    "active": true
  }
}

For example, a "PING monitor up" POST might look like:

{
  "state": "up",
  "since": 1444745000,
  "region": "global",
  "job": {
    "notes": null,
    "name": "ping2",
    "notify_repeat": 0,
    "id": "561d0d482db1564c88776b57",
    "region_scope": "fixed",
    "rapid_recheck": false,
    "frequency": 60,
    "job_type": "ping",
    "notify_delay": 0,
    "notify_list": "560d7d249f782d4d663d7d3d",
    "notify_regional": false,
    "regions": [
      "lga"
    ],
    "policy": "quorum",
    "config": {
      "timeout": 2000,
      "host": "8.8.4.4",
      "count": 4
    },
    "status": {
      "global": {
        "since": 1444744828,
        "status": "down"
      },
      "lga": {
        "since": 1444744828,
        "status": "down"
      }
    },
    "notify_failback": true,
    "rules": [],
    "active": true
  }
}

Related articles