XMatters Integration - Revision history

Qadmin: /* Step 4 - Apply Changes and Test */

2022-03-16T03:59:24Z

Step 4 - Apply Changes and Test

← Older revision		Revision as of 03:59, 16 March 2022
Line 35:		Line 35:
	Apply your changes then use the "Generate Test Alert" button to generate a test alert to verify everything is configured correctly and alerts are making it into xmatters. Note that "INFO" level alerts are not sent to the ITSM modules so be sure to generate a "WARNING" or "ERROR" level alert for testing.		Apply your changes then use the "Generate Test Alert" button to generate a test alert to verify everything is configured correctly and alerts are making it into xmatters. Note that "INFO" level alerts are not sent to the ITSM modules so be sure to generate a "WARNING" or "ERROR" level alert for testing.

	To view your test alerts in xmatters login to your account and navigate to the '''~~Incidents~~''' section.		To view your test alerts in xmatters login to your account and navigate to the '''Alerts''' section via the bell icon in the upper right of the xmatters web page (not the Incidents section).

Qadmin: /* Step 3 - Add the Webhook URL to QuantaStor */

2022-03-16T03:57:58Z

Step 3 - Add the Webhook URL to QuantaStor

← Older revision		Revision as of 03:57, 16 March 2022
Line 29:		Line 29:
	== Step 3 - Add the Webhook URL to QuantaStor ==		== Step 3 - Add the Webhook URL to QuantaStor ==

	Login to your QuantaStor storage grid and then select "Alert Manager" from the toolbar to bring up the dialog for adding more alert endpoints. On the second page select "xmatters" from the dropdown list of ITSM integrations and then input the URL endpoint you assembled in ~~the previous step~~.		Login to your QuantaStor storage grid and then select "Alert Manager" from the toolbar to bring up the dialog for adding more alert endpoints. On the second page select "xmatters" from the dropdown list of ITSM integrations and then input the URL endpoint you assembled in Step 2.

	== Step 4 - Apply Changes and Test ==		== Step 4 - Apply Changes and Test ==

Qadmin: /* Step 3 - Edit the Workflow to Create Alert */

2022-03-16T03:57:23Z

Step 3 - Edit the Workflow to Create Alert

← Older revision		Revision as of 03:57, 16 March 2022
Line 24:		Line 24:

	xmatters requires an extra step to connect the webhook from the previous step to the action of creating a new Alert. To do this you need to go into the '''Flow Designer''' then go to the '''TOOLS''' section and add a '''Create Alert''' step to the Workflow by clicking and dragging it onto the canvas. After that connect the '''Webhook''' step to the '''Create Alert''' step and then '''Save''' the workflow.		xmatters requires an extra step to connect the webhook from the previous step to the action of creating a new Alert. To do this you need to go into the '''Flow Designer''' then go to the '''TOOLS''' section and add a '''Create Alert''' step to the Workflow by clicking and dragging it onto the canvas. After that connect the '''Webhook''' step to the '''Create Alert''' step and then '''Save''' the workflow.
	[[File:xmatters_flowdesigner.png\|~~800px~~]]
			[[File:xmatters_flowdesigner.png\|600px]]

	== Step 3 - Add the Webhook URL to QuantaStor ==		== Step 3 - Add the Webhook URL to QuantaStor ==

Qadmin: /* Step 1 - Add a Workflow */

2022-03-16T03:55:18Z

Step 1 - Add a Workflow

