About the Insight UI
This topic describes the Cloud SIEM UI for working with Insights.Â
Insights list page​
Classic UI. To open the Insights page, click Insights at the top of the screen.
New UI. To open the Insights page, in the main Sumo Logic menu select Cloud SIEM > Insights. You can also click Go To... at the top of the screen and select Insights.
By default, the Insights page presents all Insights whose status is not “Closed”, in descending order by event time in a list view. If you’d like to see Insights organized by their status, click the Show Board icon near the top right corner of the page. For information about the board view, see Board view.
Cloud SIEM displays Insights and the Signals attached to them in the Cloud SIEM UI through the end of the data retention period defined in your account agreement.Â
List view​
This screenshot shows the Insights page in List view.Â
Here’s one row from the List view. The numbered definitions below correspond to the labels in the screenshot.
- Creation date and time. When the Insight was created.
- Detection time. The time between when the first event happened (when the first Record in the Insight occurred) and when the Insight was generated. (This differs from "dwell time", which is the time between when the first Record and the last Record occurred in an Insight.)
- Age. The elapsed time since the Insight was created.
- Insight name. The Insight name, made up of the Insight ID, and the MITRE stage or stages associated with the Signals in the Insight.Â
- Related incidents. Incidents that share common Entities and other characteristics.
- Global Confidence. If sufficient data is available, a Global Confidence score for the Insight is shown.Â
- Assignee. The analyst assigned to the Incident.
- The MITRE ATT&CK tactics and techniques exhibited by the Insight.
- Severity. The severity of the Insight. The value is a function of the configured Entity Activity Score threshold for Insight generation. For more information, see About Insight Severity.
- Entity. The Entity associated with the Insight.
- Signal Data. This area has three bits of information:
- The count of Signals that caused the Insight to be created.
- The total count of Signals on the Insight Entity during the detection window.
- How long it's been since the last Signal fired associated with the Insight fired.
- The visualization plots the Insight's Signals over time (x-axis) by severity (y-axis).
Board view​
This screenshot shows the Insights page with the Signals organized as a board. Each of the columns corresponds to an Insight status value. (One of the status values shown is a custom Insight status).
The information displayed in the board view is similar to the information in the list view.Â
You can switch back to the list view by clicking the Show List icon, near the top right corner of the Cloud SIEM UI.
Filtering Insights ​
You can use the Filters area near the top of the page to narrow down the Insights that appear on the Insights page. You can filter by:
- Assignee
- Custom Resolution
- Created
- Entity
- Event Time
- Name
- Resolution
- Rule ID
- Severity
- Status
- Tags
Insight Details page​
From the HUD screen, list view, or board view, click an Insight's name to see its details.
Insight details pane​
The left pane of the Insight details page displays detailed information about the selected Insight. Some of the information that appears is the same as what’s in the row for an Insight on the Insights page, and is described in List view, above. The additional information that appears in the details pane is defined below.
- Actions. The Insight Actions defined in your environment.
- Close Insight. Use this option to close an Insight. When you click this option, you’re prompted to select an Insight resolution.
- Delete Icon. Use this option to delete an Insight. You’ll be prompted to confirm your choice.
- Status. Current status of the Insight.
- Assignee and Assign to me. Shows the current assignee and allows you to assign yourself the Insight.
- Entity. The Entity the Insight fired on.
- Severity. Severity of the Insight. Mouse over it to see an icon you can click to change the Insight severity.
- Global Confidence. The Global Confidence score for the Insight, if available.
- Related Incidents and Triages. Incidents and triages that are related to this Insight.
- Create Incident | Add to Incident. Create an incident for the Insight, or add the Insight to an existing incident.
- Signal Data. The number of Signals in the Insight.
- Event Time. The event time for the of the last Signal in the Insight.
- Detection Time. The time between when the first event happened (when the first Record in the Insight occurred) and when the Insight was generated. (This differs from "dwell time", which is the time between when the first Record and the last Record occurred in an Insight.)
- Insight Created. When the Insight was created.
- Tags and Create a tag. Displays any tags that have already been assigned to the Insight, and a field for adding a tag.
- Comments. Displays any comments that have been made on the Insight, and a field for adding a comment.
- Show Comments/History. The controls allow you to switch between viewing the Insight's comments and history.
Signal visualization area​
At the top of the Insight details page, you’ll see a Signal timeline that visualizes the Insight’s attached Signals, which are the Signals that caused the Insight to be created, and any Signals that have been manually added to the Insight.
- Signals. The Signals link allows you to switch back to the Signals view from the Enrichments view, described below.Â
- Entities. Click to view Entities on the Signal.
- Enrichments. Click this tab to view any enrichments that have been added to the Insight, including the output of the Insight Enrichment Server.
- Automations. Click to view automations on the Insight.
- Signal timeline. The timeline shows how spread apart each Signal in the Insight is. You can use the timeline to visualize how long these events are spread over and how often the Signals fire.Â
- Timeline controls. The arrows on the far left and right sides allow you to toggle between each Signal to show the details on each. You can also click a specific Signal on the timeline to jump to those details.Â
- Legend. Key to the symbols used to represent the Signals:
- Rule. Signals that were triggered by other rules.
- Anomaly. Signals that were triggered by User and Entity Behavior Analytics (UEBA) rules.
- Threat intelligence. Signals that were fired by Threat Intel rules.
- File Analysis. Signals that were triggered by Yara file analysis rules.
- Show Related. Click this link to show Related Signals in addition to Attached Signals. If you click the Show Related checkbox, the page updates and also displays any Related Signals or Related Insights.
- A Related Signal is a Signal that isn’t part of the current Insight (it’s not attached), but fired on the same Entity as the current Insight’s attached Signals within 7 days of the current Insight’s attached Signals.Â
- A Related Insight is an Insight that a Related Signal is attached to.
- Sort options. You can sort the Signals list by Content Type, Event Time, Created Time, Name, or Severity. Note that you can further sort by ascending or descending value.
- Add Signals. Click this option if you want to add a Signal to the Insight. You’ll be prompted with a list of Signals that have the same Entity as the current Insight (if there are any), and are not already attached to another Insight. A Signal that you add to an Insight manually is considered an Attached Signal.
Signal list area ​
Below the Signal timeline, you’ll see a list of Signals. By default, only attached Signals are displayed. Â
- Remove button. Removes multiple Signals selected with the checkbox. You cannot select all Signals for removal. If you do, the Remove button is disabled and this message appears when you hover over it with your mouse: Bulk removal of Signals is disabled as a minimum of 1 Signal must be attached to the Insight. Deselect 1 or more Signals to enable bulk removal.
- Checkbox. Click to select multiple Signals for removal.
- Signal name. Click to view Signal details.
- Remove button. Removes an individual Signal.
- Entity. The Entity associated with the Signal. Click to search for the Entity, or perform an action on the Entity.
Entities tab​
The Entities tab displays a list of one or more related Entities. This view helps a security analyst more quickly investigate the Insight to better understand the scope of a security issue that the Insight reveals. Many times, the most interesting Entity (perhaps the malicious actor) in an Insight is one of these related Entities.
An Insight is focused on a primary Entity. For example, the username or IP address that's found in each of the Insight's Signals. Related Entities expand the analyst’s view to include additional Entities that could be relevant to the Insight because they are either listed in the Records that belong to Signals in that Insight or Cloud SIEM has determined that they are the same Entity as one included in the Insight. For example, Cloud SIEM has determined that an IP address may have been associated with a specific hostname at the time the relevant Signal was generated.
The Entities tab includes two views, the list view and the graph view. Both views start with the same list of Related Entities. However, the graph view can show additional Entity relationships extending "outside" of the Insight.
About the Entities tab list view​
The screenshot below shows the Entities tab list view for an Insight.
In this view, the primary Entity is always displayed first. (This is the Entity common to each of the Signals in the Insight). Below the primary Entity all of the related Entities are listed.
The related Entities fall into two categories. The first category, sometimes referred to as involved Entities, are those Entities that aren't the primary Entity but are listed in one or more Records in the Signal(s) in the Insight. So, for example, while the primary Entity for an insight could be a username, a Record in one of the Signals in that Insight could also include an IP address. That address would be included in this list.
Other Entities could be included due to detected Entity relationships. For each Entity in the Insight — including the primary Entity and other involved Entities — Cloud SIEM searches for other Entities that seem to be related (across all Records, not just that Insight's). This search is run across a time range that corresponds to the span of time during which there was activity on the Insight. So, for example, if the first Record in an Insight was created at 8 AM on Wednesday and the last Record at 10 PM on Friday, Cloud SIEM might detect that the IP address listed in the Insight was associated with a specific hostname (in another record) at that point.
Involved Entities are connected to the primary Entity with dashed lines. Entities whose relationships are detected are labeled "May also be", indented, and connected with solid lines.
It's possible for a related Entity to both be involved and detected. In that case, it typically be displayed as detected unless it is in a number of the Insight's Signals.
How does Cloud SIEM detect Entity relationships outside of the Insight? Within the time range of the Insight, described above, Cloud SIEM searches for related Entities in the following normalized Record fields:
*_command
*_domain
*_email
*_file
*_hash
*_hostname
*_ip
*_mac
*_process
*_url
*_useragent
*_username
Custom Entities that match will also be included in the results.
What’s in an Entity card​
The card for an Entity displays any tags that have been assigned the Entity, along with the following information:
- The number of times that Entity was referenced in the Signals in the Insight.
- The number of Insights, created during the Insight generation detection window, in which the current Entity is the primary Entity.
note
The detection window is 14 days by default, but can be configured to be a different duration.
- The number of Signals that fired during the Insight generation detection window, in which the current Entity is the primary Entity, and the sum of the severities for those Signals.
note
The cumulative severity value is color coded: cyan for less than 12, orange for 12-23, and red for 24 and above, assuming your Insight generation threshold is 12. If the Insight threshold is set to a value other than the default of 12, the color coding will be adjusted to match.
About the Entities tab graph view​
The screenshot below shows the Entities tab graph view for an Insight.
By default, this view shows the same entities that are displayed on the list view. However, the system will look for additional relationships outside of the Insight during the detection window to aid in deeper investigation.
- Graph view. To switch between the list and graph view, click the chooser in the upper-right corner of the panel.
- Primary Entity. Each node in the graph represents a single Entity and will include an icon representing the Entity type and the value (name). The primary Entity for this Insight will be larger and centered by default.
- Involved Entities. As on the list view, the Entities that appear on the same Signal (also known as involved Entities) will be connected with dashed lines.
- Related Entities. Entities that are related to this Insight will have an Insight icon on their upper-left edge.
- Selected Entity. When you select an Entity, it will be highlighted in blue and the Entity details pane will appear on the right.
- Expand control. If Cloud SIEM has detected additional relationships outside of the Insight during the selected time frame, an expand/contract control will appear on the Entity. Clicking on that control will reveal (or hide) those additional relationships.
- Controls. The graph view has several controls:
- A key that explains how to read the graph
- Zoom controls (you can also use your mouse wheel)
- A screen size control, which toggles between the center pane view and a full browser window view.
- A reset control, which resets the view to the original default.
- A link to help.
- A filter control, which enables you to view only specific Entity types in the graph.
- A time frame control, which controls what time frame to use when searching for and viewing relationships outside of the Insight.
In addition, the following can appear in the graph:
- Detected Entities. Entities with a detected relationship will be connected with solid lines. A detected relationship is when a relationship is detected between Entities (for example, when an IP and hostname appear in a record together, but not necessarily in the insight being viewed).
- Threat indicators. Any Entity with a threat indicator will have an additional icon in the upper right. If the threat indicator is Malicious or Suspicious, the Entity will be highlighted in red or yellow accordingly.
- Hover. If you hover over an Entity, it and all connections to it will be highlighted in blue. If its value is not fully visible by default, the full value will be displayed.
Watch this micro lesson to learn more about the Entity relationship graph.
Entity details in the right pane​
When you select an Entity on the page, the right pane displays details about that Entity. The information displayed depends on what type of Entity is selected and can include:
- A Threat indicator (if any)
- A link to the Entity’s details page
- Geographic location
- Suppression Status
- Tags
- Entity Criticality, if it is set to something other than the default
- Metadata such as geographic location, Inventory information, the Network Blocks it falls within, as applicable, and so on.
- A Signal graph if the Entity was the primary Entity in any Signals during the detection window (time/date is the horizontal axis and severity of each Signal is the vertical axis; the icon/color for each point depends on the Signal type)
- Lists of the recent Signals and Insights the Entity has been associated with, and links to each object’s details page.
Accessing related Entities using the API​
You can access related Entity information using the Cloud SIEM API. For more information, see Cloud SIEM APIs.