Send data to ServiceNow

Most recent version: v1.0.0

See the changelog of the ServiceNow Data sink type here.

Overview

Onum supports integration with ServiceNow.

ServiceNow is a cloud platform that offers an array of services and applications designed for IT and workflow management. Incidence integration allows Onum to create an instance in ServiceNow when a problem has been detected or to create alerts and possible incidents.

Prerequisites

To use the ServiceNow Data sink, you must first create a personal developer instance. ServiceNow offers free Personal Developer Instances, which you can use to test incidents.

Onum Setup

1

Log in to your Onum tenant and click Data Sinks> New Data sink.

2

Double-click the ServiceNow Sink.

3

Enter a Name for the new Data Sink. Optionally, add a Description and some Tags to identify the Sink.

4

Decide whether or not to include this Data sink info in the metrics and graphs of the Home area.

5

Add your custom ServiceNow Instance URL* or script instance URL.

In ServiceNow, go to Manage > My Instance to find it. You can also find the URL in your Development Dashboard link. All ServiceNow instances follow the naming convention https://<INSTANCE NAME>.service-now.com

6

Enter the credentials to Authenticate your connection.

• Username* used to connect to the server

• Create or add a Password* from your Secrets.

7

In the Secrets area, New secret to create a new one:

• Give the secret a Name.

• Turn off the Expiration date option.

• Click Add new value and paste the corresponding value.

• Click Save.

Learn more about secrets in Onum in this article.

You can now select the created secrets in the configuration.

8

Establish a limit for the Maximum requests per second*. The minimum value is 1 and the maximum value is 10.

9

If you are using a proxy to establish the connection, toggle on the Proxy configuration button and enter the details here.

Click Finish when complete. Your new Data sink will appear in the Data sinks area list.

Pipeline configuration

When it comes to using this Data sink in a Pipeline, you must configure the following output parameters. To do it, simply click the Data sink on the canvas and select Configuration.

Output configuration

You can define the Pipeline fields to be used as Incident or Event fields in ServiceNow.

Incident

An unplanned interruption or reduction in the quality of the service. Choose the required input fields for the following categories:

• Caller ID

• Short Description

• Category

• Correlation Label

• Correlation ID

• Impact

• Description

• Severity

• Subcategory

• Urgency

• Additional Comments

Event

A notification or signal that something has changed in the system. Choose the required input fields for the following categories:

• Source

• Node

• Type

• Resource

• Metric Name

• Source

• Message

• Severity

• Description

• Additional Info

Click Save to save your configuration.