Action

Choice

The action performed upon the task execution.

1.0.0

Instance URL

Text

ServiceNow URL e.g. https://dev532313.service-now.com

1.0.0

Authentication Type

Choice

The Authentication Type used:

• Basic Authentication – (Default)

• Oauth2 (ServiceNow API endpoint)

• Certificate Based Authentication

“Certificate Based Authentication” is not for public use. Please contact support if you are interested in using this option

1.0.0

ServiceNow Credentials

Credentials

Credentials for "Basic" Authentication Type. The Credentials definition should be as follows.

• User as "Runtime User".

• User Password as "Runtime Password".

Required then Authentication Type is “Basic” or “Oauth2 (ServiceNow API endpoint)”

1.0.0

Client Credentials

Credentials

Client Credentials. The Credentials Definition should be as follows:

• Client ID as "Runtime User".

• Client Secret as "Runtime Password"

Required then Authentication Type is “Oauth2 (ServiceNow API endpoint)”

1.0.0

Client Certificate Path

Text

Full Path of the public key certificate for SSL client-side authentication. The file must be in PEM format. Required when Authentication Type is set to “Certificate Based Authentication”

1.0.0

Client Private Key Path

Text

Full Path of the private key file for SSL client-side authentication. The file must be in PEM format and not encrypted. Required when Authentication Type is set to “Certificate Based Authentication”

1.0.0

Source

Text

The name of the event source type. For example, “SCOM” or “SolarWinds”.

1.0.0

Event Class

Text

Specific instance of the source. For example, “SCOM 2012 on 10.20.30.40”

1.0.0

Node

Text

The Node field should contain an identifier for the Host (Server/Switch/Router/etc.) that the event was triggered for. The value of the Node field can be one of the following identifiers of the Host:

• Name

• FQDN

• IP

• Mac Address

If it exists in the CMDB, this value is also used to bind the event to the corresponding ServiceNow CI.

1.0.0

Resource

Text

If the event refers to a device, such as, Disk, CPU, or Network Adapter, or to an application or service running on a Host, the name of the device or application must be populated in this field. For example “Disk C:\” or “Nic 001”.i

1.0.0

Metric Name

Text

Name of the metric that triggered the alert. For example, “Used Memory” or “Total CPU utilization”.

1.0.0

Type

Text

The type of event. This type might be similar to the Metric Name field, but is used for general grouping of event types.

1.0.0

Message Key

Text

This field is used for de-duplication of events. For example, there might be two events for the same CI, where one event has CPU of 50% and the next event has CPU of 99%. Where both events must be mapped to the same ServiceNow alert, they should have the same message key. The field can be left empty.

1.0.0

Additional Info

Script

This field is referencing a UAC Script in JSON key/value format, and is meant to contain any information that might be of use to the user. It does not map to a pre-defined ServiceNow event field. Examples include IDs of objects in the event source, event priority (if it is not the same as severity), assignment group information, and so on. An example of a script content is below:

1.0.0

Time Of Event

Text

Time when the event occurred on the event origin. The format is: yyyy-MM-dd HH:mm:ss. If left empty the the current Agent local time is used.

1.0.0

Resolution State

Text

The resolution state of the Event. If left empty the state is New. Possible Values:

• New – (Default)

• Closing

1.0.0

Severity

Choice

Severity of the event. Possible Values:

• – None – (Default)

• 0 - Clear

• 1 - Critical

• 2 - Major

• 3 - Minor

• 4 - Warning

• 5 - OK

1.0.0

Extension Output Options

Choice

Control the Extension Ouput “results”

• --None-- : No additional information i printed on Extension output “result”. – (Default)

• Print Detailed Event Information : Event information provided by ServiceNow Endpoint is printed on Extension output “result”.

1.0.0

Provide Additional Fields

Choice

The Provide Additional Fields provided as Choice field. This field allows the user to choose whether to include or not additional ServiceNow fields in the request as a JSON formatted text. The following options are available.

• -- None --

• As JSON Text

1.1.0

Additional Fields (JSON)

Text

Additional Fields (JSON) provided as JSON formatted text. Each additional field can be sent as a key/value pair.

Required when Provide Additional Fields is "As JSON Text".

1.1.0