Navigating through the results of an investigation
After executing an investigation, you are presented with a list of all the items that matched your query conditions. This is the List view of the Finder.
The list displays all the fields and aggregates that you selected when you edited the options of the investigation.
Cross-Engine List view
If the Cross-Engine features in the Finder are enabled, click the button List (all entities) to get results from all Engines; more specifically, from all the entities that belong to the view domain of the Finder user. In consequence, if a user's domain view is limited to entities within a single Engine, the user will not get results from other Engines.
If the button List (all entities) is disabled, hover the mouse cursor over the button and wait for a tooltip to show up. The tooltip describes the first encountered reason for the incompatibility of the investigation with the Cross-Engine feature. Because of particular investigation options usually related to aggregates (e.g., conditions on aggregates or ordering of results based on aggregates), some investigations cannot be executed across multiple Engines and are thus incompatible with the List (all entities) view.
On the other hand, the List (all entities) view is still available for investigations that specify display fields which cannot be computed across multiple Engines, as long as the investigation is not invalidated for other reasons. In this case, the List (all entities) view resolves the incompatibility by not displaying the conflicting columns.
The List (all entities) view displays up to a maximum of 10 000 results by default, although this number is configurable and you can overcome this limit by exporting the results of the investigation. The Network, Web, and Local activity views are not available when displaying Cross-Engine results.
The results are ordered by the values of the first sortable column. A message in the status bar at the bottom of the window indicates whether the condition of maximum displayable results is reached. For instance, when displaying the results of an investigation based on devices that returns more than ten thousand objects, the status bar states the following:
- Only the first 10 000 devices (ordered by "Name") are displayed
In turn, if any of the connected Engines does not reply to the Cross-Engine query, the Finder displays the following warning message at the top of the window:
- Partial results are displayed because some Engines didn't respond. Contact your administrator if the problem persists.
Moreover, when displaying the results of an investigation based on devices, the Finder adds a special column to the List (all entities) view called Engine. The Engine column holds the name of the Engine that stores the data of the related device. A single device that reports to several Engines gets a different UID from each Engine and is therefore seen as a set of distinct objects in the list of results.
Sorting the results
Order the results in the List view according to the value of one of the displayed fields by clicking its corresponding column header. The arrow to the right of the column name indicates if the sorting is made in ascending (arrow up) or descending (arrow down) order. Click the column header again to change the direction of the arrow.
By default, results are sorted according to the values of the first column in ascending order; unless otherwise specified in the investigation options, where you can look for a number of top objects ordered in either ascending or descending fashion. You can click on any other column header of the List view to sort the results in a different way.
Note that ordering the results in the List view applies to the already displayed results only; that is, ordering the results by clicking on a column does not trigger a new investigation. For instance, if an investigation shows the top 10 devices with the highest TCP traffic, clicking the Name header in the List view reorders the same 10 devices according to their name. The same behavior reproduces in a List (all entities) view that reaches its configured maximum number of results: ordering the results by clicking on a column does not trigger a new Cross-Engine investigation.
Changing the time frame
The List and List (all entities) views display the time frame that applies to the given results of the investigation in the top-center part of its own tab. To change the time frame of the investigation, click the calendar icon that appears to the right of the current time frame. A dialog very similar to the Time frame section of the investigation designer shows up. If Cross-Engine features are enabled, the dates available for selection are those available across all Engines within the domain view of the user, as explained in the article about the Time frame section. Otherwise, the available dates correspond to the history of the current Engine. Set the new desired time frame and click Apply.
To come back to the original time frame of your investigation, click the calendar icon and then push the button Reset.
If you selected a limited time frame such as a particular day, you can also navigate easily with the arrows you find in both sides of the calendar icon. Just press the arrow to the right to move to the next available day, or the arrow to the left to move to the previous day.
Setting the platform
From the List view, filter the results of an investigation according to platforms at any time:
- Click the platform icons at the top of the List view, , and a dialog to select the platforms shows up.
- Tick the check box for every platform that you want to include in the results.
- Optional: To go back to the platforms originally selected by the investigation, click Reset.
- Click Apply to filter the results according to the selected plaforms.
Adding and removing display fields
To quickly add or remove fields displayed as columns in the List view:
- Right-click anywhere in the column headers (the top part with the names of the columns). A label selector shows up.
- Use the label selector to add or remove columns in the same way as you select the columns when creating the investigation.
- Click Apply.
To quickly remove a single column, right-click the column header and select Remove column from the context menu.
Drilling-down to other items from your list of result items is one of the most powerful tools that you have for navigating through the results of your investigations. Drilling-down lets you get items related to the items in the list of results while keeping the context of your investigation, that is, enforcing the time frame and the conditions of the original investigation.
A drill-down is actually a quick investigation on objects, activities, or events that are related to a selection of the results of a previous investigation. For instance, imagine that you execute an investigation on devices that looks for those devices that executed the Nexthink Finder yesterday. You get a list of devices as a result. Imagine now that you want to know the users that executed the Finder yesterday from one or several of those devices. You can get the list of those particular users by drilling-down from the results of your previous investigation. Note that drilling-down keeps the conditions and the time frame of the original investigation, that is, the execution of the Nexthink Finder yesterday.
The drill-down keeps the Cross-Engine context as well. When selecting items of a List view to drill-down, the results lie within the limits of the current Engine. On the other hand, if your selection belongs to a List (all entities) view, the results of drilling-down extend to all available Engines.
To drill-down from a list of results of an investigation:
- Execute the investigation of your choice.
- Select one or more of the items in the List or List (all entities) views.
- Right-click the items selected. A context menu shows up.
- Select the option Drill-down to and choose a type of item. Items are classified into:
- Choose one class of items and then a particular type of object, activity or event. Only those types of items that can be related in some way to the items in the list of results are eligible for drilling-down.
- If the items in the list of results are filtered by platform, the drilling-down shows only those items which are compatible with the selected platform.
- In the case that you selected multiple platforms, the drilling-down shows all those items which are compatible with any of the selected platforms.
- A new tab with the list of results for the drill-down opens.
The items that you can select for drilling-down depend also on the platform of the item you drill-down from. For instance, you cannot drill-down to printers from a Mac OS device, because the Mac platform in Nexthink does not support printers.
One-click investigations, or one-clicks for short, are similar to drill-down investigations, except for the fact that they do not keep the context of the previous investigation.
For instance, to go on with our previous example, imagine that you are navigating the List view of an investigation that returns all the devices that executed the Nexthink Finder yesterday, and that you want to know all the users of a particular device. Drilling-down to users returns only those users who executed the Finder yesterday on that device. On the other hand, a one-click investigation on users returns all the users who have ever been seen in the device, regardless of what they were doing or when.
One-clicks do keep the Cross-Engine context though. When executing a one-click from a List view, the results are limited to the current Engine; whereas a one-click from a List (all entities) view returns items from all available Engines.
To perform a one-click investigation from the list of results of a previous investigation:
- Execute the investigation of your choice.
- Select one or more of the items in the List or List (all entities) view.
- Right-click the items selected. A context menu shows up.
- Select the option One-click investigation and retrieve all the items of a particular class. Choose among:
- Retrieve all objects
- Retrieve all activities
- Retrieve all events
- Note: for binary objects, specify first if you want to retrieve items related to the binary itself, or to the executable or the application to which the binary belongs. Similarly, for executable objects, choose first if you want to retrieve items related to the executable itself or to the application to which the executable belongs.
- Select a particular type of object, activity or event. Only those types of items that can be related in some way to the items in the list of results are eligible for a one-click investigation.
- If the items in the list of results are filtered by platform, the one-click investigation shows only those items which are compatible with the selected platform.
- In the case that you selected multiple platforms, the one-click investigation shows all those items which are compatible with any of the selected platforms.
- The Finder opens a new tab with the list of results for the one-click investigation.
Again, similarly to what happens with drill-downs, the items that you can select when you do a one-click investigation depend also on the platform of the one-clicked object. For example, you cannot retrieve all events related from a Mobile device because Mobile devices do not support events.
Exporting the results of a Cross-Engine investigation
Cross-Engine investigations that display All results are limited to show up to a maximum of 10 000 entries in the List (all entities) view by default. Although this limit is configurable, it is often impractical to deal with a large number of objects in the list view of the Finder. To overcome this limit and actually get all the possible outcomes, export the results of Cross-Engine investigations. From the List (all entities) view in the Finder:
- Click the menu icon at the top right corner of the view.
- Select Export results from the list.
The Finder opens your default web browser with the message Export in progress while the Portal generates a CSV file that gathers the results from all Engines. Once the CSV file is ready and zipped, the browser automatically initiates its download from the Portal. After the download is complete, the Portal removes its local copy of the file and the URL used for the download becomes invalid.
Saving your modifications
When you change the time frame or the displayed fields, or you drill-down, or do a one-click from the List view of an investigation, the system is actually executing a different investigation from the original one.
To save the new investigations that you create by applying modifications to the List view, click the menu icon at the top right of the view and select Save investigation... or press Ctrl+S.
Getting a graphical representation of the data
The List view gives you a plain text representation of the data stored in the Nexthink database. While this is perfect if you want to have a list with the exact values, it can be difficult for a human to get an insight of what is actually happening inside your IT infrastructure with just a textual representation.
To get a graphical representation of the results in the List view, click one of the buttons in the top-left corner of the List view:
- Network activity
- To visualize network connections.
- Web activity
- To visualize web requests.
- Local activity
- To visualize local program executions.
The visualizations are computed within the context of your investigation. Therefore, not all three visualizations are present for all investigations. A visualization is available only if the context contains relevant information for it.