Skip to main content

ServiceNow Node Source (Enterprise)

ServiceNow Node Source (Enterprise)

Available in PagerDuty Process Automation Commercial products.

This is a Node Source plugin that provides node information from ServiceNow's®CMDB.

There is a How To article in the Learning section with an example setup.

Authentication

To configure authentication with ServiceNow for the Node Source plugin, follow the steps outlined in ServiceNow Plugins Overviewopen in new window to configure authentication of the ServiceNow plugins. Alternatively, place credentials directly into the Node Source plugin.

Filters

The plugin offers some Quick Filters to gather specific server types from the CMDB.

  • all : Retrieve all types of servers
  • linux : Retrieve only linux machines
  • win : Retrieve only Windows machines
  • unix : Retrieve only unix machines
  • esx: Retrieve only ESX machines
  • solaris: Retrieve Solaris Linux machines
  • aix: Retrieve only AIX machines
  • hpux: Retrieve only HPUX machines
  • osx: Retrieve only OSX machines
  • netware: Retrieve only Netware machines
  • comma separated list : as example 'linux,win'

The Quick Filters above are equivalent to a filter of sys_class_name=cmdb_ci_linux_server where the "linux" is replaced with the value above.

The Custom Filter field will use any custom CMDB filter provided to gather the nodes. Note: If a Custom Filter is specified, all Quick Filter selections are ignored

Mapping and default values

  • mappingParams: A set of ";" separated mapping entries. This values are going to override the default mapping one by one. The minimal mapping needed is the username, because ServiceNow® servers lacks a username field to map:
username.default=root

Default Mapping

nodename.selector=name
hostname.selector=host_name,ip_address,dns_domain
sshport.default=22
description.default=ServiceNow node instance
description.selector=short_description
osFamily.default=unix
osName.selector=os
osName.default=Linux
osVersion.selector=os_version
ipAddress.selector=ip_address
cpuCoreCount.selector=cpu_core_count
cpuCount.selector=cpu_count
cpuCpeed.selector=cpu_speed
cpuType.selector=cpu_type
osDomain.selector=os_domain
tags.selector=asset_tag
tags.default=servicenow

Tips

All nodes require at least the nodename, hostname and user values. If entries in the ServiceNow® query (Quick or Custom) do not have these values they will not show up in the Nodes list.

Configuration of the Mapping

A selector with a list like this:

hostname.selector=host_name,ip_address,dns_domain

Are going to search on the result of the query the value of host_name, if is not set, the ip_address or the dns_domain.

A selector with a default value like this example:

osName.selector=os
osName.default=Linux

Are going to search the os value, if not set, are going to use the default value Linux.

The special case of the tags, if multiple tags are set using comma, all are going to be searched and used.

tags.selector=asset_tag,os
tags.default=servicenow

If is none of the asset_tag or os exists, the default tag are going to be used servicenow.

In the case only the default value exists, this fixed value are going to be set.

osFamily.default=unix