Network router discovery using patterns

reference australia Updated Sep 10, 2026 6 min read network-router-patterns.md
Raw file servicenow.com

The Discovery and Service Mapping Patterns application uses the Network Router pattern to find network routers in your environment. Discovering some of these resources might require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.

Request apps on the Store

Visit the ServiceNow Store to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.

To learn about network routers and their versions that you can discover, refer to Detailed information on products discovered by ITOM Visibility.

For information on probe-based network switch and router discovery, see Network switch and router discovery.

Cisco Nexus Virtual Routing and Forwarding (VRF) data model

The pattern introduces the following CI class starting with Discovery and Service Mapping Patterns version 1.35.1.

CI class Extends from
Virtual Routing and Forwarding (VRF) [cmdb_ci_virtual_routing_forwarding] Configuration Item [cmdb_ci]

Prerequisites

  • Verify that the applications are up to date

    • Discovery and Service Mapping Patterns
    • Visibility Content

  • Verify IP address information

    The router must contain IP address information for successful discovery.

  • Verify that exit interface routing rules are configured and reachable

    The router that provides the IP address must have exit interface routing rules configured and be reachable for successful discovery.

  • Create SNMP credentials

    Create SNMP Community Credentials or SNMPv3 credentials. For more information, see SNMP credentials.

  • Configure properties for router discovery

    Navigate to sys_properties.list and verify that the glide.discovery.L3_mapping system property is set to true.

    You can configure these additional properties for network router discovery.

System property

Description

glide.discovery.max_concurrent_invocations_per_schedule

Sets a maximum number of scheduled invocations for the same Discovery schedule. It prevents a backlog of scheduled runs if Discovery does not finish before the next one starts. The value is an integer that represents the max number of automated invocations that can run concurrently for the same schedule. If the limit is reached, subsequent scheduled invocations are canceled. A value of 0 or any negative number disables this property.

  • Type: integer
  • Default value: 3 Note: This property does not apply to schedules that have a 'Run after' configuration set to 'Even if canceled'.

glide.discovery.bgp_router_disable

Disables running the SNMP – Routing pattern when discovering a router running the BGP protocol. If you must populate the Device Neighbors [discovery_device_neighbors] table during horizontal layer 2 discovery of the BGP-enabled devices, set the glide.discovery.bgp_router_disable property to false. Notice that enabling this property can cause performance issues including out-of-memory issues on the MID Server.

  • Type: Boolean
  • Default value: true

glide.discovery.disable_next_hop_data

Skips populating the Next Hop Routing Rule table for BGP-enabled routers during horizontal discovery. The device, its physical interfaces, and its neighbors are still discovered.This property takes effect only when theglide.discovery.bgp_router_disable property is set to false.
- **For Cisco Nexus VRF discovery** 
Verify the following requirements:

-   Discovery and Service Mapping Patterns starting from version 1.35.1.
-   Read permissions for the following commands on the Cisco Nexus device:
    -   `sh vrf`
    -   `sh hsrp br`
    -   `sh ip interface vrf all`
    -   `sh ipv6 interface vrf all`
-   Create SSH credentials for the Cisco Nexus user. For more information, see [SSH credentials](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-security/r_SSHCredentialsForm.md).

Data collected by Discovery during horizontal discovery

Discovery populates the data in the CMDB when running the Network Router pattern.

Field Description
Name [name] Name of the router.
Model ID [model_id] Hardware model ID of the router.
Manufacturer [manufacturer] Router manufacturer.
Serial number [serial_number] Unique hardware serial number of the router.
IP Address [ip_address] IP addresses assigned to interfaces.
Description [short_description] Device description.
Can route IP [can_route] Indicates whether the IP pockets can be routed between networks. Possible values are true or false.
Can partition VLANs [can_partitionvlans] Indicates whether the local area network (LAN) can be partitioned. Possible values are true or false.
Can switch IP [can_switch] Indicates whether a network device has Layer 2 switching capabilities. Possible values are true or false.
Physical interface count [physical_interface_count] Number of physical interfaces.
Ports [ports] Individual network interface (physical or logical) used to connect devices such as computers, servers, access points, or uplinks to switches or routers.
Discovery Protocol ID [discovery_proto_id] Unique identifier of the device participating in the Cisco Discovery Protocol (CDP) or Link Layer Discovery Protocol (LLDP) protocol.
Discovery Protocol Type [discovery_proto_type] Protocol type. Possible values are CDP or LLDP.
Field Description
IP Address [ip_address] IP address of the router.
Netmask [netmask] Netmask of the router.
Nic [nic] References the Network Adapter [cmdb_ci_network_adapter] table.
Owned By Configuration Item [owned_by_cmdb_ci]* References the Virtual Routing and Forwarding (VRF) [cmdb_ci_virtual_routing_forwarding] table

* Populated for Cisco Nexus VRF discovery only.

