xMatters
Last updated
Was this helpful?
Last updated
Was this helpful?
is an on-call management platform.
Integrating Cortex with xMatters allows you to:
Pull in on-call rotation data and escalation policies
The on-call user or team will appear in the Current On-call block on an entity's details page.
You can also view on-call information on an entity page in its side panel under Integrations > On-call.
Trigger xMatters incidents from Cortex
Create that track progress and drive alignment on projects involving your xMatters services
In Cortex, navigate to the :
In Cortex, click your avatar in the lower left corner, then click Settings.
Under "Integrations," click xMatters.
Click Add configuration.
Configure the xMatters integration form:
Username and Password: Enter your xMatters username and password.
Organization slug: Enter the organization slug for your xMatters instance.
This can be found in the URL for your instance (e.g., https://.xmatters.com
)
Click Save.
If you’ve set everything up correctly, you’ll see the option to Remove Integration in settings.
You can also use the Test configuration button to confirm that the configuration was successful. If your configuration is valid, you’ll see a banner that says “Configuration is valid. If you see issues, please see documentation or reach out to Cortex support.”
While viewing an entity in Cortex, you can trigger an incident in xMatters:
In Cortex, navigate to an entity. On the left side of an entity details page, click On-call & incidents.
In the upper right side of the entity's "On-call" page, click Trigger incident.
Configure the incident modal:
Summary: Enter a title for the incident.
Description: Enter a description of the incident.
Severity: Select a severity level.
At the bottom of the modal, click Trigger incident.
A confirmation screen will appear. In the confirmation, click the link to view the incident in xMatters.
If your xMatters group don’t cleanly match the Cortex entity tag, you can override this in the Cortex entity descriptor.
id
Name of the group in xMatters
✓
type
SERVICE
✓
You can find more detailed information from the xMatters integration in the entity sidebar under On-call & incidents > xMatters.
The schedule associated with a given entity will be hyperlinked in the Escalation Policy block and the group will be hyperlinked in the Service block.
Under the Escalations section, you'll find each level associated with the policy. Owners assigned to each level will also be hyperlinked to the user or team's on-call page in xMatters.
With the xMatters integration, you can create Scorecard rules and write CQL queries based on xMatters services.
The following options are available to get assistance from the Cortex Customer Engineering team:
Chat: Available in the Resource Center
Slack: Users with a connected Slack channel will have a workflow added to their account. From here, you can either @CortexTechnicalSupport or add a :ticket:
reaction to a question in Slack, and the team will respond directly.
Don’t have a Slack channel? Talk with your Customer Success Manager.
By default, Cortex will use the (e.g. my-entity
) as the "best guess" for xMatters group. For example, if your entity tag is my-entity
, then the corresponding group in xMatters should also be my-entity
.
Once the integration with xMatters is configured, you'll be able to find the user or team on call in the Current On-call block on an .
See more examples in the in Cortex.
Email: , or open a support ticket in the in app Resource Center