Filter Devices

JFrog Connect provides robust filter tools so that you can view data in any slice of your fleet and perform software updates and other actions on any subset of devices that you specify.

Overview

JFrog Connect provides two kinds of filters, Passive and Active, that give you full control of device data you want to display and specific devices you want to perform actions on. The filters are described in detail below.

Passive Filter Bar

In the Passive Filter bar, you define the slice of your fleet that you want to appear by default in the web UI pages. Once you set this filter, only devices matching the filter criteria appear in the web UI pages such as Overview, Devices, Alerts, Updates, and other pages. The filter appears at the top of all pages in the web UI, and you can change it at any time.

Projects

You can choose the project, group, and any subgroups to be included in the filter criteria. In the project list, you will see only the projects that you have permission to see. If you are an admin, you will see all the projects in the account. The filter includes devices in a single project only, and does not act across projects.

Groups

Within a project, you can filter on any of the groups in the hierarchy.

• All Groups: The default at the top level is All Groups. This means that the devices included will be from all groups at this level any subgroups that you choose. Alternatively, you can choose a specific group at that level, for example, Group-A, as shown in the illustration below.

• All Hierarchies: This appears by default to the right of any group you choose. All Hierarchies means all subgroups within the group you chose. To include only a specific group, click All Hierarchies and the desired group in the list.

• Additional Group: Whenever you have chosen a specific group, you can choose an additional group on the same level by clicking Additional Group.

Additional Filters

You can use Additional Filters to pull out any subset of devices, including the following.

• Specific Device: Use this filter to view data of a specific device. When you choose this filter, all devices from the selected project and groups will be displayed as possible values in the search input. You can select only one specific device in a filter.

• Tag: Use this filter to view data of devices with a certain tag. You can filter on multiple tags. When you choose more than one tag, only data of devices that have ALL of the chosen tags will be shown (i.e., AND, not OR).

• Application: Use this filter to view data of devices having the selected app. You can specify the app version or Any to select all versions. Keep in mind that you can select only one application per filter.

• Device State: Use this filter to view data of devices that are currently online or offline.

• Deployment: Use this filter to view the data of devices that are part of the selected deployment with the chosen status. You can select only one deployment status for each deployment.

To create an Additional Filter:

1. Choose a filter from the list.

2. Complete the criteria statement with an is or is not operator and a target value, and apply.

You can add more filters if necessary. Below is an example of a filter with multiple filters.

Active Filter Bar

Use the Active Filter bar whenever you perform an action on the devices. For example, you use the Active Filter when you create alerts or deploy software updates. The filter appears wherever you see the Select Devices button.

The Active Filter looks just like the Passive Filter and behaves the same way. The default values in the Active Filter are the values in your Passive Filter.

Total Affected Devices

Once you have selected your devices in the filter, you will see a summary indicating the total number of devices to be affected by the action and the applied filter. If this is not what you expected, you can go back and change your filter. Otherwise, click Finish, and the task will be performed on the devices.

The total affected device number that is shown might be different than the actual number of devices that receive the task. The devices that actually receive the task will be filtered at the time you run the task, which might be a few seconds or minutes after you select the filter attributes. (For example, some devices could change status during that time.)

Active Filter is Different from Passive Filter

If you have specified an active filter that is different from the passive filter, you might not see the results of your action in the Connect pages that use the passive filter, for example, data for all the relevant devices might not appear in the Overview, Devices, and Updates pages. To see the full results of the task you performed, change the passive filter to include all of the devices specified in your active filter.

What’s Next?

Learn how to locate devices on a map and how you can refresh the device location.