﻿---
title: Turn on the risk scoring engine
description: You can preview risky entities before installing the latest risk engine. The preview shows the riskiest hosts, users, and services found in the 1000 sampled...
url: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4409/solutions/security/advanced-entity-analytics/turn-on-risk-scoring-engine
products:
  - Elastic Cloud Serverless
  - Elastic Security
---

# Turn on the risk scoring engine
<important>
  To use entity risk scoring, your role must have the appropriate user role or privileges. For more information, refer to [Entity risk scoring requirements](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4409/solutions/security/advanced-entity-analytics/entity-risk-scoring-requirements).
</important>


## Preview risky entities

You can preview risky entities before installing the latest risk engine. The preview shows the riskiest hosts, users, and services found in the 1000 sampled entities during the time frame selected in the date picker.
<note>
  The preview is limited to two risk scores per Kibana instance or serverless project.
</note>

To preview risky entities, find **Entity risk score** in the navigation menu or by using the [global search field](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4409/explore-analyze/find-and-organize/find-apps-and-objects).

## Turn on the latest risk engine

<note>
  - To view risk score data, you must have alerts generated in your environment.
  - In Elastic Stack, if you previously installed the original user and host risk score modules, and you’re upgrading to Elastic Stack version 9.0 or later, refer to [Upgrade to the latest risk engine](#upgrade-risk-engine).
</note>

If you’re installing the risk scoring engine for the first time:
1. Find **Entity risk score** in the navigation menu or using the [global search field](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4409/explore-analyze/find-and-organize/find-apps-and-objects).
2. On the **Entity risk score** page, turn the toggle on.
3. `stack: ga 9.2` `serverless: ga` Choose whether to retain [residual risk scores](/elastic/docs-content/pull/4409/solutions/security/advanced-entity-analytics/entity-risk-scoring#residual-risk-score).
4. Optionally, specify a date and time range for the calculation.
5. Choose whether to include `Closed` alerts in risk scoring calculations.
6. `stack: ga 9.3` `serverless: ga` Optionally, filter out alerts by defining conditions for the entity types or attributes that you want to exclude from the calculation. For example, if you don't want to calculate risk scores for users with a **Low impact** asset criticality level, enter `not user.asset.criticality: "low_impact"`.

![Turn on entity risk scoring](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4409/solutions/images/security-turn-on-risk-engine.png)


## Upgrade to the latest risk engine

```yaml
stack:
```

If you upgraded to 9.0 or later from an earlier Elastic Stack version, and you have the original risk engine installed, you can upgrade to the latest risk engine. You will be prompted to upgrade in places where risk score data exists, such as:
- The Entity Analytics dashboard
- The **User risk** tab on the Users page
- The **User risk** tab on a user’s details page
- The **Host risk** tab on the Hosts page
- The **Host risk** tab on a host’s details page

![Prompt to upgrade to the latest risk engine](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4409/solutions/images/security-risk-engine-upgrade-prompt.png)

1. Click **Manage** in the upgrade prompt, or find **Entity risk score** in the navigation menu.
2. On the Entity Risk Score page, click **Start update** next to the **Update available** label.
   ![Start the risk engine upgrade](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4409/solutions/images/security-risk-score-start-update.png)
3. On the confirmation message, click **Yes, update now**. The old transform is removed and the latest risk engine is installed.
4. When the installation is complete, confirm that the **Entity risk score** toggle is on.
   ![Turn on entity risk scoring](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4409/solutions/images/security-turn-on-risk-engine.png)

<note>
  Previous risk score data is retained when you upgrade to the latest risk engine.
</note>