Searching Asset Groups


Role Availability	Read-Only	Investigator	Analyst	Manager

USM Anywhere includes the option of searching items of interest on the page. There are several filters displayed by default. You can either filter your search or enter what you are looking for in the search field.

Filters Displayed by Default in the Main Asset Groups Page

Filter Name	Meaning
Asset Grouping	Filter by “Static” and “Dynamic”.
Advanced Search	Use this filter to search for a specific value of a field. The advanced search is similar to that for assets. See Advanced Search Filter for more information.
Sensor	Filter asset groups by the associated .
Asset Origin Type	Filter asset groups by who added the asset group to the system.
Instance Type	(Only for the AWS Sensor). Filter asset groups by instance type.
Region	(Only for the AWS Sensor). Filter asset groups by region.
Operating System	Filter asset groups by .
Asset Type	Filter asset groups by asset type. See USM Accepted Asset Types for more information.
Associated Plugin	Filter asset groups by assets that have plugins manually enabled.
Service	Filter asset groups by service.
Software	Filter asset groups by software.

Keep in mind that the “Enter search phrase” box and the “Asset Grouping” filter make the search in the asset groups. The rest of the filters make the search in the members of the asset group. So long as a member of the asset group matches the selected filter, USM Anywhere will display the asset group, even if there is only a member matching that filter.

The number between brackets displayed by each filter indicates the number of items that matches the filter. You can also use the filter controls to provide a method of organizing your search and filtered results. The following table shows the icons displayed with each filter box.

Icon - Meaning

Icon	Meaning
	Sort the filters alphabetically.
	Sort the filters by number of items that matches them.

In the upper-left side of the page, you can see any filters you have applied. Remove filters by clicking the

icon next to the filter. Or clear all filters by clicking Reset.

Note: When applying filters, the search uses the logical AND operator if the used filters are different. However, when the filter is of the same type, the search uses the logical OR operator.

Those filters that have more than 10 options include a Filter Values search field for writing text and making the search easier. If there are more than 50 search results, a

icon appears to the right of the Filter Values search field. Click this icon to download a CSV containing up to 1024 results.

Standard Mode

This mode enables you to select one value per filter at the same time, and then the search is automatically performed. This mode is on by default. To activate the standard mode when the advanced mode is on

Go to Activity > Alarms.
In the upper-left corner of the page, click the icon.
This turns the icon gray, .
If you exit the advanced mode and the selected filters are not compatible with the standard mode, a warning dialog box opens to inform you the current filters will be removed.

Advanced Mode

Advanced mode enables you to select more than one value per filter at the same time. This mode is off by default. To activate the advanced mode

Go to Activity > Alarms.
In the upper-left corner of the page, click the icon to activate the advanced mode. This turns the icon green, .

To search all values of a filter

Go to Environment > Asset Groups.
In the upper-left corner of the page, click the icon to activate the advanced mode.
Select a filter title to select all filters below that title.

Searching Asset Groups by Using the Search Field

Use the search field to enter queries and refine your search. You can enter free text, use wildcards, and use advanced search syntax. When searching, keep in mind the accepted query string syntax list in this table.

Accepted Query String Syntax

Type of Query	Meaning	Example
Standard query with a blank space between terms	By default, a space between query terms is considered an implicit “OR”.	denylist malicious
Literal, using double quotes	Matches fields that contain the full term. Literal searches are case-sensitive. This type of query will not match any searches in the raw log because raw logs are tokenized. IP addresses and FQDNs are considered literal searches, so they don’t require quotation marks.	Event from asset not received
Boolean operators or using parentheses AND, OR, NOT, ( )	Including AND or OR between two search terms will search for results that match both of those terms. Including NOT between two search terms will exclude results that match the second term, even though they otherwise match your query. Parentheses can be used to group terms for higher precedence relative to the rest of your query. Parentheses are also used to designate subsearches.	(http OR tcp) AND ftp
Wildcards, asterisk *	Appending an asterisk to the end of a term within your query will search for results that begin with your search term. An asterisk cannot be used at the beginning of a search query.	instance*
Wildcards, question mark ?	Embedding a question mark in the middle of a term will search for results that otherwise match your query, no matter the value in the position held by the question mark in your search term. A question mark cannot be used at the beginning of a search query.	qu?ck
Regular expression (regex), using /expression/	Regular expression inside forward slash characters. A dialog box opens to confirm the search. The characters ”, *, ?, (, and ) are special characters included in expressions. If you want to search by these characters, you need to manually escape them by preceding them with a backslash.	/Describe.*Instances/
OTX pulse	Pulses are collections of Indicators of Compromise (IOCs). You need to insert the word pulse followed by a colon and the pulse ID or URL.	pulse:59432536c1970e343ce61bf0

