Demo video: Integrate Moogsoft Cloud and ServiceNow for bidirectional updates ►
This video explains how to configure a bidirectional integration between Moogsoft Cloud and ServiceNow.
After watching this video, you will be able to set up a bidirectional integration to send incidents from Moogsoft Cloud to ServiceNow, and accept updates from both systems. First we’ll conceptually trace the resulting workflow. Then, we’ll walk through the steps to install the integration.
This demo uses the San Diego version of ServiceNow, but the integration also works with the Rome and Quebec versions.
This is how the finished integration works. Suppose you receive an event in Moogsoft with a minor severity. It becomes an alert and then an incident.
Moogsoft forwards the incident in JSON format to ServiceNow using an outbound webhook. ServiceNow uses the provided URL to link back to the incident in Moogsoft.
Then, Moogsoft parses the webhook response from ServiceNow to generate a link to the ServiceNow incident in Moogsoft.
Here is the incident in Moogsoft…with the link to ServiceNow.
Here is the same incident in ServiceNow…with the link back to the incident in Moogsoft. Any additional data that arrives after the initial incident creation is also shared between the two systems.
So if a new event arrives and updates the severity and description in Moogsoft...
...the counterpart in ServiceNow is also updated.
Interaction with these incidents is synced bi-directionally. So you can work on the incidents from either system.
Now let’s see what’s involved in setting it up. You could provide all the functionality we’ve demonstrated by manually configuring an outbound webhook here to sync Moogsoft incidents with ServiceNow, but the Moogsoft ServiceNow integration provides a shortcut. This shortcut installs automation on the ServiceNow side, and the automation uses API calls to configure a webhook on the Moogsoft side.
We’ll follow that path. It has just a few steps.
The first step is to download a ServiceNow update set. The update set is an XML file which contains reusable ServiceNow customizations. We’ll get it from here.
Next, upload it to ServiceNow.
We’ll preview the update set…all set.
We can commit the update set, and the Moogsoft functionality is installed.
Next we want to affirm all the integration features that we want to include. Let’s change our scope to Moogsoft.
We’ll search here for Moogsoft and go to the properties page.
We need to provide authentication information here and make some decisions about the integration behavior. In this demo, we’ll be clicking yes in all of the checkboxes to accept the integration defaults.
Checking this box sets up an integration user in ServiceNow. This provides authenticated access from Moogsoft to ServiceNow.
Even though it looks like there is a password already here, you actually need to specify one for the integration to work.
We need to add the authentication information for our Moogsoft Cloud instance here to provide access from ServiceNow to Moogsoft.
We’ll go to our Moogsoft instance to define an API key.
For this demo we’re using a test api for the Moogsoft API URL, but you should keep the default value. We’ll paste our API key here, and keep the defaults for the other values.
This checkbox affirms that we want to create an outbound webhook in Moogsoft to send incidents to ServiceNow.
If we already had existing ServiceNow credentials stored in Moogsoft, we could uncheck this box…
…and fill in the credential set name here. Since we are having ServiceNow create an integration user for us, we’ll leave it blank.
This checkbox needs some explanation. You can set up your incident data payload in Moogsoft to send information about impacted CIs, or configuration items, to ServiceNow using a tag field. When an incident is updated, you probably only want to add new CIs to the incident, rather than replace the whole list each time. Checking this box enables that default behavior.
This checkbox affirms that we want bidirectional functionality.
This setting is separate from the Moogsoft integration user. It is the user that is automatically assigned in Moogsoft when an incident is resolved on the ServiceNow side.
This checkbox activates the maintenance window feature. This is an optional feature that lets you apply ServiceNow maintenance windows to alerts in Moogsoft.
You can learn more about the maintenance window feature in this video.
Finally, these last two sections let you adjust the mapping of Moogsoft severity to ServiceNow priority, impact, and urgency. We’ll keep the defaults for these.
Clicking ‘Save’ triggers the business rules that send API commands to Moogsoft to set up the integration. Let’s see what that looks like on the Moogsoft side. Here’s the new outbound webhook.
The integration automation has configured all the connection settings for us.
We are almost good to go, but there is one more set of adjustments to make. Here is an example data payload for ServiceNow, but we want to set up mappings to match our data.
You can read about the details of specifying your payload in Moogsoft’s outbound webhook docs here. You’ll need mappings that match your specific Moogsoft and ServiceNow configurations. The dollar-sign substitution syntax lets you match ServiceNow fields to Moogsoft fields. You can use the “type ahead” feature to see a list of fields for macro substitution. Our Moogsoft classes match ServiceNow categories in this example, so we’ll map them.
You can also map Moogsoft tag fields. We’ll map this tag to the ServiceNow assignment group.
Here’s our fully mapped data payload…
…and we’ve also adjusted the payload for incident updates.
Let’s make sure this is working. First let’s test. Looks good.
The integration will remain in provisioned status until the next incident is created and forwarded.
Here’s a new incident. Let’s resolve it in ServiceNow…
Done.
…and you can see the incident updated in Moogsoft.
Our installation is successful. Your own ServiceNow setup is likely to be more complex. For example, you can make copies of the outbound webhook…
…adjust them as needed, and then use filtering…
...to send different types of incidents to different teams.
And, watch these videos to learn more about leveraging ServiceNow maintenance windows in Moogsoft. Now you know how to install Moogsoft’s ServiceNow integration. Thanks for watching!