LogoLogo
What's New?Connect Agent ReleasesBook a DemoPricing
  • Documentation
  • Developers
  • Administration
  • OVERVIEW
    • JFrog Connect Overview
      • Architecture Overview
        • Connect Agent
        • Connect & JFrog Platform
      • Plan Your Update Strategy
        • Software Update Objectives & Concepts
        • Software Update Process & Procedures
  • Get Started
    • Create JFrog Connect Account
    • Log in to JFrog Connect
    • Network Requirements
    • Register Device
  • Manage your Fleet
    • Register Devices at Scale
      • Freeze Image on Device
      • Build Image with Agent
    • Register & Update Device at Once
    • Organize Your Fleet
      • Create Project
      • Move Device between Projects
      • Create Groups
        • Add Device to Group
        • Add Many Devices to Group
        • Change Group Name
        • Delete Group
      • Tag Devices
        • Remove a Tag
      • Remove Many Devices
  • Devices
    • Fleet Overview
      • Filter Devices
      • Locate Devices
    • Device Details
      • Delete a Device
      • Block Updates with Update Trigger
    • Update Connect Agent
    • Delete Many Devices
  • Deployment
    • Create Update Flow
      • Actions
        • Run Command
        • Run Script
        • Deploy File
        • Deploy Docker
          • Use Docker Image
          • Use Docker Compose
          • Get Artifactory Parameters
        • Clone Git Repository
        • Download Artifact
          • Get Artifactory Path
        • Download Release Bundle
          • Get Artifactory Parameters for Release Bundle
        • Update Image
        • Install Debian Package
          • Get Artifactory Parameters for Debian
      • Use Update Parameters
      • On Failure & Rollback
      • Vulnerability Scans
      • Sample Use Case: Build Update Flow for Reuse
    • Deploy Software
      • Set Application & Version
      • Set Alert upon Failure
      • Set Phased Rollout
      • View Deployment Progress
        • Detailed Deployment Information
        • Abort a Deployment
      • Deploy in Groups
      • Sample Use Case: Deploy Docker Images to Devices
  • Tools
    • Remote Tools
      • Use Terminal
      • Open Port Tunnel Session
        • Access with VNC
        • Connect with SSH
        • Access Device Web Applications
      • Run Commands Remotely
        • Run Command as Non-Root User
      • Get Device Files (Fetch Files)
    • Alerts
      • Create Channel
      • Set Webhook
    • Monitor
      • Resource Monitor
      • Process Monitor
  • Releases
    • What's New?
    • Connect Agent Release Notes
  • Troubleshooting
    • Connect Server Status
    • Troubleshoot Topics
      • Device Registration
      • Display issue - "0.0"
      • Micro update
      • Remote control
Powered by GitBook
On this page
  • Passive Filter Bar
  • Projects
  • Groups
  • Additional Filters
  • Active Filter Bar
  • Total Affected Devices
  • Active Filter is Different from Passive Filter
  • What’s Next?

Was this helpful?

Export as PDF
  1. Devices
  2. Fleet Overview

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.

PreviousFleet OverviewNextLocate Devices

Last updated 2 months ago

Was this helpful?

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 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.

  1. 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 criteria.

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 on a map and how you can refresh the device location.

locate devices
fleet