| Role Availability | Read-Only | Investigator | Analyst | Manager |
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.
Icons Next to the Filter Title
Icon - Meaning
| Icon | Meaning |
|---|---|
  | Sort the filters alphabetically. |
  | Sort the filters by number of items that matches them. |
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.
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 |
-
- = & | > < ! [ ] ^ ” ~ : \ /
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.
- Click the icon.
Advanced Search Filter on Asset Groups
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.
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. |
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 |
-
- = & | > < ! [ ] ^ ” ~ : \ /
To search asset groups using the advanced search filter
- Go to Environment > Asset Groups.
-
Below Advanced Search filter, click Add Filter.
-
Select a field from the first drop-down list.
-
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.