Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Add a Filter Rule

Routing Director uses a filter rule to control which nodes should appear on the topology map. The filter rules defines the conditions based on which the nodes are filtered in the topology filter. Topology filtering is only active when at least one filter rule is configured. If there are no filter rules configured, then the topology filter allows all the nodes to pass through the filter (transparency mode). In this case, all the nodes are visible on the topology map.

To add a filter rule:

  1. Click Management > Dynamic Topology > Topology Filter.
    The Topology Filter page appears.
  2. Click the Add (+) icon.
    The Add New Filter page appears.
  3. Complete the configuration according to the guidelines in Table 1.
    Note:

    Fields marked with an asterisk (*) are mandatory.

  4. Click OK to save the filter rule.
    You can view the new filter rule listed on the Topology Filter page.
Table 1: Fields on the Add New Filter page

Field

Description

Condition

Select one of the node attributes (hostname, router-id, sys-id) from the drop-down list as a condition for filtering a node.

  • hostname—Name of the device.

  • router-id—IS-IS hostname of the device.

  • sys-id—The loopback interface IP address (IPv4) of the device.

Type

Select Match or Regex from the list.

Note:
  • If the condition field is router-id, then only the match option is listed.

  • If the condition field is hostname or sys-id, then the options listed are match or regex.

Regex (regular expressions) allow for more flexible and powerful pattern matching compared to simple string matches. For example:

  • PTX(.*)—Matches all text starting with PTX.

  • PTX[1-3]—Matches PTX1, PTX2, and PTX3.

Based on your selection, Routing Director compares the Condition Field to the Condition Value. After the comparison, the filter creates a condition based on whether the values match.

Value

Select the value you want to match against the selected condition field.

Note: The value depends on the Condition Field selected. For example, if you have selected router-id, then enter only the IP address. If you have selected hostname or sys-id, enter any alphanumeric value.

Action

Select one of the following actions that Routing Director must perform when the condition value matches the condition field:

  • Accept—Routing Director collects live updates from the device.

  • Reject—Routing Director does not collect live updates from the device.

Note: Irrespective of whether the node is accepted or rejected in the topology filter, you can still view the onboarded nodes on the topology map. However, for the onboarded nodes that are rejected by the topology filter, the live events data is not collected.