← Older revision		Revision as of 03:55, 16 March 2022
Line 10:		Line 10:

	You'll need to add a name and a description and you must add at least one user to the '''Add the recipients to notify:''' section or else it will not allow you to save the workflow.		You'll need to add a name and a description and you must add at least one user to the '''Add the recipients to notify:''' section or else it will not allow you to save the workflow.

			[[File:xmatters_webhook.png\|800px]]

	== Step 2 - Copy Inbound Webhook Configuration URL ==		== Step 2 - Copy Inbound Webhook Configuration URL ==

Qadmin: /* Step 3 - Edit the Workflow to Create Alert */

2022-03-16T03:54:42Z

Step 3 - Edit the Workflow to Create Alert

← Older revision		Revision as of 03:54, 16 March 2022
Line 22:		Line 22:

	xmatters requires an extra step to connect the webhook from the previous step to the action of creating a new Alert. To do this you need to go into the '''Flow Designer''' then go to the '''TOOLS''' section and add a '''Create Alert''' step to the Workflow by clicking and dragging it onto the canvas. After that connect the '''Webhook''' step to the '''Create Alert''' step and then '''Save''' the workflow.		xmatters requires an extra step to connect the webhook from the previous step to the action of creating a new Alert. To do this you need to go into the '''Flow Designer''' then go to the '''TOOLS''' section and add a '''Create Alert''' step to the Workflow by clicking and dragging it onto the canvas. After that connect the '''Webhook''' step to the '''Create Alert''' step and then '''Save''' the workflow.
			[[File:xmatters_flowdesigner.png\|800px]]

	== Step 3 - Add the Webhook URL to QuantaStor ==		== Step 3 - Add the Webhook URL to QuantaStor ==

Qadmin: /* Step 2 - Copy Inbound Webhook Configuration URL */

2022-03-16T03:53:49Z

Step 2 - Copy Inbound Webhook Configuration URL

← Older revision		Revision as of 03:53, 16 March 2022
Line 18:		Line 18:
	https://osnexus.xmatters.com/api/integration/1/functions/3cdf6008-ee40-43e2-a469-b7d73021331e/triggers?apiKey=3963e25e-fb92-4a73-9e81-a4b643e62aaa		https://osnexus.xmatters.com/api/integration/1/functions/3cdf6008-ee40-43e2-a469-b7d73021331e/triggers?apiKey=3963e25e-fb92-4a73-9e81-a4b643e62aaa
	</pre>		</pre>

			== Step 3 - Edit the Workflow to Create Alert ==

			xmatters requires an extra step to connect the webhook from the previous step to the action of creating a new Alert. To do this you need to go into the '''Flow Designer''' then go to the '''TOOLS''' section and add a '''Create Alert''' step to the Workflow by clicking and dragging it onto the canvas. After that connect the '''Webhook''' step to the '''Create Alert''' step and then '''Save''' the workflow.

	== Step 3 - Add the Webhook URL to QuantaStor ==		== Step 3 - Add the Webhook URL to QuantaStor ==

Qadmin: Created page with "Category:integration_guide xmatters is a cloud based ITSM (IT Service Management) system for IT organizations to manage their support process and ticketing. QuantaStor i..."

2022-03-16T03:48:45Z

Created page with "Category:integration_guide xmatters is a cloud based ITSM (IT Service Management) system for IT organizations to manage their support process and ticketing. QuantaStor i..."

New page

[[Category:integration_guide]]

xmatters is a cloud based ITSM (IT Service Management) system for IT organizations to manage their support process and ticketing. QuantaStor integrates with xmatters via a webhook URL that gets tied into one of your workflows. Once the webhook URL is generated for ingesting alerts it needs to be added to the QuantaStor Alert Manager screen as a new Alert Endpoint.

== Step 1 - Add a Workflow ==

Login to your xmatters account then navigate to:

'''Workflows''' -> '''WORKFLOWS''' -> '''Workflow Templates''' -> '''Webhook'''

You'll need to add a name and a description and you must add at least one user to the '''Add the recipients to notify:''' section or else it will not allow you to save the workflow.

== Step 2 - Copy Inbound Webhook Configuration URL ==

Once you save the workflow from the previous step it will present you with a new section '''Inbound Webhook Configuration''' with a URL, press the '''Copy''' button to copy the URL to the clipboard, it will look like this:

<pre>
https://osnexus.xmatters.com/api/integration/1/functions/3cdf6008-ee40-43e2-a469-b7d73021331e/triggers?apiKey=3963e25e-fb92-4a73-9e81-a4b643e62aaa
</pre>

== Step 3 - Add the Webhook URL to QuantaStor ==

Login to your QuantaStor storage grid and then select "Alert Manager" from the toolbar to bring up the dialog for adding more alert endpoints. On the second page select "xmatters" from the dropdown list of ITSM integrations and then input the URL endpoint you assembled in the previous step.

== Step 4 - Apply Changes and Test ==

Apply your changes then use the "Generate Test Alert" button to generate a test alert to verify everything is configured correctly and alerts are making it into xmatters. Note that "INFO" level alerts are not sent to the ITSM modules so be sure to generate a "WARNING" or "ERROR" level alert for testing.

To view your test alerts in xmatters login to your account and navigate to the '''Incidents''' section.