Skip to main content

Configure the ServiceNow Discovery connector

The Snow Integration Connector for ServiceNow Discovery is configured in the Snow Integration Manager (SIM). For more information on SIM, refer to Snow Integration Manager.

The ServiceNow Discovery connector uses an API connection.

Prerequisites

A user account with read-only access to the ServiceNow CMDB tables is required to configure the connector.

Set up the Data connection

In Snow Integration Manager, add the ServiceNow Discovery connector, select the Data connection tab, and configure the settings:

  1. In the Endpoint URL box, enter the URL to the ServiceNow instance.

    For example: https://myCompany.service-now.com.

  2. If a port other than the default port of 80 is configured in ServiceNow, in the Port, enter a port number.

  3. In Time out, select the time frame, in seconds, before the connection to ServiceNow will time out. The default value is 30 seconds.

    A value other than the default value should be entered if the connection to ServiceNow times out before all data is collected. To determine a reasonable timeout period:

    In ServiceNow, navigate to System Logs, open the Transactions page, and adjust the timeout period based on the API call response times displayed in column Response time.

  4. In the User name and Password, enter the credentials for a user account with access to the ServiceNow API.

  5. To verify the connection, select Test connection.

  6. In the Initial aggregation length (months), select the number of months that the initial aggregation of inventory data will be based upon.

  7. To reset an ongoing incremental aggregation, select Clear Last Aggregation Date.

  8. Optional: Enter a Site name for this connector, which will override the global site name.

  9. To save the configured settings and close the window, select OK.

Set up the Filtering

Introduced with Snow Integration Manager 5.17 is the ability to filter i.e., exclude devices by ServiceNow system class.

Filter

ServiceNow CMDB sys_class_name

AIX servers

cmdb_ci_aix_server

ESX servers

cmdb_ci_esx_server

HP-UX servers

cmdb_ci_hpux_server

Hyper-V servers

cmdb_ci_hyper_v_server

IBM z/OS servers

cmdb_ci_ibm_zos_server

Linux servers

cmdb_ci_linux_server

Netware servers

cmdb_ci_netware_server

OSX server

cmdb_ci_osx_server

Solaris servers

cmdb_ci_solaris_server

Unix servers

cmdb_ci_unix_server

Windows servers

cmdb_ci_win_server

storage servers

cmdb_ci_storage_server

computers

cmdb_ci_computer

All data is retrieved and aggregated by default. Select devices to filter out during aggregation.

  1. Select the Filtering tab.

  2. To select devices to filter out during aggregation, clear the Retrieve all devices checkbox.

  3. Select the checkboxes for all devices to exclude from aggregation.

  4. To save the filtering, select OK.