Event Investigation
Event Investigation searches the behavior events recorded by endpoint agents and traces the execution relationships of the processes that caused them. Use it to verify the detection evidence seen in the threat details, or to look for behavior that was not detected.
Layout
| Area | Description |
|---|---|
| Tabs | Investigation tabs, each keeping its own search conditions |
| Toolbar | Search box, search history, favorite, event types, period, search filter, time chart, ATT&CK, settings |
| Left | Search filter |
| Center | Time chart and event list |
| Right | Event Details of the selected event |
Tabs
Each tab keeps its own keyword, period, event types and search filter. Switching to another tab and back shows the previous result as it was.
- Click + to add an empty tab
- Hold Ctrl and click + to add a tab with a copy of the current tab's conditions
- Up to five tabs can be open
- The tab title shows the keyword of that tab
Searching events
Keyword
Type in the search box and press Enter. How the input is searched depends on its form.
| Input | Search |
|---|---|
A word without : or parentheses | Keyword search. Searched in the field list of the console settings for IPs, hashes or other strings, depending on what the input looks like |
field:value | Searched with the Lucene query syntax |
powershell.exe
192.168.10.25
EventSubType:ProcessStart AND ProcName:powershell.exe
RemoteIP:"203.0.113.7" AND RemotePort:443
Typing a field name opens an autocomplete list, and after field: the values present in the current
period and event types are suggested. Running a new search clears the search filter selection.
Event types
Choose the event types to query with the Process, File, Module, Network, Registry buttons in the toolbar. Each click toggles a type on or off, and only the selected types are queried.
Period
Set the period with the period picker. See Selecting a period in the User Guide.
Search History and Favorite
Click the Search History button to the right of the search box to show the recent searches and favorites.
| Item | Description |
|---|---|
| Recent Search History | Up to 50 keywords with the period they ran on. Click an entry to fill in the keyword and period, then press Enter to search. Entries can be deleted one by one or all at once with Delete all |
| Favorite | Saved favorites. Click an entry to restore the keyword, period, event types and search filter selection together |
Recent searches are stored in the browser you use. Favorites are stored in the personal settings of the console, so they follow the console account.
Click the Favorite button (star) to open Add Favorite and save the current search conditions. Enter a name and query; the event types and period are saved as they are. When the current conditions are already a saved favorite the star is yellow, and clicking it opens Edit Favorite to change the name and query or delete the favorite. Two favorites cannot share a name.
Search filter
The Search filter on the left shows the current results as counts per field value. The default fields are Event, Detection, Technique and Tag, following the console settings. Click a value to narrow the results to it, and click All to clear the selection of that field.
- One value can be selected per field, and the selections of different fields are combined with AND
- Clicking a value does not change the counts of the other fields. Counts are aggregated again when the keyword, event types or period change, or when you click Refresh
- Click the magnifier icon to search the values of that field
The settings menu in the header offers the following.
| Menu | Function |
|---|---|
| Edit filter | Choose the fields shown in the search filter, up to five |
| Reset filter | Clears the selection of every field |
The Search filter button in the toolbar shows or hides the search filter.
Time Chart
The time chart above the event list shows event counts over the period in time buckets. The bars are colored by event type.
- Drag over a range in the chart to narrow the period to it. Click Back to return to the period before narrowing
- Click Move to previous time period or Move to next time period (the left and right arrows) to move to the previous or next period of the same length
The Time Chart button in the toolbar shows or hides the time chart.
Event list
| Column | Description |
|---|---|
| Event Time | When the event occurred |
| Type | A dot in the color of the detection type when the event was detected |
| Event | Sub type of the event. e.g. ProcessStart, FileCreate |
| Summary | The event described in a sentence |
| Tag / Technique | Tags and attack techniques recorded on the event |
| User IP / Username / Hostname | The endpoint where the event occurred |
The shown columns follow the console settings. Click a column header to sort by that column. Hover over a row to see the whole summary as a tooltip. Choose 10, 30, 50 or 100 rows per page.
Adding conditions from values
Click a cell value or a link in the summary as follows to add a search condition.
| Action | Result |
|---|---|
| Alt + click | Adds field:"value" to the current keyword with AND and searches |
| Ctrl + click | Opens a new tab searching that condition |
Settings menu
The settings button at the right end of the toolbar offers the following.
| Menu | Function |
|---|---|
| Edit column | Choose the shown columns and their order |
| Reset column | Returns the columns to the console default |
| Export to Excel | Saves the results with the shown columns as an xlsx file |
| Export Data Source | Saves every field of the events, unformatted, as an xlsx file |
Both exports save up to 5,000 events in the current sort order.
ATT&CK matrix
Click the ATT&CK button in the toolbar to show the current results as a MITRE ATT&CK matrix. The matrix is laid over the event list; click the button again to close it.
- The numbers of matching Tactics, Techniques and Event are shown at the top
- Techniques with events are highlighted in orange with their count
- A technique with sub-techniques shows
(sub-techniques with events/all sub-techniques); click the arrow to expand them
| Option | Description |
|---|---|
| Sub-techniques | Expands the sub-techniques of every technique |
| All techniques | Also shows techniques without events. Unchecked, only techniques with events are shown |
| Select OS | Shows only the matrix and events of the selected OS |
Click the name of a tactic, technique or sub-technique, or the event count, to add the matching condition to the keyword with AND; the matrix closes and the search runs.
| Clicked | Condition added |
|---|---|
| Tactic | TacticID:"TA0002" |
| Technique | TechniqueID:T1059* (including sub-techniques) |
| Sub-technique | TechniqueID:"T1059.001" |
| Event count | TechniqueID:* |
With an OS selected, an OS condition such as OS:"Windows" AND is added as well.
Event Details
Click a row in the list to show the Event Details on the right. It draws a story line graph centered on the process that caused the event, with its parent and child processes and related events.
- Click a node to show its execution information, threat information, events, file information and endpoint information in the node detail panel
- Click the Time Chart button in the corner of the graph to show the events of the processes in the story line as a chart and a list. Click a row in the list to switch the node detail panel to that event. Click the button again to return to the graph
Change how the graph is built with the Chart button. Changing an option builds the graph again.
| Option | When checked |
|---|---|
| Show only related events | Shows only events on the same target (file, registry key, network address) as the selected event, and child processes only one level deep |
| Categorized by event type | Groups child items by event. Unchecked, they are grouped by target such as file name, registry key, or IP and port |
| Show all parent process | Shows every parent process up to the topmost one. Unchecked, only the direct parent is shown |
The buttons in the title bar change how the details are shown.
| Button | Function |
|---|---|
| Full Screen | Shows the event details in full screen |
| New Window | Shows the details in a window in the center of the screen. In the window, Back to panel returns to the right panel |
| Close | Closes the event details |
Actions in the node detail panel
Expand an event in the event list of the node detail panel to show the Action menu. Only the entries that apply to the event are shown.
| Menu | Shown when | Function |
|---|---|---|
| Generate process dump | A process start event whose process has not exited | Asks the endpoint to create a process dump |
| Kill Process | A process start event whose process has not exited | Asks the endpoint to terminate the process |
| Collect sample | A file of a collectable type. File delete events excluded | Asks the endpoint to collect the file |
After a sample collection request, the app asks whether to move to Collected Files. Click Move to open Collected Files searched by that file name. Collection takes time and may fail.
Opening Event Investigation from other screens
In Threat Management, the threat details and the node detail panel, clicking a file name, hash or IP value opens a menu. Click Search file name in event history, Search hasn in event history or Search ip in event history to open an Event Investigation window searching that value as a keyword. The period is one day before and after the time of that event.
The other entries of the menu are available only in the console and are shown disabled.
The next page is Collected Files.