Boundary Integration v1.0

 

Contents

Introduction

Configure xMatters

Install and configure the integration

Test the integration

Troubleshooting

Download resources

The information in this article is the intellectual property of xMatters and is intended only for use with xMatters products by xMatters customers and their employees. Further, this intellectual property is proprietary and must not be reused or resold.

Introduction

This article provides installation, configuration, and implementation details for the xMatters integration with Boundary.

The integration to Boundary:

  • Leverages built in Actions
  • Can be associated with any trigger
  • Relevant details about the alarm are sent to xMatters for easy display in notifications 

Integration created and supplied by Travis DePuy

Configure xMatters

Before configuring anything in Boundary, you need to configure xMatters first.

Create an integration user

The first step in configuring xMatters is to create a user to authenticate REST web service calls when injecting events.

This user needs to be able to work with events, but not update administrative settings. The best way to create a user for this integration is to have a dedicated "REST Web Service User" role that includes the permissions and capabilities. If this role does not exist in your deployment, you will need to create it, or ask xMatters Customer Support to create it for you.

In the following example, this role is named "REST Web Service User".

To create an integration user:

  1. Log in to the target xMatters system.
  2. On the Users tab, click the Add New User icon.
  3. Enter the appropriate information for your new user.
  4. Assign the user to the REST Web Service User role.
  5. Click Save.
  6. On the next page, set the web login ID and password. 
    • Make a note of these details; you will need them when configuring the Boundary side of the integration.

Create users and groups that will receive notifications

Recipients to the Boundary alarms are set in the action when it is created in Boundary. See below for details. 

You can create multiple groups and users at once using the EPIC feature. 

Import the workflow

The next step is to import the Boundary workflow.

To import the workflow:

  1. Download the attached .zip file to your system.
  2. Browse to the .zip file, or drag it onto the Import Workflow dialog box.
  3. Click Import Workflow.
    • Once the import is finished, the workflow should be automatically enabled. If it isn't, click the Disabled toggle to enable it.
  4. Click the gear icon beside the workflow, and select Editor Permissions.
  5. Add the integration user, and then click Save.
  6. Click the workflow name to open the Forms tab.
  7. For the CPU Action form, in the Web Service Only dropdown, click Sender Permissions.
  8. Enter the integration user, and then click Save Changes.
  9. Repeat steps 7-8 for the Memory Action form.
  10. To get the web service URL for a form, in the Web Service Only drop-down list, click Access Web Service URL. Copy the highlighted URL at the top of the dialog box.
    • You need these URLs when you configure the Boundary action.

Install and configure the integration

Now that you've configured xMatters, it's time to configure Boundary.  

Configure Boundary

The xMatters action has already been enabled in Boundary.

To set up the action:

  1. Click Settings > Actions and locate the xMatters action:

  1. Click Add to display the Action settings:

  1. Enter the information in the fields as explained in the following table:
Field Name Field Description
Name Name of the action; this should be the same as the form name in xMatters. 
Endpoint URL The xMatters endpoint. This is the URL copied from the form when you imported the workflow. 
Username The username of the integration user used to authenticate into xMatters. 
Password The password for the integration user. 
Target Group or User The xMatters Group or User this action should target. Note that if you are using a subscription, this is not required. 
Priority Determines the message send priority.

 

  1. Click Save.

Test the integration

You can test the integration by sending a notification email from within Boundary.

To test the integration:

Create a new Alarm or open an existing Alarm. Add the newly created Action (CPU Action for example) to the Actions section of the Alarm. Then trigger this alarm. A new event should be created in xMatters. 

Troubleshooting

First, add an email Action to the alarm. Was the email received? If so, check xMatters to see if the event was created there. If not, verify the conditions of the Alarm to make sure it is actually being triggered. 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk