filtering.rst

Object filtering

The filtering system allows to display only a subset of the network in the graphical view. A filter is a combination of values (or regular expressions) for the properties of an object.

If the properties of an object does not match all properties of the filter, the object will be undisplayed when the filter is selected.

Filters can be created in objects/object_filtering.

Node filtering

This filter enforces the following conditions:

• name: node.* --- this regular expression matches all nodes which name starts with node.
• type: Router|Switch --- matches routers and switches (nodes which type is either Router, or Switch.
• vendor: Cisco --- for this property, the regular expression box is not ticked. This means the value must be exactly Cisco.

In summary, all Cisco routers or switches which name starts with node will match those conditions. All others will be filtered (that is, undisplayed from the graphical view).

Note

All properties which field is left empty are simply ignored.

Link filtering

This filter enforces the following conditions:

• type: Ethernet link --- matches all Ethernet links.
• source: bnet6 --- matches all links which source is the node bnet6.

In summary, all Ethernet links starting from the node bnet6 will be considered, all others ignored.

Apply a filter

Filters are applied from the geographical or logical view. You can switch between filters with the drop-down list in the top-right corner of the screen (framed in red below).

Example

Initial network

In this first example, we consider the following network:

Unfiltered, this network results in the following view:

Filter all links

We create a filter with a condition on the Name of a link:

There isn't a single link which name is a: all links will be filtered.

This result in the following view:

Filter all nodes outside of France or Spain

We add a new condition on the Location of a node to exclude all nodes that are located outside of France or spain:

This result in the following view:

Restrict to nodes with IOS-XE or IOS-XR

Finally, out of the remaining nodes, we exclude all nodes which operating system is not IOS-XE or IOS-XR:

This result in the following view:

Note

Using the filtering system is important because network automation in eNMS is done graphically, by selecting nodes in the graphical view. See the automation documentation for more information.