You can find devices in Fleet by using the search field in the Device List view. The search field is powered by Elasticsearch, which enables you to use advanced search functionality in the search field. You can find your devices by searching different properties, such as device names, strategies, networks, operating systems and so on.
The following table includes helpful operators that can be used in the search field on the Device List page:
Operator | Description | Example | Results of example |
" " |
Add quotes (“) around your search entry for exact search results. | “test device” |
Search results show every device that exactly matches Note: If you were to enter |
AND |
Search for devices that include both terms by adding AND in between two entries. | Linux AND test |
Search results show devices that only include both Linux and test . |
OR |
Search for devices that include either terms by adding OR in between two entries. | Linux OR test |
Search results show devices that include Linux or test . |
current_version |
Search for devices running specific versions. | current_version: 2.28.5 |
Search results include devices that are currently running version 2.28.5. |
is_agent |
Search for which devices using the agent. You can enter one of the following:
|
is_agent: true |
Search results include devices that are using the agent. |
status |
Search for devices that are online, offline, or hibernating. You can enter one of the following:
|
status:0 -- note there is no space between the colon and number |
Search results include devices that are online. |
network_name |
Search for devices under a specific network. | network_name: LG testing |
Search results include devices devices in the LG testing network . |
os_platform |
Search for devices running a specific operating system (OS). | os_platform: linux |
Search results include devices using Linux. |
strategy_name |
Search for devices using a specific strategy. | strategy_name: Multiple App Testing |
Search results include devices using the Multiple App Testing strategy. |
You can search for devices with certain MAC addresses, IP addresses, etc. by entering the address in the search bar with no special operator. These properties include:
- Name
- MAC address
- IP address
- Device ID (e.g.
d-066b0bf6-5bd1-4602-6623-184fa985ed4
) - Tags
The following operators are reserved characters: + - = && || > <
! ( ) { } [ ] ^ ” ~ * ? : \ /
. The two characters, <
and >
, cannot be escaped at all.
To use any reserved characters in the search field, you must escape them with a leading backslash. For example, to search for (1+1)=2
, you need to enter your query as the following: \(1\+1\)\=2
.
See Query string syntax in the Elasticsearch documentation to learn more about using other characters in the search field.