Entity Behaviors Layer
In brief
The article now describes anomaly insights on behavior records, including first-seen activity, unusual volumes, uncommon values, and threat-intelligence matches. It also clarifies entity-enrichment queries, supported Fortinet data, and the requirement for actively sending logs.
What Defender admins need to know
Verify that supported data sources are connected and actively sending logs to generate behaviors, and use the linked anomaly guidance during investigations.
Summaries are generated from the documentation change itself.
Documentation change
The comparison below shows only the changed extract. Use the full-page view for complete context.
The UEBA behaviors layer enables faster threat detection, investigation, and response across your security operations, without requiring deep familiarity with every log source.
This articlesection explains how the UEBA behaviors layer works, how to enable the behaviors layer, and how to use behaviors to enhance security operations.
Watch the UEBA behaviors webinar for a full overview and demo of the UEBA behaviors layer.
| Alerts | Signal a potential security issue requiring attention | Trigger incident response workflows | | Behaviors | Neutral, structured summaries of activity - normal or abnormal- based on time windows or triggers, enriched with MITRE ATT&CK mappings and entity roles | Provide context and clarity for investigations, hunting, and detection |
Microsoft Sentinel can also add anomaly insights directly to behavior records, including first-seen activity, unusually high behavior volumes, uncommon values, and threat intelligence matches. For more information, see Investigate anomalies on UEBA behaviors.
Behavior types and records
When you enable the UEBA behaviors layer, Microsoft Sentinel processes supported security logs you collect into your Sentinel workspace in near real-time and summarizes two types of behavioral patterns: | Aggregated behaviors | Detect volume-based patterns by collecting related events over time windows |
- User accessed 50+ resources in 1 hour
- Login attempts from 10+ different IP addresses
The UEBA behaviors layer summarizes behaviors at tailored time intervals specific to each behavior's logic, creating behavior records immediately when itthe UEBA behaviors layer identifies patterns or when the time windows close.
Each behavior record includes:
The behaviors abstraction layer
ThisThe following data-flow diagram illustratesshows how the UEBA behaviors layer transforms raw logs into structured behavior records that enhance security operations:
:::image type="content" source="media/entity-behaviors-layer/entity-behaviors-data-flow.svg" alt-text="Diagram that shows how the UEBA behaviors layer transforms raw logs into structured behavior records that enhance security operations." lightbox="media/entity-behaviors-layer/entity-behaviors-data-flow.svg" :::
| project TimeGenerated, Title, Description, TableName
```
Specific user —
retrieve alljoin behavior records with entity data to list behaviorsassociated withfor a particular user over the last 7days to build a complete activity timeline:days, showing each behavior's timestamp, title, description, and category:// Find all behaviors for a specific user over last 7 days
| Data source | Supported vendors, services, and logs | Connector | Supported behaviors |
|---|---|---|---|
| CommonSecurityLog1 |
|
||
| AWSCloudTrail |
|
||
| GCPAuditLogs |
|
To use the UEBA behaviors layer, you need:
- A Microsoft Sentinel workspace that's onboarded to the Defender portal.
IngestConnect and actively send logs from at least oneor more of thesupported data source into the Analytics tier. The UEBA behaviors layer only generates behaviors when supported data sources are connected and actively sending logs. For more information about data tiers, see Manage data tiers and retention in Microsoft Sentinel.
Permissions required
Use the BehaviorId field to join BehaviorInfo with BehaviorEntities.
The following query correlates recentjoins BehaviorInfo with BehaviorEntities to enrich behavior records from the last day with their associated entities,related entity details, so you can see each behavior alongside the users, hosts, or IP addresses involved:involved during an investigation:
BehaviorInfo
@@ -4,11 +4,11 @@ description: The Microsoft Sentinel UEBA behaviors layer translates security tel ms.author: guywild author: guywi-ms ms.reviewer: mshechter-ms.date: 06/15/2026+ms.date: 07/02/2026 ms.topic: how-to ms.service: microsoft-sentinel ai-usage: ai-assisted-ms.custom: msecd-doc-authoring-1014+ms.custom: msecd-doc-authoring-1016 #Customer intent: As a security analyst, I want to use the UEBA behaviors layer to translate raw security telemetry into human-readable patterns with MITRE ATT&CK context for faster threat detection and investigation. --- @@ -25,7 +25,7 @@ Unlike alerts or anomalies, behaviors don’t necessarily indicate risk - they c The UEBA behaviors layer enables faster threat detection, investigation, and response across your security operations, without requiring deep familiarity with every log source. -This article explains how the UEBA behaviors layer works, how to enable the behaviors layer, and how to use behaviors to enhance security operations. +This section explains how the UEBA behaviors layer works, how to enable the behaviors layer, and how to use behaviors to enhance security operations. Watch the [UEBA behaviors webinar](https://www.youtube.com/watch?v=SqbxmGdMP7c) for a full overview and demo of the UEBA behaviors layer. @@ -42,6 +42,8 @@ The following table shows how behaviors differ from anomalies and alerts: | **Alerts** | Signal a potential security issue requiring attention | Trigger incident response workflows | | **Behaviors** | Neutral, structured summaries of activity - normal or abnormal- based on time windows or triggers, enriched with MITRE ATT&CK mappings and entity roles | Provide context and clarity for investigations, hunting, and detection | +Microsoft Sentinel can also add anomaly insights directly to behavior records, including first-seen activity, unusually high behavior volumes, uncommon values, and threat intelligence matches. For more information, see [Investigate anomalies on UEBA behaviors](ueba-anomalies-on-behaviors.md).+ ### Behavior types and records When you [enable the UEBA behaviors layer](#enable-the-ueba-behaviors-layer), Microsoft Sentinel processes supported security logs you collect into your Sentinel workspace in near real-time and summarizes two types of behavioral patterns:@@ -51,7 +53,7 @@ When you [enable the UEBA behaviors layer](#enable-the-ueba-behaviors-layer), Mi | **Aggregated behaviors** | Detect volume-based patterns by collecting related events over time windows | <ul><li>User accessed 50+ resources in 1 hour</li><li>Login attempts from 10+ different IP addresses</li></ul> | Convert high-volume logs into actionable security insights. This behavior type excels at identifying unusual activity levels. | | **Sequenced behaviors** | Identify multi-step patterns or complex attack chains that aren't obvious when you look at individual events | Access key created > used from new IP > privileged API calls | Detect sophisticated attack sequences and multi-stage threats. | -The UEBA behaviors layer summarizes behaviors at tailored time intervals specific to each behavior's logic, creating behavior records immediately when it identifies patterns or when the time windows close.+The UEBA behaviors layer summarizes behaviors at tailored time intervals specific to each behavior's logic, creating behavior records immediately when the UEBA behaviors layer identifies patterns or when the time windows close. Each behavior record includes: @@ -62,7 +64,7 @@ Each behavior record includes: ### The behaviors abstraction layer -This diagram illustrates how the UEBA behaviors layer transforms raw logs into structured behavior records that enhance security operations:+The following data-flow diagram shows how the UEBA behaviors layer transforms raw logs into structured behavior records that enhance security operations: :::image type="content" source="media/entity-behaviors-layer/entity-behaviors-data-flow.svg" alt-text="Diagram that shows how the UEBA behaviors layer transforms raw logs into structured behavior records that enhance security operations." lightbox="media/entity-behaviors-layer/entity-behaviors-data-flow.svg" ::: @@ -144,7 +146,7 @@ Behaviors allow hunters to search on TTPs and activity summaries, rather than wr | project TimeGenerated, Title, Description, TableName ``` - - Specific user — retrieve all behaviors associated with a particular user over the last 7 days to build a complete activity timeline:+ - Specific user — join behavior records with entity data to list behaviors for a particular user over the last 7 days, showing each behavior's timestamp, title, description, and category: ```kusto // Find all behaviors for a specific user over last 7 days@@ -197,7 +199,7 @@ The UEBA behaviors layer currently focuses on these non-Microsoft data sources t | Data source | Supported vendors, services, and logs | Connector | Supported behaviors | |-------------|---------------------------|-------|----------------|-| [CommonSecurityLog](/azure/azure-monitor/reference/tables/commonsecuritylog)<sup>1</sup> | <ul><li>Cyber Ark Vault</li><li>Palo Alto Threats</li></ul> | | <ul><li>[CommonSecurityLog behaviors](https://github.com/Azure/Azure-Sentinel/blob/master/Sentinel%20Behaviors/Behaviors%20Rules/commonsecuritylog_behaviors.md)</li></ul> |+| [CommonSecurityLog](/azure/azure-monitor/reference/tables/commonsecuritylog)<sup>1</sup> | <ul><li>Cyber Ark Vault</li><li>Palo Alto Threats</li><li>Fortinet</li></ul> | | <ul><li>[CommonSecurityLog behaviors](https://github.com/Azure/Azure-Sentinel/blob/master/Sentinel%20Behaviors/Behaviors%20Rules/commonsecuritylog_behaviors.md)</li></ul> | | [AWSCloudTrail](/azure/azure-monitor/reference/tables/awscloudtrail) | <ul><li>EC2</li><li>IAM</li><li>S3</li><li>EKS</li><li>Secrets Manager</li></ul> |<ul><li>[Amazon Web Services](../sentinel/data-connectors-reference.md#amazon-web-services)</li><li>[Amazon Web Services S3](../sentinel/data-connectors-reference.md#amazon-web-services-s3)</li></ul> | <ul><li>[AWS CloudTrail behaviors](https://github.com/Azure/Azure-Sentinel/blob/master/Sentinel%20Behaviors/Behaviors%20Rules/aws_cloudtrail_behaviors.md)</li></ul> | |[GCPAuditLogs](/azure/azure-monitor/reference/tables/gcpauditlogs) |<ul><li>Admin activity logs</li><li>Data access logs</li><li>Access transparency logs</li></ul>|<ul><li>[GCP Pub/Sub Audit Logs](../sentinel/data-connectors-reference.md#gcp-pubsub-audit-logs)</li></ul>| <ul><li>[GCP Audit Logs behaviors](https://github.com/Azure/Azure-Sentinel/blob/master/Sentinel%20Behaviors/Behaviors%20Rules/gcp_auditlogs_behaviors.md)</li></ul> | @@ -213,7 +215,7 @@ The UEBA behaviors layer currently focuses on these non-Microsoft data sources t To use the UEBA behaviors layer, you need: - A Microsoft Sentinel workspace that's onboarded to the Defender portal.-- Ingest one or more of the [supported data sources](#supported-data-sources-and-behaviors) into the Analytics tier. For more information about data tiers, see [Manage data tiers and retention in Microsoft Sentinel](../sentinel/manage-data-overview.md#how-data-tiers-and-retention-work).+- Connect and actively send logs from at least one [supported data source](#supported-data-sources-and-behaviors) into the Analytics tier. The UEBA behaviors layer only generates behaviors when supported data sources are connected and actively sending logs. For more information about data tiers, see [Manage data tiers and retention in Microsoft Sentinel](../sentinel/manage-data-overview.md#how-data-tiers-and-retention-work). ## Permissions required @@ -300,7 +302,7 @@ For more information about Kusto Query Language (KQL), see [Kusto query language Use the `BehaviorId` field to join `BehaviorInfo` with `BehaviorEntities`. - The following query correlates recent behavior records with their associated entities, so you can see each behavior alongside the users, hosts, or IP addresses involved:+ The following query joins `BehaviorInfo` with `BehaviorEntities` to enrich behavior records from the last day with related entity details, so you can see each behavior alongside the users, hosts, or IP addresses involved during an investigation: ```kusto BehaviorInfo 