Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Network switch and router discovery

Discovery identifies and classifies information about network switches and routers.

Network switches and routers often have very similar capabilities. It is very common for some switches known as Layer 3 switches to have IP routing. Larger routers with optional modules might accept switching modules. Because of these overlaps and the resulting ambiguity of a particular device's classification, Discovery collects the same data for both routers and switches, if it is available in any given device. For details on how Discovery collects data about connections between network devices and other components, see Layer 2 discovery.

Note: For information on Probe to Pattern migration see the knowledge article KB0694477.

Prerequisites

  • The router or switch needs to have IP Address information.
  • The system property glide.discovery.L3_mapping is set to true to discover routers and switches.
  • The router or Layer 3 switch that provides the IP Address needs to have been successfully discovered with populated Exit Interface Routing Rules.
  • If you must populate the [discovery_device_neighbors] table during horizontal layer 2 discovery of the bgp-enabled devices, set the BGP router exploration disable property to No. Notice that enabling this property can cause performance issues including out-of-memory issues on the MID Server.

System properties

You can configure many aspects of Discovery to work according to your personal preferences. The following properties apply to network routers and switches. To view the properties, navigate to Discovery Definition > Properties unless indicated otherwise.

PropertyDescription
glide.discovery.L3\_mappingThis creates IP Connecton::IP Connection relation between servers and network devices.- Type: string - Default value: true - Location: System Property [sys_properties] table
glide.discovery.max\_concurrent\_invocations\_per\_schedule

Sets a maximum number of scheduled invocations of the same Discovery schedule. It prevents a backlog of scheduled runs if Discovery does not finish before the next invocation is scheduled to run. The value is an integer that represents the max number of automated invocations of the same schedule that may proceed at one time. If the limit has been reached, subsequent scheduled invocations are canceled. A value of 0 or any negative number disables this property. - Type: integer - Default value: 3 - Location: Discovery Definition > Properties

Note: This property does not apply to schedules that have a 'Run after' configuration set to 'Even if canceled'.

For a list of properties used in discovery in general, see Discovery properties.

Credentials

Discovery explores many kinds of devices, such as switches, routers, and printers, using the SNMP protocol. SNMP Community Credentials do not include a user name, just a password, which is the community string. The default read-only community string for many SNMP devices is public, and Discovery will try that automatically. SNMPv3 credentials require a user name and a key, depending on the protocol selected. Enter the appropriate SNMP credentials if they differ from the public community string.

Note: SSH is not supported for routers and switches, but is supported for load balancers.

Classifier, pattern, and probes

ClassifiersTrigger probesPattern
Standard Network RouterStandard Network Switch- Horizontal Pattern: launches patterns - SNMP-Routing^ - DNS\* - SNMP-Identity\* - SNMP-Switch-Vlan\* - SNMP-Switching\* - SNMP - Network - ArpTable\* \(Standard Network Switch only\)Network RouterNetwork Switch

*For new instances, these probes are inactive on the classifier. Discovery uses patterns for discovery.

^This probe remains active by default for the Standard Network Router classifier, even when Discovery uses pattern discovery.

To use patterns, verify that the correct pattern is specified in the horizontal pattern probe on the classifier. See Add the Horizontal Pattern probe to a classifier for instructions.

Discovering stacked switches

The Network Switch shared library supports Cisco stacked switches. The CI table for this is IP Switch [cmdb_ci_ip_switch]. Multiple switches in the stack are identified by the primary IP address. Each member of the stack is identified by a combination of elements, including the primary IP address, a name associated with the switch, and the stack mode. The relationship is created between a primary and all of the secondaries. The primary switch has all the fields listed in the table below. The secondary switch has name, serial_number, model_id, manufacturer, stack, and stack_mode.

Note: If all the ports on a switch are open for port 161, that switch will have multiple IPs (one for each port) but the serial number for all the ports is the same. The CI identification is performed based on the serial number, therefore the same record is updated every time instead of creating a new record.

Router and switch data

