Skip to content

Commit 8bff1ce

Browse files
Address feedback
1 parent ad3399c commit 8bff1ce

File tree

2 files changed

+15
-13
lines changed

2 files changed

+15
-13
lines changed

docs/advanced-entity-analytics/entity-store.asciidoc

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -9,17 +9,18 @@ preview::[]
99
To use the entity store, you must have the appropriate privileges. For more information, refer to <<ers-requirements, Entity risk scoring requirements>>.
1010
--
1111

12-
The entity store allows you to query, reconcile, maintain, and persist entity metadata from various sources such as:
12+
The entity store allows you to query, reconcile, maintain, and persist entity metadata such as:
1313

14-
* Ingested log sources
15-
* Integrated identity providers (such as Active Directory, EntraID, and Okta)
16-
* Internal and external alerts
17-
* External asset repositories
18-
* Asset criticality submissions
14+
* Ingested log data
15+
* Data from integrated identity providers (such as Active Directory, EntraID, and Okta)
16+
* Data from internal and external alerts
17+
* External asset repository data
18+
* Asset criticality data
19+
* Entity risk score data
1920

20-
The entity store can store any entity type observed by {elastic-sec}. This allows you to store, view, and query select entities directly from an index without needing to perform real-time searches of observable data. The entity store extracts entities from all indices in the {elastic-sec} <<default-data-view-security, default data view>>.
21+
The entity store can hold any entity type observed by {elastic-sec}. It allows you to view and query select entities represented in your indices without needing to perform real-time searches of observable data. The entity store extracts entities from all indices in the {elastic-sec} <<default-data-view-security, default data view>>.
2122

22-
When the entity store is enabled, the following resources are generated:
23+
When the entity store is enabled, the following resources are generated for each entity type (hosts and users):
2324

2425
* {es} resources, such as transforms, ingest pipelines, and enrich policies.
2526
* Data and fields for each entity.
@@ -40,7 +41,7 @@ Once you enable the entity store, the Entity Analytics dashboard displays the <<
4041
[[clear-entity-store]]
4142
== Clear entity store data
4243

43-
Once the entity store is enabled, you may want to start fresh and clear the extracted entity data. For example, if you have refined your data by normalizing the `user.name` or `host.name` fields, clearing the entity store data allows you to repopulate the entity store with the updated, normalized values. This action removes all previously extracted entity information, enabling new data extraction and analysis.
44+
Once the entity store is enabled, you may want to clear the stored data and start fresh. For example, if you normalized the `user.name` or `host.name` fields, clearing the entity store data would allow you to repopulate the entity store with the updated, normalized values. This action removes all previously extracted entity information, enabling new data extraction and analysis.
4445

4546
Clearing entity store data does not delete your source data, assigned entity risk scores, or asset criticality assignments.
4647

docs/dashboards/entity-dashboard.asciidoc

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ image::images/entity-dashboard.png[Entity dashboard]
2727
[float]
2828
== Entity KPIs (key performance indicators)
2929

30-
Displays the total number of critical hosts, critical users, and anomalies. Select a link to jump to the **Hosts** page, **Users** page, or the **Anomalies** table.
30+
Displays the total number of critical hosts, critical users, and anomalies. Select a link to jump to the **Hosts** page, **Users** page, or **Anomalies** table.
3131

3232
[[entity-user-risk-scores]]
3333
[float]
@@ -92,19 +92,20 @@ preview::[]
9292
To display the **Entities** section, you must <<enable-entity-store,enable the entity store>>.
9393
--
9494

95-
The **Entities** section provides a centralized view of all hosts and users in your environment. It displays entities stored in the <<entity-store, entity store>>, which:
95+
The **Entities** section provides a centralized view of all hosts and users in your environment. It displays entities from the <<entity-store, entity store>>, which meet any of the following criteria:
9696

9797
* Have been observed by {elastic-sec}
9898
* Have an asset criticality assignment
9999
* Have been added to {elastic-sec} through an integration, such Active Directory or Okta
100100

101-
NOTE: The **Entities** table only shows a subset of the attributes stored in the entity store. You can query the `.entities.v1.latest.security_user_<space-id>` and `.entities.v1.latest.security_host_<space-id>` indices to see all the attributes stored in the entity store.
101+
NOTE: The **Entities** table only shows a subset of the data available for each entity. You can query the `.entities.v1.latest.security_user_<space-id>` and `.entities.v1.latest.security_host_<space-id>` indices to see all the fields for each entity in the entity store.
102102

103103
[role="screenshot"]
104104
image::images/entities-section.png[Entities section]
105105

106-
The stored entity data appears in the **Entities** section based on the following timelines:
106+
Entity data from different sources appears in the **Entities** section based on the following timelines:
107107

108+
* When you first enable the entity store, only data stored in the last 24 hours is processed. After that, data is processed continuously.
108109
* Observed events from the {elastic-sec} default data view are processed in near real-time.
109110
* Entity Analytics data, such as entity risk scores and asset criticality (including bulk asset criticality upload), is also processed in near real-time.
110111
* The availability of entities extracted from Entity Analytics integrations depends on the specific integration. Refer to {integrations-docs}/entityanalytics_ad[Active Directory Entity Analytics], {integrations-docs}/entityanalytics_entra_id[Microsoft Entra ID Entity Analytics], and {integrations-docs}/entityanalytics_okta[Okta Entity Analytics] for more details.

0 commit comments

Comments
 (0)