NS1's integration with Rackspace cloud monitoring allows you to add Rackspace as an incoming data source within the NS1 platform, and then connect the data source to NS1 DNS answers associated with the monitored endpoints. When the Rackspace monitor detects changes in the monitored endpoint, it communicates this to the NS1 platform which automatically updates the associated answer metadata. Refer to Understanding NS1 data sources & feeds for more information.
Follow the instructions below to implement the Rackspace integration.
To begin, you must create a Rackspace entity, and then configure a check and alarm for that entity.
Log into your Rackspace account, and navigate to the Monitoring page, and then click Create Entity.
Refer to the Rackspace documentation for more information on creating and managing entities.
Complete the form fields and save your changes, recording the entity ID for the new entity.
Record the entity ID. You'll need this later in the implementation process.
On the Monitoring page, click the entity you just created. Under Monitoring Checks, click Create Check.
Select the check type, and enter a name for the check.
There are two types of checks you can create: agent or remote. To monitor CPU or load-related metrics, you must create an agent check. For up/down status checks, create a remote check. Refer to this article for details.
Select the Create Alarm option, setting the desired thresholds.
Click Create Check and Alarm.
Follow the instructions below in the NS1 portal to add Rackspace as an incoming data source, and then create a new data feed from the data source. Refer to Understanding NS1 data sources & feeds for details.
Log into the NS1 portal, and navigate to the Integrations page from the main navigation.
Click the + icon in the upper right corner to create a new data source.
Enter a name for the data source (for internal reference only), and then enter the X-Rackspace-Webhook-Token from your Rackspace Account Settings. The NS1 platform uses this token to validate incoming notifications. Optionally, you can leave this field empty in which case the NS1 platform will not validate incoming notifications. Refer to the Rackspace developer documentation for instructions on how to view the webhook token via API.
Click Create Data Source.
Click Create a new feed with this data source? to create a data feed associated with the new Rackspace data source.
You can configure multiple data feeds from the Rackspace data source — each feed pointing to a different entity.
Enter a name for the data feed (e.g., something specific to the entity being monitored), and then enter the check ID, alarm ID, and entity ID for the Rackspace entity you created earlier.
Optionally, you can leave the check ID and alarm ID fields empty, adding this information later to validate your incoming checks and alarms.
Click Submit. The new data source and feed appear in the list under Incoming Feeds.
Scroll down to the Rackspace data source in the list, and record the Feeds URL. You'll need this in the next step.
In the Rackspace Intelligence portal, navigate to the Notifications tab and click Create Notification.
Enter a name for the notification, and then set the type to "webhook."
Enter the NS1 Feed URL associated with the Rackspace data source you created in the previous step (i.e., under Integrations > Incoming Feeds in the NS1 portal).
Click Save Notification. The notification appears in the list.
Navigate to the Notification Plans tab, and then click Create Notification Plan.
Enter a name for the notification plan (e.g., NS1 notification plan) and click Create Notification Plan.
Within the notification plan details page, click Add Notifications.
Select the NS1 webhook you just created from the list, and then click Save Notification Plan.
Navigate to the Entities tab, select the relevant entity from the list, and then select a relevant check.
Under Monitoring Alarms, click the gear icon next to the relevant alarm and select Edit Notification Plan from the list.
In the Edit Alarm Notification Plan screen, click the drop-down menu next to Notification Plan, and then select the NS1 notification plan you just created. (Email will be the default.)
To complete the configuration, apply the Rackspace data feed to a DNS answer in the NS1 platfom. You will do this by editing the relevant answer's metadata — associating the data feed with specific answer metadata field(s) to enable automatic updates.
You can create multiple data feeds from the Rackspace data source — each feed associated with a different Rackspace entity ID.
In the NS1 portal, navigate to the DNS page from the main navigation.
Click the name of the zone to view zone details, and then click the name of the record containing the relevant DNS answer.
From the list of answers, click the menu icon to the right of the answer and click Edit Answer Metadata.
Navigate to the metadata field to which you'd like to attach the Rackspace data feed. Click the "feed" icon to the right of the metadata field to view a list of available monitors and incoming data feeds.
Select the Rackspace data feed from the list, and then click Ok.
Now, when the Rackspace monitor detects changes in the status of the monitored entity, it notifies the NS1 platform, automatically updating the DNS answer metadata.
If you haven't already, you can create a Filter Chain within the DNS record to define the query processing logic. A Filter Chain can contain one or more filters, and processing each DNS query based on the order of filters in the configuration. Each filter references the value of the relevant answer metadata field (e.g., the "Up" filter references the "Up" metadata field).