Filter Expressions

<< Click to Display Table of Contents >>

Navigation:  Peer Management Center Help > Advanced Configuration > Advanced Peer Management Center Configuration >

Filter Expressions

The Peer Management Center provides the ability to filter lists throughout the Peer Management Center interface. Filter expressions can help you quickly find jobs, Agents, and sort through summary reports. The search results of your filter will be displayed in the window below the expression.

Basic

The simplest filter expressions contain words you are looking for. To find all items related to sales, simply type the word "sales" in the filter expression box. All items from the list that contain the word "sales" in their name, tag names, or tag categories will be displayed and all other items will be hidden. The agent attribute fields (see attr below) are not included in generic searches.

Double quotes around the word(s) you are searching for are required if you want an exact word match or the words contain a space. For example, if you want to search for the words "North America" the two words must be contained in double quotes. If you want to search for the word "agent" only without showing "USAgent" or "Agent2015" in results, the word must be contained in double quotes.

Use the Ctrl + Space keyboard shortcut to list all possible filters and predefined labels, which can be selected to refine your search quickly.

Refine

Use predefined labels to specify in which field your filter word should appear. Use the following format to take advantage of labels in your filter expression: <label>:<search string>. List of possible labels include:

name

List only items that match the string (e.g. name:"Design Data")

tag

Show only items with the word specified in their tag(s) (i.e tag:Americas)

cat

Search for items that have been assigned a specific category (e,g,. search for Jobs that were categorized as Design - cat:Design)

host

Filter through Jobs and list only those that contain the host in the list of job participants (e.g. host:WIN12R2A)

attr

Search for the specified string in the following Agent fields: Connection Status, Operating System, JVM Architecture, and Agent Version (e.g. attr:x86)

filter

List items that have been assigned a default or user-created filter. Default Job filters include Failed Jobs, Jobs with Backlog, and Running Scans. Default Agent filters include Connected and Disconnected. (e.g. filter:"Running Scans")

Operators

You can create more sophisticated filters by using operators. Operators allow you to combine multiple simple expressions into a single, compound expression. Supported operators are: OR, AND, and NOT. Typing tag:Americas AND sales in the Filter Expression will show only Agents with the word Americas in their tag(s) AND the word sales in their name, tags, or tag categories. Parentheses can be used to build more complex expressions by grouping simple expressions.

Remove/Clear Filters hub_filter_expressions_clear_37

To remove a filter and show all items in the list, click the pencil icon to the right of the Filter Expression.

Save and Manage Filters hub_filter_expressions_save_37

Throughout the Peer Management Center interface, you will have the opportunity to save your Filter Expression by clicking the Manage, Save, and Load filters button, usually located above the Filter Expression field or in the Actions drop-down menu.  The Manage, Save, and Load filters button is available in the Jobs view panel, the Agent Summary view, the and the Collaboration Summary panel.

Examples:

Show all Agents with the word Sales in their name, tag name, or tag category:

Sales

Show all Agents with a tag that has "North America" in the tag name and "Location" in the tag category:

cat:Location AND tag:"North America"

This filter will show all Agents with the word Sales in their name, tag name, and tag category and with a tag that has "North America" in the tag name and "Location" in the tag category.

Sales AND (cat:Location AND tag:"North America")