Skip to content

Commit

Permalink
Risk score calculation for closed alerts
Browse files Browse the repository at this point in the history
  • Loading branch information
natasha-moore-elastic committed Dec 4, 2024
1 parent 09040ae commit 5bacbe9
Show file tree
Hide file tree
Showing 4 changed files with 10 additions and 2 deletions.
2 changes: 2 additions & 0 deletions docs/advanced-entity-analytics/entity-risk-scoring.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,8 @@ NOTE: Entities without any alerts, or with only `Closed` alerts, are not assigne
== How is risk score calculated?

. The risk scoring engine runs hourly to aggregate `Open` and `Acknowledged` alerts from the last 30 days. For each entity, the engine processes up to 10,000 alerts.
+
NOTE: When <<turn-on-risk-engine, turning on the risk engine>>, you can choose to also include `Closed` alerts in risk scoring calculations.

. The engine groups alerts by `host.name` or `user.name`, and aggregates the individual alert risk scores (`kibana.alert.risk_score`) such that alerts with higher risk scores contribute more than alerts with lower risk scores. The resulting aggregated risk score is assigned to the **Alerts** category in the entity's <<host-risk-summary, risk summary>>.

Expand Down
4 changes: 3 additions & 1 deletion docs/advanced-entity-analytics/turn-on-risk-engine.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,9 @@ image::images/preview-risky-entities.png[Preview of risky entities]
If you're installing the risk scoring engine for the first time:

. Find **Entity Risk Score** in the navigation menu.
. Turn the **Entity risk score** toggle on.
. On the **Entity Risk Score** page, turn the toggle on.

You can also choose to include `Closed` alerts in risk scoring calculations and specify a date and time range for the calculation.

[role="screenshot"]
image::images/turn-on-risk-engine.png[Turn on entity risk scoring]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,8 @@ Entities without any alerts, or with only `Closed` alerts, are not assigned a ri
== How is risk score calculated?

. The risk scoring engine runs hourly to aggregate `Open` and `Acknowledged` alerts from the last 30 days. For each entity, the engine processes up to 10,000 alerts.
+
NOTE: When <<security-turn-on-risk-engine, turning on the risk engine>>, you can choose to also include `Closed` alerts in risk scoring calculations.
. The engine groups alerts by `host.name` or `user.name`, and aggregates the individual alert risk scores (`kibana.alert.risk_score`) such that alerts with higher risk scores contribute more than alerts with lower risk scores. The resulting aggregated risk score is assigned to the **Alerts** category in the entity's <<security-hosts-overview-host-risk-summary,risk summary>>.
. The engine then verifies the entity's <<security-asset-criticality,asset criticality level>>. If there is no asset criticality assigned, the entity risk score remains equal to the aggregated score from the **Alerts** category. If a criticality level is assigned, the engine updates the risk score based on the default risk weight for each criticality level. The asset criticality risk input is assigned to the **Asset Criticality** category in the entity's risk summary.
+
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,9 @@ To view risk score data, you must have alerts generated in your environment.
If you're installing the risk scoring engine for the first time:

. Go to **Project settings** → **Management** → **Entity Risk Score**.
. Turn the **Entity risk score** toggle on.
. On the **Entity Risk Score** page, turn the toggle on.

You can also choose to include `Closed` alerts in risk scoring calculations and specify a date and time range for the calculation.

[role="screenshot"]
image::images/turn-on-risk-engine/turn-on-risk-engine.png[Turn on entity risk scoring]

0 comments on commit 5bacbe9

Please sign in to comment.