Welcome to the integration guide for xMatters Monitoring Tool X. This document explains how to install and configure a sample integration to demonstrate the process of building and managing integrations in xMatters On-Demand.
To begin, download and extract the MonitoringToolXIntegration.zip file attached to this article; there should be three files inside the package:
- Monitoring Tool X Plan.zip: an exported communication plan with a pre-configured integration
- Integration Script.txt: a pre-formatted HTTP POST request designed to trigger the integration
- README.txt: a brief explanation and pointer to this article
Use the steps below to install and test your integration, or watch the video walk-through available on the Integration Builder tab in your xMatters On-Demand trial instance.
Note: This demonstration uses Runscope’s free Hurl.it tool to send an HTTP request to xMatters and simulate the injection of an event from an external application. You can use your favorite HTTP POST tool instead, but you will need to adapt the steps accordingly.
Step One: Import communication plan
Log in to xMatters and navigate to the Developer tab. On the Manage Communication Plans page, click Import Plan and then click Choose File. Locate the Monitoring Tool X Plan.zip file within the extracted archive and then click Import Plan.
Step Two: Add recipient
On the Monitoring Tool X plan, click the Edit button and then select Forms. Click the Edit drop-down list for the New Incident form and select Layout. On the Layout tab, in the Recipients area, start typing your name in the field, and then select your device when it appears in the list (the integration will notify this device by default). Save your changes, and then click the Monitoring Tool X breadcrumb to return to the list of forms.
Step Three: Assign endpoint
Click the Integration Builder tab, and then click Edit Endpoints. In the xMatters endpoint, in the Assign Endpoint area, start typing your name in the field, and select your name when it appears in the list. Save your changes, and click Close. The integration will use your credentials to validate its API requests within xMatters.
Step Four: Configure the HTTP request
On the Integration Builder tab, expand the Inbound integrations list. Click the gear icon beside the Transform Monitoring Tool X Webhooks integration and select Integration URL. Copy the URL from the dialog box to the clipboard, and then close the dialog box.
Open Hurl.it in a new browser window and set the Destination type to POST. Paste the integration URL you retrieved in the previous step into the Destination field.
In xMatters, on the Integration Builder tab, click the Authentication OFF button. In the Authentication dialog box, click the Generate Password button. Copy the username and password from the Authentication dialog box into the appropriate fields in the Authentication section on the Hurl.it page.
On the Hurl.it page, add a new header with “Content-Type” and “application/json” values. In the Parameters section click the Add Body link. In the field, copy and paste the entire contents of the Integration Script.txt file that you extracted from the integration archive.
Step Five: Inject an event and view the results
To inject an event, click the Launch Request button on the Hurl.it page. You should receive an alert on the device you added to the recipients list on the form’s Layout tab.
Respond to the event on your device, and then navigate back to the Activity Stream in xMatters. You should be able to review the details of the event and confirm that the notification was successful.
Congratulations: your integration is working!