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 |
* |
Search for a device by adding an asterisk (*) to view the results of your partial entry. | tes* |
Search results show every device that includes tes. |
" " |
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. |
device_id |
Search for specific devices. | device_id: d-066b0bf6-5bd1- |
Search results include the device ID. Note that if you do not have the entire ID, you can add an asterisk (*) to the end of your entry to search for devices that begin with that ID. |
ip_addresses |
Search for devices with a specific IP address. | ip_addresses: 10.40.0.212fe80: |
Search results include devices with this IP address. Note that if you do not have the entire IP address, you can add an asterisk (*) to the end of your entry to search for devices that begin with that IP address. |
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. |
is_hibernating |
Search for devices that are hibernating. You can enter one of the following:
|
is_hibernating: true |
Search results include devices that are hibernating. |
is_online |
Search for devices that are online or offline. You can enter one of the following:
|
is_online: false |
Search results include devices that are offline. |
mac_addresses |
Search for devices with a specific MAC address. | mac_addresses: 38:8c:50:ca:a3:307c: |
Search results include devices with that specific MAC address. |
name |
Search for devices with a specific name. | name: Test |
Search results include devices with Test in the device name. |
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. |
tags |
Search for devices with specific tags. | tags: test |
Search results include devices tagged with test. |
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.