Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[1.x] add related.hosts (#913) #924

Merged
merged 2 commits into from
Aug 13, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.next.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ Thanks, you're awesome :-) -->
* Added missing field reuse of `pe` at `process.parent.pe` #868
* Added `span.id` to the tracing fieldset, for additional log correlation (#882)
* Added `event.reason` for the reason why an event's outcome or action was taken. #907
* Added `related.hosts` to capture all hostnames and host identifiers on an event. #913

#### Improvements

Expand Down
4 changes: 4 additions & 0 deletions code/go/ecs/related.go

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

16 changes: 16 additions & 0 deletions docs/field-details.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -4610,6 +4610,22 @@ Note: this field should contain an array of values.



| extended

// ===============================================================

| related.hosts
| All hostnames or other host identifiers seen on your event. Example identifiers include FQDNs, domain names, workstation names, or aliases.

type: keyword


Note: this field should contain an array of values.





| extended

// ===============================================================
Expand Down
7 changes: 7 additions & 0 deletions generated/beats/fields.ecs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3819,6 +3819,13 @@
using it to search for hashes can help in situations where you're unsure what
the hash algorithm is (and therefore which key name to search).
default_field: false
- name: hosts
level: extended
type: keyword
ignore_above: 1024
description: All hostnames or other host identifiers seen on your event. Example
identifiers include FQDNs, domain names, workstation names, or aliases.
default_field: false
- name: ip
level: extended
type: ip
Expand Down
1 change: 1 addition & 0 deletions generated/csv/fields.csv
Original file line number Diff line number Diff line change
Expand Up @@ -442,6 +442,7 @@ ECS_Version,Indexed,Field_Set,Field,Type,Level,Normalization,Example,Description
1.7.0-dev,true,registry,registry.path,keyword,core,,HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\winword.exe\Debugger,"Full path, including hive, key and value"
1.7.0-dev,true,registry,registry.value,keyword,core,,Debugger,Name of the value written.
1.7.0-dev,true,related,related.hash,keyword,extended,array,,All the hashes seen on your event.
1.7.0-dev,true,related,related.hosts,keyword,extended,array,,All the host identifiers seen on your event.
1.7.0-dev,true,related,related.ip,ip,extended,array,,All of the IPs seen on your event.
1.7.0-dev,true,related,related.user,keyword,extended,array,,All the user names seen on your event.
1.7.0-dev,true,rule,rule.author,keyword,extended,array,['Star-Lord'],Rule author
Expand Down
12 changes: 12 additions & 0 deletions generated/ecs/ecs_flat.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5717,6 +5717,18 @@ related.hash:
- array
short: All the hashes seen on your event.
type: keyword
related.hosts:
dashed_name: related-hosts
description: All hostnames or other host identifiers seen on your event. Example
identifiers include FQDNs, domain names, workstation names, or aliases.
flat_name: related.hosts
ignore_above: 1024
level: extended
name: hosts
normalize:
- array
short: All the host identifiers seen on your event.
type: keyword
related.ip:
dashed_name: related-ip
description: All of the IPs seen on your event.
Expand Down
12 changes: 12 additions & 0 deletions generated/ecs/ecs_nested.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6807,6 +6807,18 @@ related:
- array
short: All the hashes seen on your event.
type: keyword
related.hosts:
dashed_name: related-hosts
description: All hostnames or other host identifiers seen on your event. Example
identifiers include FQDNs, domain names, workstation names, or aliases.
flat_name: related.hosts
ignore_above: 1024
level: extended
name: hosts
normalize:
- array
short: All the host identifiers seen on your event.
type: keyword
related.ip:
dashed_name: related-ip
description: All of the IPs seen on your event.
Expand Down
4 changes: 4 additions & 0 deletions generated/elasticsearch/6/template.json
Original file line number Diff line number Diff line change
Expand Up @@ -2093,6 +2093,10 @@
"ignore_above": 1024,
"type": "keyword"
},
"hosts": {
"ignore_above": 1024,
"type": "keyword"
},
"ip": {
"type": "ip"
},
Expand Down
4 changes: 4 additions & 0 deletions generated/elasticsearch/7/template.json
Original file line number Diff line number Diff line change
Expand Up @@ -2092,6 +2092,10 @@
"ignore_above": 1024,
"type": "keyword"
},
"hosts": {
"ignore_above": 1024,
"type": "keyword"
},
"ip": {
"type": "ip"
},
Expand Down
10 changes: 10 additions & 0 deletions schemas/related.yml
Original file line number Diff line number Diff line change
Expand Up @@ -43,3 +43,13 @@
the hash algorithm is (and therefore which key name to search).
normalize:
- array

- name: hosts
level: extended
type: keyword
short: All the host identifiers seen on your event.
description: >
All hostnames or other host identifiers seen on your event. Example
identifiers include FQDNs, domain names, workstation names, or aliases.
normalize:
- array