Any characters may be used in a query, but certain characters are reserved and must be escaped. The reserved characters are these:

- = & | > < ! [ ] ^ ” ~ : \ /

Use a backslash (for example, ”>”) to escape any reserved character (including a backslash).

To search for Asset Groups using the search field

Go to Environment > Asset Groups.
Enter your query in the search field. If you want to search for an exact phrase having two or more words, you need to put quotation marks around the words in the phrase. This includes email addresses (for example, “bob@mycompany.com”).
Wildcard characters are considered as literal characters.
1. Click the icon.

The result of your search displays with the items identified. The Advanced Search filter enables you to enter a search value on a selected field. The following table shows the filter fields that you can find in the first drop-down list.

Advanced Search Fields (First Drop-Down List)

Filter Name	Meaning
Name	Filter asset groups by the name of the asset.
Description	Filter asset groups by the asset description.
UUID	Filter asset groups by the universally unique identifier (UUID).
IP/CIDR	Filter asset groups by IP and Classless Inter-Domain Routing (CIDR). This is a method for allocating IP addresses and routing IP packets. It is the range of IP addresses that define the network.
FQDN	Filter asset groups by Fully Qualified Domain Name (FQDN).
Asset Type	Filter asset groups by asset type.
Instance Type	Filter asset groups by instance type.
Region	Filter asset groups by region.
Operating System	Filter asset groups by operating system.
Service	Filter asset groups by service.
Software	Filter asset groups by software.
Associated Plugin	Filter asset groups by the plugin associated to the asset.
Alarm Counter	Filter asset groups by the number of alarms.
Event Counter	Filter asset groups by the number of events.
Vulnerability Counter	Filter asset groups by the number of vulnerabilities.
Configuration Issue Counter	Filter asset groups by the number of configuration issues.
PCI Asset	Filter asset groups by Payment Card Industry (PCI) Asset, if the asset is included or not in the PCI Data Security Standards (DSS) Asset Group. See Asset Group List View and Working with Assets and PCI DSS for more information.
HIPAA Asset	Filter asset groups by Health Insurance Portability and Accountability Act (HIPAA) Asset, whether the asset is included in the HIPAA Asset Group. See Asset Group List View for more information.
Custom User Fields	Filter asset groups by the fields you have created. If you have not created fields, this filter does not display.

The result of a search when you use the Alarm Counter filter or the Event Counter filter depends on if an alarm or an event can identify the source or destination as an asset in the inventory. Your environment can have alarms or events associated with assets both included in the inventory and those not included in the inventory.

The following table shows the operators that you can find in the second drop-down list.

Advanced Search Fields (Second Drop-Down List)

Operator	Meaning
>	Greater than.
>=	Greater than or equal to.
<	Less than.
<=	Less than or equal to.
Equal	Equal to.
IP Range	Range of IP addresses.
Is Empty	Include assets with no IP addresses. This operator is available only for IP/CIDR.
Is Not Empty	Include assets with IP addresses. This operator is available only for IP/CIDR.
Like	Search for the specified pattern.
Not Equal	Not equal to. Some filters don’t include the NOT operator (for example, Services or Software).
Not Like	Not true.

The following table shows the operators that you can include in your query string. Use the search field to enter queries and refine your search. You can enter free text, use wildcards, and use advanced search syntax. When searching, keep in mind the accepted query string syntax list in this table.

Accepted Query String Syntax

