Managing Investigations

The Investigations administration page allows you to create, share and manage all of your investigations in one place.

Built-in investigations

Investigations installed from Library

Nexthink offers a set of preconfigured investigations that you can manually install from Nexthink Library. Go to the Nexthink Library module within your Nexthink instance to install, manage, and update predefined investigations.

Refer to the Nexthink Library documentation for more information.

Private investigations

Creating an investigation from scratch allows you to monitor specific types of data and metrics according to your own needs and use cases.

Refer to Creating a new investigation for more information.

Accessing the Manage investigations page

Select Investigations > Manage investigations from the main menu.

Note that the main menu displays Shared and Private investigations sorted by tags.

Creating a new investigation

Click on the New investigation button in the top-right corner of the page:

• The system takes you to the Visual editor tab of the Investigations page where you can construct your query with a few simple clicks.

• Alternatively, switch to the NQL editor tab to write the query by hand or create a new investigation without any prior knowledge of NQL with the support of Nexthink Assist. Refer to the Query data with Assist documentation.

Managing investigations

From the Manage investigations page:

1. Click on the name of an investigation to edit it or view the results of the NQL query.

2. Sort the listed investigations by name or by typing/selecting investigation tags.

3. Import an investigation by selecting the investigation's JSON file.

4. Hover over an investigation to reveal the action menu on the right side of the table.

Hovering over the action menu on the right side of the table allows you to:

• View: See the results of the NQL query on the Investigations page.

• Rename: Change the name of the investigation.

• Edit tags: Create, assign and edit investigation tags. Refer to the Tagging investigations section.

• Share: Grant permissions to other users to view or edit the investigation. Refer to the Sharing an investigation section.

• Export: Export the investigation to a JSON file. Refer to the Exporting an investigation section.

• Duplicate: Create a copy of the investigation.

• Delete: Remove the investigation from the system.

Tagging investigations

Tagging allows you to quickly sort and filter investigations. You can apply one or many tags to investigations.

From the Manage investigations page:

1. Hover over an investigation to reveal the action menu on the right side of the table.

2. Click the Edit tags option from the investigation action menu to open the Tags pop-up.

3. Type a new tag or write an existing one to add it to the investigation.

4. Open the tag’s action menu to remove the tag from the investigation or change the tag color.

Sharing an investigation

Share your investigations with other Nexthink web interface users.

From the Manage investigations page:

1. Hover over an investigation to reveal the action menu on the right side of the table.

2. Click the Share option from the investigation action menu to open the Share pop-up.

The Share option is available if you have permissions to Manage all investigations or Share private investigations option selected for the Investigations module.

1. In the Add profile text field, type in the user profiles you wish to share the investigation with.

2. From the Select permissions drop-down menu, select the appropriate permissions for the profile. The choices are:

   • View: Gives a user read-only access to the investigation and the right to save a copy of it.

   • Edit: Allows a user to modify and save the investigation to collaborate on it with others.

3. Clear all to disable all permissions.

4. Grant permissions to share the investigation.

To remove existing permissions:

• Hover over the Permissions column for a given permission entry and click on the action menu.

• Select Remove all permissions.

All shared investigations appear in the Shared tab of the navigation panel. The Investigations that you have editing rights to, also appear on the Manage investigations page.

Exporting an investigation

Export and download your investigations as a JSON file. From the Manage investigations page:

1. Hover over an investigation to reveal the action menu on the right side of the table.

2. Click the Export option from the investigation action menu to download the investigation's JSON file.

Alternatively, you can also export an investigation from the Investigations' specific page:

• Export results to download the investigation's results as a CSV file. Nexthink asks you to name this file before downloading it.

• Export investigations to download the investigation's JSON file.