Table nameLabel/Field nameSource
cmdb\_ciSerial Number serial\_numberSNMP, various MIBs
cmdb\_ciManufacturer manufacturerSNMP, RFC1213 MIB
cmdb\_ciModel ID model idSNMP, RFC1213 MIB
cmdb\_ci\_ip\_routerName name 
cmdb\_ci\_ip\_routerModel ID model IDSNMP, RFC1213 MIB
cmdb\_ci\_ip\_routerManufacturer manufacturerSNMP, RFC1213 MIB
cmdb\_ci\_ip\_routerSerial Number serial\_numberSNMP, various MIBs
cmdb\_ci\_ip\_routerIP Address ip\_addressSNMP, IP MIB
cmdb\_ci\_ip\_routerDescription short\_description 
cmdb\_ci\_ip\_routerCan route IP can\_routeSNMP, IP MIB, BGP MIB
cmdb\_ci\_ip\_routerCan switch IP can\_switchSNMP, dot1dBridge MIB
cmdb\_ci\_ip\_routerPort port 
cmdb\_ci\_ip\_switchName name 
cmdb\_ci\_ip\_switchModel ID model IDSNMP, RFC1213 MIB
cmdb\_ci\_ip\_switchManufacturer manufacturerSNMP, RFC1213 MIB
cmdb\_ci\_ip\_switchSerial Number serial\_numberSNMP, various MIBs
cmdb\_ci\_ip\_switchIP Address ip\_addressSNMP, IP MIB
cmdb\_ci\_ip\_switchDescription short\_description 
cmdb\_ci\_ip\_switchCan route IP can\_routeSNMP, IP MIB, BGP MIB
cmdb\_ci\_ip\_switchPorts portsSNMP, dot1dBridge MIB
cmdb\_ci\_ip\_switchCan switch IP can\_switchSNMP, dot1dBridge MIB
cmdb\_ci\_ip\_switchCan partition VLANs can\_partitionvlansSNMP, dot1dBridge MIB
cmdb\_ci\_ip\_switchStack stackSNMP, entPhysicalTable
cmdb\_ci\_ip\_switchStack Mode stack\_modeSNMP, entPhysicalTable
cmdb\_ci\_netgearCan route IP can\_routeSNMP, IP MIB, BGP MIB
cmdb\_ci\_netgearCan switch IP can\_switchSNMP, dot1dBridge MIB
cmdb\_ci\_netgearCan partition VLANs cdscy\_router\_interfaceSNMP, dot1dBridge MIB
cmdb\_ci\_netgearCan Hub can\_hubSNMP, IP MIB
cmdb\_ci\_network\_adapterIP Address ip\_addressSNMP, IP MIB
cmdb\_ci\_network\_adapterMAC Address mac\_addressSNMP, IF MIB
discovery\_device\_neighborsNeighbor Address neighbor\_addressciscoCdpMIB
discovery\_device\_neighborsNeighbor ID neighbor\_IDciscoCdpMIB, lldpMIB
discovery\_device\_neighborsNeighbor Interface neighbor\_interfaceciscoCdpMIB, lldpMIB
discovery\_device\_neighborsNeighbor Source neighbor\_sourceciscoCdpMIB, lldpMIB
discovery\_device\_neighborsOrigin Interface origin\_interfaceciscoCdpMIB, lldpMIB
discovery\_net\_arp\_tableIP Address IP\_addressSNMP, IP MIB
discovery\_net\_arp\_tableMAC Address mac\_addressSNMP, IP MIB
discovery\_switch\_bridge\_port\_tableInterface Index interface\_indexSNMP, dot1dBridge MIB
discovery\_switch\_bridge\_port\_tablePort portSNMP, dot1dBridge MIB
discovery\_switch\_fwd\_tableMAC Address mac\_addressSNMP, dot1dBridge MIB
discovery\_switch\_fwd\_tablePort portSNMP, dot1dBridge MIB
discovery\_switch\_fwd\_tableStatus statusSNMP, dot1dBridge MIB
discovery\_switch\_fwd\_tableVLAN ID vlan\_idSNMP, dot1dBridge MIB
discovery\_switch\_spanning\_tree\_tableDesignated Bridge MAC designated\_bridge\_macSNMP, dot1dBridge MIB
discovery\_switch\_spanning\_tree\_tableDesignated Root designated\_rootSNMP, dot1dBridge MIB
discovery\_switch\_spanning\_tree\_tablePort portSNMP, dot1dBridge MIB
discovery\_switch\_spanning\_tree\_tablePort Enable port\_enableSNMP, dot1dBridge MIB
discovery\_switch\_spanning\_tree\_tablePort State port\_stateSNMP, dot1dBridge MIB
dscy\_router\_interfaceName nameSNMP, IP MIB
dscy\_router\_interfaceType typeSNMP, IP MIB
dscy\_router\_interfaceNumber numberSNMP, IP MIB
dscy\_router\_interfaceIP Address ip\_addressSNMP, IP MIB
dscy\_router\_interfaceMAC Address mac\_addressSNMP, IP MIB
dscy\_route\_interfaceDestination Network dest\_ip\_networkSNMP, IP MIB
dscy\_route\_interfaceType typeSNMP, IP MIB
dscy\_route\_next\_hopDestination Network dest\_ip\_networkSNMP, IP MIB
dscy\_route\_next\_hopType typeSNMP, IP MIB
dscy\_route\_next\_hopNext Hop next\_hop\_ip\_addressSNMP, IP MIB
dscy\_switchportType typeSNMP, dot1dBridge MIB
dscy\_switchportStatus statusSNMP, dot1dBridge MIB
dscy\_switchportMAC Address mac\_addressSNMP, dot1dBridge MIB
dscy\_switchportPort Number port\_numberSNMP, dot1dBridge MIB
dscy\_switchportInterface Name interface\_nameSNMP, dot1dBridge MIB
dscy\_switchportInterface Number interface\_numberSNMP, dot1dBridge MIB
dscy\_swtch\_fwd\_ruleMAC Address mac\_addressSNMP, dot1dBridge MIB
dscy\_swtch\_fwd\_ruleMAC Manufacturer mac\_mfrSNMP, dot1dBridge MIB
dscy\_swtch\_fwd\_ruleStatus statusSNMP, dot1dBridge MIB
dscy\_swtch\_fwd\_ruleIP address ip\_addressSNMP, dot1dBridge MIB
dscy\_swtch\_fwd\_ruleNetmask netmaskSNMP, dot1dBridge MIB
dscy\_swtch\_partitionBase IP Address base\_ip\_addressSNMP, dot1dBridge MIB
dscy\_swtch\_partitionBase MAC Address base\_mac\_addressSNMP, dot1dBridge MIB
dscy\_swtch\_partitionBase Netmask base\_netmaskSNMP, dot1dBridge MIB
dscy\_swtch\_partitionType typeSNMP, dot1dBridge MIB
dscy\_swtch\_partitionTransparent transparentSNMP, dot1dBridge MIB
dscy\_swtch\_partitionSource Route sourcerouteSNMP, dot1dBridge MIB
dscy\_swtch\_partitionName nameSNMP, dot1dBridge MIB
dscy\_swtch\_partitionStatus statusSNMP, dot1dBridge MIB
dscy\_swtch\_partitionInterface Number interface\_numberSNMP, dot1dBridge MIB

Parent Topic:Network device discovery