Filtering the List of Nodes

Describes how to setup search expressions and filter nodes based on specific criteria.

About this task

The filter lets you build search expressions to provide sophisticated filtering capabilities for locating specific data on views that display a large number of nodes. Expressions are implicitly connected by the AND operator.

Filtering the Node List in the Control System

Procedure

  1. Log in to the Control System and click Nodes to filter the list of nodes in the Nodes pane.
    NOTE
    The Nodes menu is not available on the Kubernetes version of the Control System.
  2. Click and select one of the following from the Add Filter drop down menu.
    • Health — to filter the list by node health
    • Hostname — to filter the list by hostname of node
    • Physical IP — to filter the list by IP address of node
    • Last FS Heartbeat — to filter the list by number of heartbeats sent to FS
    • CPU Utilized — to filter the list by number of cores utilized
    • Physical Topology — to filter the list by rack path
    • Running Services — to filter the list by installed services
  3. Specify the value in the drop-down field for the selected filter (to filter the list of nodes by) and click Filter.

    As you make selections and specify the filtering criteria, the pane displays only the nodes that match the specified filtering criteria.

  4. Click:
    • Add Filter to add another filtering criteria.
    • to remove a filtering criteria.
    • to clear all filter settings.

Filtering the List Using the CLI

About this task

Use the node list command with the -filter option, to specify large numbers of nodes by matching specified values in specified fields rather than by typing the name of each node explicitly. For example, you can retrieve all nodes on a specific subnet as follows:

maprcli node list -filter [ip==20.30.40.*]

For more information, see Filters.