Analysts can set preferences that affect the behavior of NetWitness Platform when using the Investigate > Events view. If the Events view is open; these two buttons give access to preferences dialogs: and . The User menu () is focused on global user preferences such as time zone, while the Events preferences menu () is focused on user preferences for behavior in the Events view. The rest of this section describes both sets of preferences.
Set the Default Investigate View
You can select the default view when you open Investigate: Navigate view, Events view, Hosts view, Files view, Entities view, or Malware Analysis view. The default Investigate view is set in the global User Preferences dialog (in the upper right corner of the NetWitness Platform browser window, select ).
The global user preferences are described in detail in the NetWitness Platform Getting Started Guide.
Set User Preferences for the Events View
You can set your own preferences relevant to the Events view. The preferences selected persist per user and are available whenever the specific user logs in to the application.
To set default values for working in the Events view:
- In the Events view, click .
The Event Preferences dialog is displayed. Different versions of the dialog have some differences in labeling and available options as shown in the following figures. The first figure is an example of the Version 11.3 11.4 dialog, and the second figure shows the dialog for Version 11.411.5.1.
- In the Default Events View field, select the default reconstruction type when you open an event in the Events panel: Text, Packet, File, (Version 11.5 and Later) Host or Email .
If you have not selected a default analysis type, when you open an event, the default reconstruction type is the Packet analysis, except for log and endpoint events, which open to the Text analysis. If you select a default reconstruction type, the reconstruction type is the default reconstruction that you specified. In both cases, the default is the starting point, and if you change the type while you are working, the type you choose is used for the next reconstruction.
- In the Default Log Format field, select the download format for exporting logs: Download Log (11.3) or Download Text (11.4), Download XML, Download CSV, or Download JSON. If you do not select a format here, the default download format is Download Text. These options are also available at the time of download in a drop-down menu.
- In the Default Packet Format (11.3) or Default Network Format (11.4) field, select the default format for downloading packets. If you do not select a format here, the default download format is Download PCAP. These options are also available at the time of download in a drop-down menu:
- Download PCAP to download the entire event as a packet capture (*.pcap) file
- Download All Payloads (11.3) or Download Payloads (11.4) to download the payload as a *.payload file
- Download Request Payload to download the request payload as a *.payload1 file
- Download Response Payload to download the response payload as a *.payload2 file
- (Version 11.4 and later) In the Default Meta Format field, select the download format for exporting metadata: Download Text, Download CSV, Download TSV, or Download JSON. If you do not select a format here, the default download format is Download Text.
- (Version 11.5.1 and later) To change the preference for the time that is matched when you submit queries, select an option in the Query Time field.
- When Collection Time is selected, the time of an event reflects when it was received and stored into the system. This is the default setting.
- When Event Time is selected, the time of an event reflects the time at which the event actually occurred. A good case for using the event time is when investigating logs or endpoints data and looking for events that occurred around the same time. Using Event Time filters out all network events. This applies only to queries initiated within the Events page. For queries initiated from outside (Respond, Reports, or a third party application) Collection Time is utilized even when this preference is set to Event Time. In this scenario, an indicator is displayed on the time table column header and in other messaging to notify the analyst that the time being used may require adjustment.
The following figures shows the message displayed on the time table column header to notify the analyst that the time being used may require adjustment.
- (Version 11.5.1 and later) Under Relative Time Range Settings, choose either Database Time or Current Time. The Events view can display results based on the relative time range, Last 2 hours or Last 30 Days, for example. The time range can be relative to the time when the event was received and stored into the system or the current time zone's clock time. When you set the time format, your individual user preference is saved until changed again. The default setting for this preference is Database Time, which is the same time format used to display query results in the Navigate view and Legacy Events view.
- When Database Time is selected, the time range is relative to the time of the last stored event.
- When Current Time (labeled Wall Clock Time in Version 11.3 and earlier) is selected, the time range is relative to the current time in the timezone set in user preferences.
- (Version 11.4 and 11.5later) Under Time Format for Query, choose either Database Time or Current Time. The Events view can display results based on the database time or the current clock time. When you set the time format, your individual user preference is saved until changed again. The default setting for this preference is Database Time, which is the same time format used to display query results in the Navigate view and Legacy Events view.
- When Database Time is selected, the end time for a query is based on the time that the event was stored.
- When Current Time (labeled Wall Clock Time in Version 11.3 and earlier) is selected, the query is executed with the current time in accordance with the timezone set in user preferences.
(Version 11.4 and later) To set the sort sequence by collection time for the events listed in the Events panel, select one option under Default Event Sort Order. After you have selected a preference, you can also interact with the table column headers to request the results again sorted differently as described in Use Columns and Column Groups in the Events List.
- Unsorted (default for Version 11.4.1): To list events as processed by the Core services. Unsorted is faster because it streams back the events as soon as a match is found versus waiting for all Core services to respond and then displaying them in the chosen order.
- Ascending (default for Version 11.4 and earlier): To put the events with the earliest collection time first in the list. The oldest events are displayed first if in ascending order.
- Descending: To put the events with the latest collection time first in the list. The newest events are displayed first if in descending order. When investigating logs, you may want to change the sort sequence to see the latest collection time first.
If results exceed the events limit, not all events can be loaded. The portion of returned events loaded in the Events panel matches the sort order preference: the oldest portion of events is loaded when Ascending order is selected, and newest portion of events is loaded when Descending order is selected. When Unsorted is selected, the oldest portion of events is matched and then listed unsorted. f you changed the sort order preference after events were loaded, you must refresh the view to apply the new sort order.