Field Description
Name [name] Name of the network adapter.
IP Address [ip_address] IP address of the network adapter.
Netmask [netmask] Netmask of the network adapter.
MAC Address [mac_address] MAC address of the network adapter.
Alias [alias] User-assigned name for the network adapter.
Configuration Item [cmdb_ci] References the IP Router [cmdb_ci_ip_router] table.
Field Description
Name [name] Name of the Domain Name System (DNS).
IP Address [ip_address] IP address of the DNS.
Field Description
Name [name] VRF name as configured on the network device.
VRF ID [vrf_id] VRF identifier assigned by the network device operating system (OS).
Display Name [display_name] Display name composed of the VRF name and the associated network device name.
Configuration Item [configuration_item] References the IP Router [cmdb_ci_ip_router] table.

* Populated for Cisco Nexus VRF discovery only.

CI relationships

Discovery creates these relationships and references to support the network router discovery. References link to records in other tables and don't appear in the CI Relationship [cmdb_rel_ci] table.

CI Relationship CI
IP Router [cmdb_ci_ip_router] Contains::Contained by Switch Forwarding Rule [dscy_swtch_fwd_rule]
IP Router [cmdb_ci_ip_router] Contains::Contained by Switch Partition [dscy_swtch_partition]
IP Router [cmdb_ci_ip_router] Contains::Contained by Switchport [dscy_switchport]
IP Router [cmdb_ci_ip_router] Owns::Owned by IP Address [cmdb_ci_ip_address]
IP Router [cmdb_ci_ip_router] Owns::Owned by Network Adapter [cmdb_ci_network_adapter]
IP Router [cmdb_ci_ip_router] Uses::Used by Exit Interface Routing Rule [dscy_route_interface]
IP Router [cmdb_ci_ip_router] Uses::Used by Next Hop Routing Rule [dscy_route_next_hop]
IP Router [cmdb_ci_ip_router] Uses::Used by Router Interface [dscy_router_interface]
Network Adapter [cmdb_ci_network_adapter] Owns::Owned by IP Address [cmdb_ci_ip_address]
IP Router [cmdb_ci_ip_router] Owns::Owned by Virtual Routing and Forwarding (VRF) [cmdb_ci_virtual_routing_forwarding]*
Virtual Routing and Forwarding (VRF) [cmdb_ci_virtual_routing_forwarding] Contains::Contained by IP Address [cmdb_ci_ip_address]*

* Created for Cisco Nexus VRF discovery only.

CI/Table Field Referenced CI
Network Adapter [cmdb_ci_network_adapter] Configuration Item [cmdb_ci] IP Router [cmdb_ci_ip_router]
Network ARP Table [discovery_net_arp_table] Configuration Item [cmdb_ci] IP Router [cmdb_ci_ip_router]
Next Hop Routing Rule [dscy_route_next_hop] Configuration Item [cmdb_ci] IP Router [cmdb_ci_ip_router]
Router Interface [dscy_router_interface] Configuration Item [cmdb_ci] IP Router [cmdb_ci_ip_router]
Serial Number [cmdb_serial_number] Configuration Item [cmdb_ci] IP Router [cmdb_ci_ip_router]
Switch Bridge Port Table [discovery_switch_bridge_port_table] Configuration Item [cmdb_ci] IP Router [cmdb_ci_ip_router]
Switch Forwarding Rule [dscy_swtch_fwd_rule] Configuration Item [cmdb_ci] IP Router [cmdb_ci_ip_router]
Switch Forwarding Table [discovery_switch_fwd_table] Configuration Item [cmdb_ci] IP Router [cmdb_ci_ip_router]
Switch Partition [sdcy_swtch_partition] Configuration Item [cmdb_ci] IP Router [cmdb_ci_ip_router]
Switch Spanning Tree Table [discovery_switch_spanning_tree_table] Configuration Item [cmdb_ci] IP Router [cmdb_ci_ip_router]
Switchport [dscy_switchport] Configuration Item [cmdb_ci] IP Router [cmdb_ci_ip_router]
Exit Interface Routing Rule [dscy_route_interface] Configuration Item [cmdb_ci] IP Router [cmdb_ci_ip_router]
IP Address [cmdb_ci_ip_address] Nic [nic] Network Adapter [cmdb_ci_network_adapter]
IP Address [cmdb_ci_ip_address] Owned By Configuration Item [owned_by_cmdb_ci] Virtual Routing and Forwarding (VRF) [cmdb_ci_virtual_routing_forwarding]*
Virtual Routing and Forwarding (VRF) [cmdb_ci_virtual_routing_forwarding] Configuration Item [configuration_item] IP Router [cmdb_ci_ip_router]*

* Populated for Cisco Nexus VRF discovery only.

Parent Topic:Available on-premise discovery patterns

Search documentation
Search document titles and file paths on the australia branch