Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
7070715
First draft
nastasha-solomon Aug 11, 2022
ac7f86e
Merge branch 'main' into issue-2265-insights
nastasha-solomon Aug 12, 2022
303d6ac
Expanding docs
nastasha-solomon Aug 16, 2022
8327070
Merge branch 'main' into issue-2265-insights
nastasha-solomon Aug 16, 2022
85f70d7
Minor edits
nastasha-solomon Aug 16, 2022
ffa8a6c
Updated image and added more info
nastasha-solomon Aug 16, 2022
cf4da0d
Additional edits
nastasha-solomon Aug 16, 2022
0369d30
New images
nastasha-solomon Aug 16, 2022
853a394
Revised section for alerts related by process ancestry
nastasha-solomon Aug 16, 2022
4ca425a
Updated images
nastasha-solomon Aug 16, 2022
f36b4ee
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 16, 2022
21e6e11
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 16, 2022
6df0cbb
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 16, 2022
80d8226
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 16, 2022
c537f88
Minor directional edit
nastasha-solomon Aug 16, 2022
49df827
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 17, 2022
9c32d3e
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 17, 2022
73a1ee7
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 17, 2022
72552ed
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 17, 2022
1bd988e
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 17, 2022
5f7036c
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 17, 2022
b82f23f
Joe's edits
nastasha-solomon Aug 17, 2022
f71b385
Changing license lang for consistency
nastasha-solomon Aug 17, 2022
a122e65
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 17, 2022
e3da1e6
Merge branch 'main' into issue-2265-insights
nastasha-solomon Aug 18, 2022
ffbb1ea
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 18, 2022
a62bf6b
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 18, 2022
5a3435b
Merge branch 'main' into issue-2265-insights
nastasha-solomon Aug 18, 2022
3989715
Update docs/detections/alerts-view-details.asciidoc
nastasha-solomon Aug 22, 2022
715072a
Merge branch 'main' into issue-2265-insights
nastasha-solomon Aug 22, 2022
61b9923
Janeen/Ben's input
nastasha-solomon Aug 22, 2022
7a02cd6
Merge branch 'main' into issue-2265-insights
nastasha-solomon Aug 23, 2022
b05aa64
Merge branch 'main' into issue-2265-insights
nastasha-solomon Aug 23, 2022
063d37b
Merge branch 'main' into issue-2265-insights
nastasha-solomon Aug 23, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 35 additions & 10 deletions docs/detections/alerts-view-details.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -22,29 +22,54 @@ image::images/alert-details-flyout.png[Alert details flyout]

The *Overview* tab summarizes the alert and shows relevant threat intelligence details. Use this information to understand what generated the alert so you can triage and resolve it.

The Overview tab contains these features:
The *Overview* tab contains these features:

* *Summary*: General details such as the alert's status, severity, risk score, and a link to the detection rule that produced the alert.
* *Summary*: Displays general details such as the alert's status, severity, risk score, and a link to the detection rule that produced the alert.

* *Reason statement*: A description of what generated the alert and provides general alert details. You can use this to understand the alert's origin and determine if the alert is relevant to your investigation.
* *Reason statement*: Provides a description of what generated the alert and provides general alert details. You can use this to understand the alert's origin and determine if the alert is relevant to your investigation.

* *Cases*: The total number and names of cases to which the alert has been added. Click a case's name to open its details.
* *Highlighted fields*: Surfaces the most relevant fields for the alert type. Use this to inform your triage efforts as you investigate the alert.

* *Highlighted fields*: The most relevant fields for the alert type. Use this section to inform your triage efforts as you investigate the alert.
+
NOTE: The *Session ID* field provides a unique ID for tracking a given Linux session and is stored in the `process.entry_leader.entity_id` field in the alert's document. To collect the session ID and other session data, you must enable the *Include session data* setting on your {endpoint-cloud-sec} integration policy. Refer to <<enable-session-view, Enable Session View data>> for more information.

* *Alert prevalence*: The total number of alerts within the selected timeframe that have identical values. For example, an alert prevalence of 3 for `host.name` means three alerts with the same `host.name` value exist within the timeframe.
* *Alert prevalence*: Shows the total number of alerts within the selected time frame that have identical values. For example, an alert prevalence of 3 for `host.name` means three alerts with the same `host.name` value exist within the time frame.
+
Alert prevalence data can help you investigate relationships with other alerts and gain context about the events producing alerts. You can also click the alert prevalence count to explore the alerts in Timeline.
+
IMPORTANT: Before investigating alert prevalence data in Timeline, save any Timelines you're working on to ensure you can access them later.

* *Enriched data*: Available threat indicator matches and threat intelligence data. This section only displays for alerts with intelligence data. Click the info icon to learn more about what data is collected. Refer to <<enriched-data-overview>> for more information.
* *Insights*: Shows relationships with associated alerts to help you quickly identify patterns. Refer to <<alert-details-insights, Insights on alerts>> for more information.

* *Enriched data*: Displays available threat indicator matches and threat intelligence data. This section only displays when examining alerts with intelligence data. Click the info icon to learn more about what data is collected. Refer to <<enriched-data-overview>> for more information.
+
[role="screenshot"]
image::images/enriched-data-info-icon.png[Informational message on enriched data, 600]

[discrete]
[[alert-details-insights]]
==== Insights on alerts

The Insights section shows you how an alert is related to other alerts and offers ways to investigate related alerts. You can use this information to quickly find patterns between alerts and then take action.

Within the Insights section, you can click on the title for each insight to expand or collapse it.

[role="screenshot"]
image::images/insights-section.png[Insights section in Alert details flyout, 600]

The Insights section provides the following details:

* *Cases related to the alert* - Shows the total number and names of cases to which the alert has been added. Click a case's name to open its details.
* *Alerts related by source event* - Shows the ten most recent alerts created by the same source event. This can help you find alerts with a shared origin and provide more context about the source event. Click the *Investigate in timeline* button to examine related alerts in Timeline.
* *Alerts related by session ID* - Shows the ten most recent alerts generated during the same <<session-view, session>>. These alerts share the same Session ID, which is a unique ID for tracking a given Linux session.
+
beta::[]
+
NOTE: This feature requires a https://www.elastic.co/pricing[Platinum or Enterprise subscription]. In addition, the *Include session data* setting must be enabled on your {endpoint-cloud-sec} integration policy. Refer to <<enable-session-view, Enable Session View data>> for more information.

* *Alerts related by process ancestry* - Shows alerts that are related by process events on the same linear branch. Note that alerts generated from processes on child or related branches are not shown. To further examine alerts, click *Investigate in timeline*.
+
beta::[]
+
NOTE: This feature requires a https://www.elastic.co/pricing[Platinum or Enterprise subscription]. In addition, to display it within the Insights section, you must also add the following feature flag to the `kibana.yml` file: `xpack.securitySolution.enableExperimental: ['insightsRelatedAlertsByProcessAncestry']`.

[discrete]
[[enriched-data-overview]]
==== Enriched data on alerts
Expand Down
Binary file modified docs/detections/images/alert-details-flyout.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/detections/images/insights-section.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.