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.
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: Configure the HTTP request
On the Integration Builder tab, expand the Inbound integrations list. Click Transform Monitoring Tool X Webhooks to open the integration's configuration screen.
In Step 4, select the API Key authentication method, and then click Update Inbound Integration:
At the bottom of the screen, under How to trigger this integration, click Copy URL:
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:
Copy and paste the API key and secret from Step 4 of the integration configuration screen in xMatters into the username and password fields for Basic authentication 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 Four: 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 for your integration 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!