Page tree
Skip to end of metadata
Go to start of metadata

You can install an xMatters integration to enable bidirectional communication between Moogsoft AIOps and xMatters. The integration allows you to send notifications to users and groups in xMatters about alerts, invitations and Situations. You can close Situations to close associated events in xMatters. See xMatters Workflow.

You can also comment on xMatters events for them to appear on associated Situation Room comment threads in Moogsoft AIOps. See the xMatters documentation for more information.

Before You Begin

The xMatters integration has been validated with xMatters v. 5.5. Before you set up your integration:

  1. Create an xMatters user with administrator privileges.
  2. Create an xMatters API user with the REST Web Service User role.
  3. Create users in xMatters with the same names as the users in Moogsoft AIOps.
  4. Set up groups in xMatters with the same names as the teams in Moogsoft AIOps.
  5. Download the Moogsoft AIOps-xMatters Communication Plan.
  6. Go to Communication Plans and import the xMatters-AIOps Communication Plan zip file. After you import the plan, it is enabled.
  7. Click Edit and select Integration Builder from the drop-down list.
  8. Edit the Inbound Integrations and enable Engage Group, Engage User and Engage Group (Alert Based).
  9. Click each setting and set the authentication method to 'Basic Authentication'.
  10. Note down the URL under 'How to trigger the integration' for Engage Group, Engage User and Engage Group (Alert Based).

Configure the Integration

Configure the xMatters integration in Moogsoft AIOps as follows:

  1. Navigate to the Integrations tab.
  2. Click xMatters in the Collaboration section.
  3. Follow the instructions to create an integration name and supply connection information for xMatters.

If you enable Automatically Engage Team, a Situation posted to the team sends a notification to the xMatters group with the same name. The Moogsoft AIOps team name must match the xMatters group name in order for this to work.

Configure xMatters

To configure xMatters, follow the steps below:

  1. Go to Communication Plans
  2. Click Edit and select Access Permissions and add the xMatters API user created above.
  3. Click Edit and select Forms, for each entry click Web Service - Sender Permissions and add the xMatters API user.
  4. Edit the Communication Plan and select Integration Builder from the drop-down list.
  5. Assign the xMatters endpoint to the xMatters API user associated with the communication plan.
  6. Create a new Endpoint using the following fields:

    FieldValue
    NameMoogsoftAIOps
    Trust self-signed certificatesSet as appropriate.
    Base URL
    <your xMatters integration URL>
    AuthenticationBasic
    Username

    Username of Graze user selected above. Default is 'Graze API User'.

    PasswordPassword of Graze user selected above.
    PreemptiveTrue
  7. Save the changes.

After you complete the xMatters configuration, Moogsoft AIOps notifications from xMatters about invitations, alerts and associated Situations.

  • No labels

6 Comments

  1. Style issue - single quotes or bold? Our style page says to use bold for UI elements.

  2. Just 'Configure' (it isn't optional)

  3. Moogsoft AIOPs receives

  4. For the documentation website we have not been reproducing the UI. We usually provide instruction on how to get to the configuration screen and all the fields you mention there are actually in the UI. See Pingdom & Service now for examples.