elastic / elastic/integrations

[trellix_epo_on_prem] Improve ECS event categorization across threat_event, product_event, dlp_incident and syslog event data streams

Open
#20,828 1 comment 0 reactions 2 assignees Claimed by @brijesh-elastic View on GitHub
enhancement Team:SDE-Crest Team:Security-Service Integrations
Dominant language
Handlebars
Stars
333
Forks
647
Avg merge
3d 4h
Merged PRs (30d)
209

Description

Refines ECS categorization and severity mapping across four data streams, based on Trellix ePO event-code semantics validated against production event samples.

### `threat_event`
- Added event-code driven mappings for validated codes, setting `event.kind`, `event.action`, `event.category`, `event.type` and `event.outcome` per code instead of static values.
- Derived `event.outcome` dynamically from `ThreatActionTaken` and `ThreatHandled` so blocked, would-block (audit mode) and failed actions are distinguished.
- Mapped `ThreatSeverity` to ECS `event.severity` and removed the duplicate vendor field.
- Split `TargetPath` by destination type: registry hives (`HK*`) now map to `registry.path`, filesystem paths to `file.directory`.

### `product_event`
- Added mappings for validated `TVDEventID` codes, setting `event.action`, `event.kind` and `event.outcome`, and appending ECS-valid `event.category` and `event.type` values.
- Differentiated install vs. uninstall deployment events that share a single event code.

### `dlp_incident`
- Mapped incident `Severity` to ECS `event.severity` and removed the duplicate vendor field.

### `event` (syslog)
- Removed the blanket categorization that applied an identical `event.category` and `event.type` to every event regardless of content.
- Added event-code driven categorization for validated codes; unmapped events now carry only `event.kind` rather than asserting an incorrect category.
- Added `event.outcome` derived from `ThreatHandled`, `event.severity` from `ThreatSeverity`, and the same `TargetPath` registry/filesystem split.
- Normalized `event.action` to lowercase hyphenated form.

Pipeline tests, sample events, dashboards and documentation were updated accordingly.

Part of #20363.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.