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, see 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.

    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.

FilterServiceNow CMDB sys_class_name
AIX serverscmdb_ci_aix_server
ESX serverscmdb_ci_esx_server
HP-UX serverscmdb_ci_hpux_server
Hyper-V serverscmdb_ci_hyper_v_server
IBM z/OS serverscmdb_ci_ibm_zos_server
Linux serverscmdb_ci_linux_server
Netware serverscmdb_ci_netware_server
OSX servercmdb_ci_osx_server
Solaris serverscmdb_ci_solaris_server
Unix serverscmdb_ci_unix_server
Windows serverscmdb_ci_win_server
storage serverscmdb_ci_storage_server
computerscmdb_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.