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.

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.

Managing Ratings

  • Select Administration from the main menu.

  • Click on Ratings in the navigation panel.

  • Hover over an existing rating to reveal the action menu.

Ratings table

The table is organized by:

  • Name: The name of the rating.

  • Origin: An indication of where the ratings originate from:

    • Custom: A rating created within the Ratings module.

    • Installed from Library: A rating installed from the Nexthink Library module.

  • Tags: Displays the list of tags assigned to each rating.

  • Last modified: The most recent date and time when a rating was changed or edited.

  • Search field: A field that filters the table by searching for the name of a rating.

Action menu

Select a relevant rating and click over the action menu on the right side of the table to view:

  • Edit: Edit a selected rating.

  • Edit tags: Create, assign, and edit rating tags.

  • Export: Export a rating to a JSON file.

  • Delete: Remove a rating from the system.

Tagging ratings

Create and associate tags with ratings to filter the ratings table results quickly.

Creating and assigning tags

To add tags to a rating:

  1. Select Admistration > Ratings.

  2. Select a relevant rating and hover over the action menu on the right side.

  3. Click on the action menu icon and select Edit tags to open the Tags pop-up.

  4. Enter a new name or search for the tag name in the Tags field.

  5. Click on the tag action menu to change the tag color or remove the tag.

  1. Click Save to add the tag to the rating.

Filtering with tags

  1. Click the tags icon on the right-side of the menu to open the Tags panel.

  2. Search for a specific tag at the top of the panel.

  3. Select one or more tags to filter the ratings table.

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.

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 Roles from the navigation panel.

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

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

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

Last updated