Search string syntax
Use the search string syntax that is explained in the following sections to find specific entities such as systems in the TrueSight console.
The search string is not case sensitive and can contain single terms (including wildcards) and phrases (delimited by double quotes), and can optionally be combined by using boolean operators.
Using wildcards
Wildcards allow you to search for similar terms using a single string.
Two types of wildcards are available:
- Single character wildcards (
?
): Indicate one variable character; for example, to search for "text" or "test" you can use the search stringte?t
. - Multiple character wildcards (
*
): Indicate zero or more variable characters; for example, to search for "test", "tests", or "testing" you can use the search stringtest*
.
Using boolean operators
Boolean operators allow you to combine terms and phrases in a search using logical operators.
The following table lists the supported operators:
Operator | Description |
---|---|
AND | Links two terms and finds a matching result if both terms exist in the object's properties. |
+ | Requires that the term after the "+" symbol exist in the object's properties. |
OR | Links two terms and finds a matching result if either of the terms exist in the object's properties; results containing both terms will be displayed at the top of the list. |
NOT | Links two terms and excludes results that contain the term after NOT in the object's properties. |
- | Excludes results that contain the term after the "-" symbol. |
Note
Boolean operators must be specified using capital letters (upper case) in the search string.
Additional information
If no operator is specified between two terms, the AND operator is used by default.
Grouping search terms and phrases
You can use parentheses to group clauses and form sub-queries. For example:
(database* OR "web service") AND billing
Restricting the search using fields
You can restrict the search to specific fields using the syntax:
<field>:<value>
where <field>
is an optional filter used to restrict search results. The available fields, including description and examples, are listed in the following table. For most fields, aliases that are easier and more intuitive to remember are also available; e.g. scenario
instead of tc
.
Field name | Description | Aliases for the field name | Example syntax |
---|---|---|---|
| System whose TrueSight Capacity Optimization name matches the string. |
|
|
| Resource (metric) whose name matches the string. |
|
|
| Resource (metric) whose descriptive name matches the string. | - |
|
| Subresource (subobject) whose name matches the string. |
|
|
| Location whose name matches the string. |
|
|
| Entity type whose name matches the string. |
|
|
| Show child entities of the selected one by name. | - |
|
| Name of the virtual host that is running the VM, this field is valid only for virtual machines. | - |
|
| Name of the virtual cluster that is running the VM, this field is valid only for virtual machines. | - |
|
| Tag whose name matches the string. | - |
|
| Object of the specified type:
| - |
|
status | Restrict results of the search based on the status of the entity.For example:
| - |
|
The following table lists advanced field options that allow you to search for unique IDs; this can be useful if you already know the specific ID of the object you are looking for.
Field name | Description | Aliases for the field name | Example syntax |
---|---|---|---|
| System whose unique ID matches the string. |
|
|
| Metric series whose unique ID matches the string; the string must begin with either SOB or WOB, to identify a system (or, respectively, business driver) metric. | - |
|
| Entity type whose unique ID matches the string. |
|
|
| Show child entities of the selected one by ID. | - |
|
| Unique ID of the virtual host that is running the VM, this field is valid only for virtual machines. | - |
|
| Unique ID of the virtual cluster that is running the VM, this field is valid only for virtual machines. | - |
|
| Tag whose unique ID matches the string. | - |
|
The following table lists advanced field options that allow you to specify numerical ranges; this can be useful to search for systems based on their hardware characteristics.
Field name | Description | Aliases for the field name | Example syntax |
---|---|---|---|
| CPU clock rate (MHz) | - |
|
| Number of CPUs | - |
|
| Size of the physical disk (bytes) | - |
|
| Size of the virtual disk (bytes) | - |
|
| Total memory (bytes) |
|
|
The fields disksize
, ldisksize
, and totalmem
are expressed in bytes; you can append a letter to numerical values to specify a different unit: K
(kilobyte), M
(megabyte), G
(gigabyte), T
(terabyte), P
(petabyte).
Escaping special characters
If you need to use special characters as part of the search string, they must be properly escaped using the \ character. For example, to search for a system called "Database (2)", you must escape the string as follows:
Database \(2\)
Special characters that need to be escaped are:
+ - && \|\| \! ( ) { } \[ \] ^ " ~ * ? : \
Comments