Configuring Native NS1 Datafeeds

In situations where our integrations into third party monitoring solutions are not sufficient, NS1 offers an option to connect a webhook URL to a datafeed which will allow for remote systems to programmatically fail out an answer or answers.

Create an NS1 datafeed

Navigate to the Integrations tab, then select the Services tab, and click on the NS1 API icon.

Next, click Create an Incoming Datafeed and give this new feed a name and a label. Note the label name as it will be used later in the http POST data that will be used to change the state of the answer.

Once created also note the associated Feed URL. This will be the endpoint which will parse incoming http POST data.

Connect the feed to an answer

Navigate to the record which this data feed will connect to and add a filter chain with the UP filter. Then click on the UP filter in the filter chain on the left, this will expand the metadata options for the filter. Select the plug icon next to the answer this new data feed will control and then navigate to Third Party Integrations and select the data feed created in the step above.

Construct and test the feed response

Once connected you will be able to test this datafeed and see how it reacts to incoming requests. The datafeeds are receptive to http POST type data to inform them to either mark the UP metadata as either ‘true’ (or 1) and ‘false’ (or 0). The POST data should also contain the label as chosen earlier. Here is an example curl command to mark the datafeed in this example as ‘false’:

curl -X POST -H "X-NSONE-Key: REMOVED" -d '{"Feed01":{"up":false}}' https://api.nsone.net/v1/feed/c304222af55edc2a8fde27b10350fd59

Using this format users can create custom scripts running on remote machines that are able to control the UP or DOWN status of an answer based on their own internal criteria.