Type of Query	Meaning	Example
Standard query with a blank space between terms	By default, a space between query terms is considered an implicit “OR”.	denylist malicious
Literal, using double quotes ’ ‘	Matches fields that contain the full term. Literal searches are case-sensitive. This type of query will not match any searches in the raw log because raw logs are tokenized. IP addresses and FQDNs are considered literal searches, so they don’t require quotation marks.	Event from asset not received
Boolean operators or using parentheses AND, OR, NOT, ( )	Including AND or OR between two search terms will search for results that match both of those terms. Including NOT between two search terms will exclude results that match the second term, even though they otherwise match your query. Parentheses can be used to group terms for higher precedence relative to the rest of your query. Parentheses are also used to designate subsearches.	(http OR tcp) AND ftp
Wildcards, asterisk *	Appending an asterisk to the end of a term within your query will search for results that begin with your search term. An asterisk cannot be used at the beginning of a search query.	instance*
Wildcards, question mark ?	Embedding a question mark in the middle of a term will search for results that otherwise match your query, no matter the value in the position held by the question mark in your search term. A question mark cannot be used at the beginning of a search query.	qu?ck
Regular expression (regex), using /expression/	Regular expression inside forward slash characters. A dialog box opens to confirm the search. The characters ”, *, ?, (, and ) are special characters included in expressions. If you want to search by these characters, you need to manually escape them by preceding them with a backslash.	/Describe.*Instances/
OTX pulse	Pulses are collections of Indicators of Compromise (IOCs). You need to insert the word pulse followed by a colon and the pulse ID or URL.	pulse:59432536c1970e343ce61bf0

Any characters may be used in a query, but certain characters are reserved and must be escaped. The reserved characters are these:

- = & | > < ! [ ] ^ ” ~ : \ /

Use a backslash (for example, ”>”) to escape any reserved character (including a backslash).

Go to Environment > Asset Groups.
Below Advanced Search filter, click Add Filter.
Select a field from the first drop-down list. See Advanced Search Fields (First Drop-Down List) for more information.
Select an operator from the drop-down list.
Depending on the field you have chosen in the first drop-down list, the operators vary.
Enter the search value. If you want to search for an exact phrase having two or more words, you need to put quotation marks around the words in the phrase. This includes email addresses (for example, “bob@mycompany.com”).
Click the icon.
Click Add Filter if you want to add a new search.
Click the icon.
Click Apply.

The result of your search displays with the assets identified.

USM Anywhere™

USM Central™

Automated Policy Manager

Searching Asset Groups

Filters Displayed by Default in the Main Asset Groups Page

Icons Next to the Filter Title

Icon - Meaning

Standard Mode

Advanced Mode

To search all values of a filter

Searching Asset Groups by Using the Search Field

Accepted Query String Syntax

To search for Asset Groups using the search field

Advanced Search Filter on Asset Groups

Advanced Search Fields (First Drop-Down List)

Advanced Search Fields (Second Drop-Down List)

Accepted Query String Syntax

To search asset groups using the advanced search filter

​Filters Displayed by Default in the Main Asset Groups Page

​Icons Next to the Filter Title

​Icon - Meaning

​Standard Mode

​Advanced Mode

​To search all values of a filter

​Searching Asset Groups by Using the Search Field

​Accepted Query String Syntax

​To search for Asset Groups using the search field

​Advanced Search Filter on Asset Groups

​Advanced Search Fields (First Drop-Down List)

​Advanced Search Fields (Second Drop-Down List)

​Accepted Query String Syntax

​To search asset groups using the advanced search filter

Filters Displayed by Default in the Main Asset Groups Page

Icons Next to the Filter Title

Icon - Meaning

Standard Mode

Advanced Mode

To search all values of a filter

Searching Asset Groups by Using the Search Field

Accepted Query String Syntax

To search for Asset Groups using the search field

Advanced Search Filter on Asset Groups

Advanced Search Fields (First Drop-Down List)

Advanced Search Fields (Second Drop-Down List)

Accepted Query String Syntax

To search asset groups using the advanced search filter