Skip to main content
Skip table of contents

Ratings management

Identifying if a certain value of a device property is good, bad or somewhere in between requires expert knowledge and experience. Ratings allows you to add a classification or ranking to the property of a device. It reduces the complexity of low-level analytics to a single enumerated value that has business significance.

For example, instead of dealing with many possible values of hardware memory, you can gain instant insight into the memory status of a device with the help of a rating. The rating depends on the value of the device property and is based on its comparative assessment, allowing you to immediately understand the health of the device. You can view the ratings in the Device View Checklist tab and use them in NQL queries.

Device View Checklist tab

Accessing Ratings

  • Click on Administration in the main menu.

  • Select Ratings from the Content Management section of the navigation panel to access the Ratings Administration page.

Accessing ratings

Managing Ratings

  • Click on the New rating button at the top right of the page to create a new rating.

  • Hover over an existing rating to reveal the action menu, then select the Edit option.

  • Select Delete from the action menu to remove a rating.

Defining a rating

Apply a rating on the following device field

Use the drop-down menu to choose the device field on which to apply the rating. Note that once you save the rating, you cannot change the device field.

Rating definition

Write NQL queries for the system to use to evaluate the rating. The system executes the queries in the order of poor, average and good, and determines the rating value based on the first query that returns the device as part of the result set.

New rating page

NQL considerations

There are some considerations you must take into account when writing queries for ratings:

  • The query must target the devices collection.

  • The query must have at least one where clause.

  • The where clause must match the source object, which is a device.

  • The with, include, summarize, compute and list clauses are not allowed.

  • Time selections such as during past, from and to are not allowed.

  • Aggregations, for example, avg(), are not allowed.

  • The rating definition for a field is unique and there cannot be more than one rating definition for the same field.

  • If an object does not meet the conditions of any rating value, its rating value is then defined as Unspecified.

  • If you leave the query for a rating value empty, the rating value is never used since no object matches the query.

Use cases

Rate the output values from the last successful execution of a remote action to collect important information and make further decisions related to the IT environment in your organization.

  • From the drop-down menu, select Remote Action - Output, then select the remote action and the output field of the remote action for which you intend to create the rating.

  • Access the ratings in the Device View checklists tab and use them in the NQL queries.

Create a rating for the Hardware total RAM property on a device to help Support troubleshoot an employee’s slow PC. Support can:

  • View that the Hardware total RAM value has been rated as poor.

  • Identify the issue as a possible cause for the slowdowns.

  • Recommend a hardware upgrade.

Example NQL queries for ratings


devices | where hardware.memory <= 8GB


devices | where hardware.memory > 8GB and hardware.memory < 16GB


devices | where hardware.memory >= 16GB


To enable proper permissions for Ratings:

  • Select Administration from the main menu.

  • Click on Profile from the navigation panel.

  • Click on the New Profile button to create a new profile, or edit an existing profile by hovering over it and clicking on the edit icon to change the profile configuration.

  • In the Permissions section, scroll down to the Administration section and enable Manage all ratings.

Refer to the Profiles documentation for a detailed description of the permission options.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.