Releases: elastic/ecs
Releases · elastic/ecs
ECS 1.0.0-beta2
This is the second 1.0.0 pre-release of ECS. From 1.0.0-beta2 to 1.0.0 GA, no further breaking changes and no additions or new fields are planned. All new contributions must go into the master branch.
Breaking changes
- Changed
device.*
fields toobserver.*
fields to eliminate user confusion. #238 - Rename
network.total.bytes
tonetwork.bytes
andnetwork.total.packets
tonetwork.packets
. #179 - Remove
network.inbound.bytes
,network.inbound.packets
,
network.outbound.bytes
andnetwork.outbound.packets
. #179 - Changed the
event.type
definition to be only reserved. #242
Bugfixes
- Fix obvious mistake in the definition of "source", where it said "destination"
instead of "source". #211
Added
- Add
host.name
field and clarify usage ofhost.hostname
. #187 - Add
event.start
andevent.end
date fields. #185 - Add
process.thread.id
field. #200 - Add
host.name
field and clarify usage ofhost.hostname
. - Add
event.start
andevent.end
date fields. - Create new
related
field set withrelated.ip
. #206 - Add
user.group
field. #204 - Create new
group
field set withgroup.id
andgroup.name
. #203 - Add
url.full
field. #207 - Add
process.executable
field. #209 - Add
process.working_directory
andprocess.start
. #215 - Reintroduce
http
. #237 - Add
user.full_name
field. #201 - Add
network.community_id
field. #208 - Add fields
geo.country_name
andgeo.region_iso_code
. #214 - Add
event.kind
andevent.outcome
. #242 - Add
client
andserver
objects and fields. #236 - Reintroduce a streamlined
user_agent
field set. #240, #262 - Add
geo.name
for ad hoc location names. #248 - Add
event.timezone
to allow for proper interpretation of incomplete timestamps. #258 - Add fields
source.address
,destination.address
,client.address
, and
server.address
. #247 - Add
os.full
to capture full OS name, including version. #259
Improvements
- Improved the definition of the file fields #196
- Improved the definition of the agent fields #192
- Improve definition of events, logs, and metrics in event section #194
- Improved the definition of network fields in intro section #197
- Improved the definition of host fields #195
- Improved the definitions for
event.category
andevent.action
. #242 - Clarify the semantics of
network.direction
. #212 - Add
source.bytes
,source.packets
,destination.bytes
anddestination.packets
. #179 - Add a readme section to declare some top level field sets are reserved for
future use. #257 - Clarify that
network.transport
,network.type
,network.application
,
andnetwork.protocol
must be lowercase. #251 - Clarify that
http.request.method
must be lowercase. #251 - Clarify that source/destination should be filled, even if client/server is
being used. #265
ECS 1.0.0-beta1
Changes
This is the first 1.0.0 pre-release of ECS. From 1.0.0-beta1 to 1.0.0 GA, no further breaking changes are expected. New fields might still be added.
Breaking changes
- Change structure of URL. #7
- Rename
url.href
multi_field
. #18 - Rename
geoip.*
togeo
. #58 - Rename log.message to log.original. #106
- Rename
event.raw
toevent.original
. #107 - Rename
user_agent.raw
touser_agent.original
and make it a keyword. #107 - Rename
file.path.raw
tofile.path.keyword
,file.target_path.raw
tofile.target_path.keyword
,
url.href.raw
tourl.href.keyword
,url.path.raw
tourl.path.keyword
,
url.query.raw
tourl.query.keyword
, andnetwork.name.raw
tonetwork.name.keyword
. #103 - Remove
log.offset
andlog.line
as too specific for ECS. #131 - Remove top level objects
kubernetes
andtls
. #132 - Remove
*.timezone.offset.sec
fields as too specific for ECS at the moment. #134 - Make the following fields keyword: device.vendor, file.path, file.target_path, http.response.body, network.name, organization.name, url.href, url.path, url.query, user_agent.original
- Rename
url.host.name
tourl.hostname
to better align with industry convention. #147 - Make the following fields keyword: device.vendor, file.path, file.target_path, http.response.body, network.name, organization.name, url.href, url.path, url.query, user_agent.original. #137
- Only two fields using
text
indexing at this time aremessage
anderror.message
.
- Only two fields using
- Rename
host.name
tohost.hostname
to better align with industry convention. #144 - Update definition of
service.type
andservice.name
. - Redefine purpose of
agent.name
field to be user defined field. - Rename
url.href
tourl.original
. - Remove
source.subdomain
anddestination.subdomain
fields. - Rename
event.version
toecs.version
. #169 - Remove the
http
field set temporarily. #171 - Remove the
user_agent
field set temporarily. #172 - Rename
url.hostname
tourl.domain
. #175 - Remove
source.hostname
anddestination.hostname
. #175
Added
- Add
network.total.packets
andnetwork.total.bytes
field. PR#2 - Add
event.action
field. #21 - Add
network.name
, to track network names in the monitoring pipeline. #25 - Adds cloud.account.id for top level organizational level. #11
- Add
http.response.status_code
andhttp.response.body
fields. #4 - Add fields for Operating System data. #5
- Add
log.message
. #3 - Add http.request.method and http.version
- Add
host.os.kernel
containing the OS kernel version. #60 - Add
agent.type
field. - Add
http.request.referrer
field. #164 - Add
network.type
,network.iana_number
,network.transport
and
network.application
. #81 and #170
Improvements
- Remove duplicate definitions of the reuseable
os
field set fromhost.os
and
user_agent.os
. #168