• Products
  • Get started
  • Documentation
  • Resources

Integrate Opsgenie with Magentrix

Megantrix logo

Overview

What does the integration offer?

Opsgenie provides a powerful bidirectional integration with Magentrix. Use the Magentrix integration to create an alert in Opsgenie when a case is created in the Customer Portal and vice versa. This mirroring helps to aggregate alerts to the right people at the right time with the robust on-call configurations and routing rules in Opsgenie.

How does the integration work?

  • When a case is created in Magentrix Customer Portal, an alert is created in Opsgenie.

  • When a case is closed in Magentrix Customer Portal, the alert is closed in Opsgenie.

  • When the case status is changed to “Active” in Magentrix Customer Portal, the alert is acknowledged in Opsgenie.

  • When an alert is created in Opsgenie, a case is created in Magentrix Customer Portal.

Set up the integration

Magentrix is a bidirectional integration. Setting it up involves the following steps:

  • Add a Magentrix integration in Opsgenie

  • Map alert actions

  • Configure the integration in Magentrix

Add a Magentrix integration

This integration is only available with Standard and Enterprise plans in Opsgenie, and Premium and Enterprise plans in Jira Service Management.

Adding the integration from your team dashboard will make your team the owner of the integration. This means Opsgenie will assign the alerts received through this integration to your team only. Follow the rest of the steps in this section to set up the integration.

To add a Magentrix integration in Opsgenie:

  1. Go to Settings > Integrations.

  2. Select Add integration.

  3. Run a search and select “Magentrix”.

  4. On the next screen, enter a name for the integration.

  5. Optional: Select a team in Assignee team if you want a specific team to receive alerts from the integration.

  6. Select Continue.
    The integration is saved at this point.

  7. Expand the Steps to configure the integration section and copy the API key.
    You will use this key while configuring the integration in Magentrix later.

  8. Select Turn on integration.
    The rules you create for the integration will work only if you turn on the integration.

Configure the integration in Magentrix

For incoming

1. In Magentrix, expand Develop on the left menu.

2. Select Classes & Triggers.

3. Select New.

4. Select Trigger > Next.

5. Select Case (Force) for the entity field and select Next.

6. Enter “OpsgenieAlertTrigger” for Name.

Magentrix provide class information

7. Select 3.0 for Version.

8. Select Save.

9. Copy the content of this file into the Magentrix UI editor.

10. Paste the API key you copied while adding the integration in Opsgenie into Opsgenie_API_KEY field.

11. Select Save.

For outgoing

  1. For Magentrix Subdomain, enter the subdomain of your Magentrix instance.
    For example, if your Magentrix URL is https://test.magentrixcloud.com, enter “test” into the field.

  2. For Magentrix Username, enter your Magentrix username.

  3. For Magentrix Password, enter your Magentrix user password.

Map alert actions

You can define action mappings between Opsgenie actions and Magentrix actions. You can also do the mappings for when the source of the alert is not Magentrix (that is, when the alert is created by another integration). You can select from a list of Opsgenie actions for the mapping.

If the case type is not specified, its value is set to "Problem" by default.

Configure Magentrix trigger for customized fields

To use the custom fields in Opsgenie alerts, customize the Magentrix trigger. In a trigger, there are 10 editable custom fields. These fields are defined but not initialized. You can send custom fields in the payload by completing the following steps:

  • Select custom fields by doing Magentrix initialization.
    The custom fields are already added to the payload. When you initialize fields, they are sent to Opsgenie.

  • To add custom fields to Opsgenie alert, expand the Incoming section and add alert rules as needed.

Sample payload sent from Magentrix

(in JSON format)

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 { "caseId": "5002600000DHQfbACH", "caseDescription": "Sample case description", "severity": "S3 - Medium", "caseNumber": "00314044", "description": "Sample description", "priority": "Medium", "subject": "[OpsGenie] Sample message", "caseType": "Problem", "ownerEmail": "sampleemail@sample.com", "caseStatus": "New", "accountName": "Sample Account", "assetName": "Sample Asset", "isEscalated": "TRUE", "escalatedBy": "0032600000dQcsPAAS", "customField1": "Sample Custom Field", "customField2": "Sample Custom Field", "customField3": "Sample Custom Field", "customField4": "Sample Custom Field", "customField5": "Sample Custom Field", "customField6": "Sample Custom Field", "customField7": "Sample Custom Field", "customField8": "Sample Custom Field", "customField9": "Sample Custom Field", "customField10": "Sample Custom Field" }

Additional Help