Ratings management
Last updated
Last updated
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.
Click on Administration in the main menu.
Select Ratings from the Content Management section of the navigation panel to access the Ratings Administration page.
Select Administration from the main menu.
Click on Ratings in the navigation panel.
Hover over an existing rating to reveal the action menu.
The table is organized by:
Name: The name of the rating.
Origin: An indication of where the ratings originate from.
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.
Nexthink offers a set of preconfigured ratings that you can manually install from Nexthink Library. Go to the Nexthink Library module within your Nexthink instance to install, manage, and update predefined custom fields.
Refer to Nexthink Library documentation for more information.
Custom ratings allow you to define thresholds based on your needs, with the flexibility of including or excluding any relevant data. Nexthink recommends editing system ratings or downloading library ratings before creating your own to learn their functionality and understand NQL and how it works. Refer to the Nexthink Query Language (NQL) documentation for more information.
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.
Create and associate tags with ratings to filter the ratings table results quickly.
To add tags to a rating:
Select Admistration > Ratings.
Select a relevant rating and hover over the action menu on the right side.
Click on the action menu icon and select Edit tags to open the Tags pop-up.
Enter a new name or search for the tag name in the Tags field.
Click on the tag action menu to change the tag color or remove the tag.
Click Save to add the tag to the rating.
Click the tags icon on the right-side of the menu to open the Tags panel.
Search for a specific tag at the top of the panel.
Select one or more tags to filter the ratings table.
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 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.
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 can have the field on which the rating is being applied and standard device properties only (i.e., no additional custom fields or remote action outputs)."
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.
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.
Poor
devices | where hardware.memory <= 8GB
Average
devices | where hardware.memory > 8GB and hardware.memory < 16GB
Good
devices | where hardware.memory >= 16GB
Nexthink offers a variety of ratings that can be installed from the Nexthink Library. These are based on actual use cases and preconfigured for immediate use without further customization.
Ratings can have different conventions and ranges across systems and circumstances. Acceptable thresholds for certain metrics, such as boot duration or uptime of specific software, may vary according to customer specifications. Nexthink offers a set of ratings based on DEX Score thresholds. You can edit these to better suit your needs or leave the values as default.
Refer to the Configuring the Score metrics tab documentation for more information on configuring ratings, and the List of hard metrics and thresholds documentation for a series of tables depicting DEX Score thresholds.
Custom ratings allow you to define thresholds based on your needs, with the flexibility of including or excluding any relevant data.
Nexthink recommends editing system ratings or downloading library ratings before creating your own to learn their functionality, as well as understanding NQL and how it works. Refer to the Nexthink Query Language (NQL) documentation for more information.
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.
