Skip to content

Commit eaecbe7

Browse files
authored
Promote beta fields to GA in v9.x (#2411)
Promote beta fields that have been present since the previous major release to GA * cloud.origin * cloud.target * elf fields * event.kind->asset type * faas fields * host.boot_id * host.pid_ns_inode * volume fields
1 parent 9a39b89 commit eaecbe7

File tree

14 files changed

+28
-91
lines changed

14 files changed

+28
-91
lines changed

CHANGELOG.next.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@ Thanks, you're awesome :-) -->
2323

2424
#### Improvements
2525

26+
* Promote beta fields to GA. #2411
2627
* Define base encoding of `x509.serial_number`. #2383
2728
* Restrict the encoding of `x509.serial_number` to base 16. #2398
2829
* Set synthetic_source_keep = none on fields that represent sets. #2422

docs/fields/field-details.asciidoc

Lines changed: 10 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -821,17 +821,15 @@ Note also that the `cloud` fields may be used directly at the root of the events
821821

822822

823823
| `cloud.origin.*`
824-
| <<ecs-cloud,cloud>>| beta:[ Reusing the `cloud` fields in this location is currently considered beta.]
825-
826-
Provides the cloud information of the origin entity in case of an incoming request or event.
824+
| <<ecs-cloud,cloud>>
825+
| Provides the cloud information of the origin entity in case of an incoming request or event.
827826

828827
// ===============================================================
829828

830829

831830
| `cloud.target.*`
832-
| <<ecs-cloud,cloud>>| beta:[ Reusing the `cloud` fields in this location is currently considered beta.]
833-
834-
Provides the cloud information of the target entity in case of an outgoing request or event.
831+
| <<ecs-cloud,cloud>>
832+
| Provides the cloud information of the target entity in case of an outgoing request or event.
835833

836834
// ===============================================================
837835

@@ -2327,8 +2325,6 @@ image:https://img.shields.io/badge/OpenTelemetry-4a5ca6?style=flat&logo=opentele
23272325

23282326
These fields contain Linux Executable Linkable Format (ELF) metadata.
23292327

2330-
beta::[ These fields are in beta and are subject to change.]
2331-
23322328
[discrete]
23332329
==== ELF Header Field Details
23342330

@@ -4020,8 +4016,6 @@ example: `https://mysystem.example.com/alert/5271dedb-f5b0-4218-87f0-4ac4870a38f
40204016

40214017
The user fields describe information about the function as a service (FaaS) that is relevant to the event.
40224018

4023-
beta::[ These fields are in beta and are subject to change.]
4024-
40254019
[discrete]
40264020
==== FaaS Field Details
40274021

@@ -4673,9 +4667,8 @@ Note also that the `file` fields may be used directly at the root of the events.
46734667

46744668

46754669
| `file.elf.*`
4676-
| <<ecs-elf,elf>>| beta:[ This field reuse is beta and subject to change.]
4677-
4678-
These fields contain Linux Executable Linkable Format (ELF) metadata.
4670+
| <<ecs-elf,elf>>
4671+
| These fields contain Linux Executable Linkable Format (ELF) metadata.
46794672

46804673
// ===============================================================
46814674

@@ -5242,9 +5235,7 @@ image:https://img.shields.io/badge/OpenTelemetry-4a5ca6?style=flat&logo=opentele
52425235
[[field-host-boot-id]]
52435236
<<field-host-boot-id, host.boot.id>>
52445237

5245-
a| beta:[ This field is beta and subject to change. ]
5246-
5247-
Linux boot uuid taken from /proc/sys/kernel/random/boot_id. Note the boot_id value from /proc may or may not be the same in containers as on the host. Some container runtimes will bind mount a new boot_id value onto the proc file in each container.
5238+
a| Linux boot uuid taken from /proc/sys/kernel/random/boot_id. Note the boot_id value from /proc may or may not be the same in containers as on the host. Some container runtimes will bind mount a new boot_id value onto the proc file in each container.
52485239

52495240
type: keyword
52505241

@@ -5512,9 +5503,7 @@ image:https://img.shields.io/badge/OpenTelemetry-4a5ca6?style=flat&logo=opentele
55125503
[[field-host-pid-ns-ino]]
55135504
<<field-host-pid-ns-ino, host.pid_ns_ino>>
55145505

5515-
a| beta:[ This field is beta and subject to change. ]
5516-
5517-
This is the inode number of the namespace in the namespace file system (nsfs). Unsigned int inum in include/linux/ns_common.h.
5506+
a| This is the inode number of the namespace in the namespace file system (nsfs). Unsigned int inum in include/linux/ns_common.h.
55185507

55195508
type: keyword
55205509

@@ -9070,9 +9059,8 @@ The externally attested user based on an external source such as the Kube API.
90709059

90719060

90729061
| `process.elf.*`
9073-
| <<ecs-elf,elf>>| beta:[ This field reuse is beta and subject to change.]
9074-
9075-
These fields contain Linux Executable Linkable Format (ELF) metadata.
9062+
| <<ecs-elf,elf>>
9063+
| These fields contain Linux Executable Linkable Format (ELF) metadata.
90769064

90779065
// ===============================================================
90789066

@@ -13407,8 +13395,6 @@ Note also that the `vlan` fields are not expected to be used directly at the roo
1340713395

1340813396
Fields related to storage volume details.
1340913397

13410-
beta::[ These fields are beta and are subject to change.]
13411-
1341213398
[discrete]
1341313399
==== Volume Field Details
1341413400

docs/fields/field-values.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -64,8 +64,6 @@ This value is not used by Elastic solutions for alert documents that are created
6464
[[ecs-event-kind-asset]]
6565
==== asset
6666

67-
beta:[ This event categorization value is beta and subject to change. ]
68-
6967
This value indicates events whose primary purpose is to store an inventory of assets/entities and their attributes. Assets/entities are objects (such as users and hosts) that are expected to be subjects of detailed analysis within the system.
7068

7169
Examples include lists of user identities or accounts ingested from directory services such as Active Directory (AD), inventory of hosts pulled from configuration management databases (CMDB), and lists of cloud storage buckets pulled from cloud provider APIs.

docs/opentelemetry/otel-fields-mapping.asciidoc

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -540,7 +540,7 @@ Note: The `body` in OTLP is of type `Any` and can be either an unstructured log
540540

541541
.1+|
542542
[[otel-mapping-for-faas-coldstart]]
543-
<<field-faas-coldstart, faas.coldstart>> [beta]
543+
<<field-faas-coldstart, faas.coldstart>>
544544

545545

546546

@@ -554,7 +554,7 @@ Note: The `body` in OTLP is of type `Any` and can be either an unstructured log
554554
// ===============================================================
555555
.1+|
556556
[[otel-mapping-for-faas-execution]]
557-
<<field-faas-execution, faas.execution>> [beta]
557+
<<field-faas-execution, faas.execution>>
558558

559559

560560

@@ -568,7 +568,7 @@ Note: The `body` in OTLP is of type `Any` and can be either an unstructured log
568568
// ===============================================================
569569
.1+|
570570
[[otel-mapping-for-faas-name]]
571-
<<field-faas-name, faas.name>> [beta]
571+
<<field-faas-name, faas.name>>
572572

573573

574574

@@ -582,7 +582,7 @@ Note: The `body` in OTLP is of type `Any` and can be either an unstructured log
582582
// ===============================================================
583583
.1+|
584584
[[otel-mapping-for-faas-trigger-type]]
585-
<<field-faas-trigger-type, faas.trigger.type>> [beta]
585+
<<field-faas-trigger-type, faas.trigger.type>>
586586

587587

588588

@@ -596,7 +596,7 @@ Note: The `body` in OTLP is of type `Any` and can be either an unstructured log
596596
// ===============================================================
597597
.1+|
598598
[[otel-mapping-for-faas-version]]
599-
<<field-faas-version, faas.version>> [beta]
599+
<<field-faas-version, faas.version>>
600600

601601

602602

experimental/generated/ecs/ecs_flat.yml

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3515,8 +3515,7 @@ event.kind:
35153515
This value is not used by Elastic solutions for alert documents that are created
35163516
by rules executing within the Kibana alerting framework.'
35173517
name: alert
3518-
- beta: This event categorization value is beta and subject to change.
3519-
description: 'This value indicates events whose primary purpose is to store an
3518+
- description: 'This value indicates events whose primary purpose is to store an
35203519
inventory of assets/entities and their attributes. Assets/entities are objects
35213520
(such as users and hosts) that are expected to be subjects of detailed analysis
35223521
within the system.
@@ -5931,7 +5930,6 @@ host.architecture:
59315930
short: Operating system architecture.
59325931
type: keyword
59335932
host.boot.id:
5934-
beta: This field is beta and subject to change.
59355933
dashed_name: host-boot-id
59365934
description: Linux boot uuid taken from /proc/sys/kernel/random/boot_id. Note the
59375935
boot_id value from /proc may or may not be the same in containers as on the host.
@@ -6390,7 +6388,6 @@ host.os.version:
63906388
short: Operating system version as a raw string.
63916389
type: keyword
63926390
host.pid_ns_ino:
6393-
beta: This field is beta and subject to change.
63946391
dashed_name: host-pid-ns-ino
63956392
description: This is the inode number of the namespace in the namespace file system
63966393
(nsfs). Unsigned int inum in include/linux/ns_common.h.

experimental/generated/ecs/ecs_nested.yml

Lines changed: 5 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1321,25 +1321,21 @@ cloud:
13211321
expected:
13221322
- as: origin
13231323
at: cloud
1324-
beta: Reusing the `cloud` fields in this location is currently considered beta.
13251324
full: cloud.origin
13261325
short_override: Provides the cloud information of the origin entity in case
13271326
of an incoming request or event.
13281327
- as: target
13291328
at: cloud
1330-
beta: Reusing the `cloud` fields in this location is currently considered beta.
13311329
full: cloud.target
13321330
short_override: Provides the cloud information of the target entity in case
13331331
of an outgoing request or event.
13341332
top_level: true
13351333
reused_here:
1336-
- beta: Reusing the `cloud` fields in this location is currently considered beta.
1337-
full: cloud.origin
1334+
- full: cloud.origin
13381335
schema_name: cloud
13391336
short: Provides the cloud information of the origin entity in case of an incoming
13401337
request or event.
1341-
- beta: Reusing the `cloud` fields in this location is currently considered beta.
1342-
full: cloud.target
1338+
- full: cloud.target
13431339
schema_name: cloud
13441340
short: Provides the cloud information of the target entity in case of an outgoing
13451341
request or event.
@@ -3259,7 +3255,6 @@ ecs:
32593255
title: ECS
32603256
type: group
32613257
elf:
3262-
beta: These fields are in beta and are subject to change.
32633258
description: These fields contain Linux Executable Linkable Format (ELF) metadata.
32643259
fields:
32653260
elf.architecture:
@@ -3674,11 +3669,9 @@ elf:
36743669
expected:
36753670
- as: elf
36763671
at: file
3677-
beta: This field reuse is beta and subject to change.
36783672
full: file.elf
36793673
- as: elf
36803674
at: process
3681-
beta: This field reuse is beta and subject to change.
36823675
full: process.elf
36833676
top_level: false
36843677
short: These fields contain Linux Executable Linkable Format (ELF) metadata.
@@ -4538,8 +4531,7 @@ event:
45384531
This value is not used by Elastic solutions for alert documents that are
45394532
created by rules executing within the Kibana alerting framework.'
45404533
name: alert
4541-
- beta: This event categorization value is beta and subject to change.
4542-
description: 'This value indicates events whose primary purpose is to store
4534+
- description: 'This value indicates events whose primary purpose is to store
45434535
an inventory of assets/entities and their attributes. Assets/entities are
45444536
objects (such as users and hosts) that are expected to be subjects of detailed
45454537
analysis within the system.
@@ -5001,7 +4993,6 @@ event:
50014993
title: Event
50024994
type: group
50034995
faas:
5004-
beta: These fields are in beta and are subject to change.
50054996
description: The user fields describe information about the function as a service
50064997
(FaaS) that is relevant to the event.
50074998
fields:
@@ -6978,8 +6969,7 @@ file:
69786969
- full: file.code_signature
69796970
schema_name: code_signature
69806971
short: These fields contain information about binary code signatures.
6981-
- beta: This field reuse is beta and subject to change.
6982-
full: file.elf
6972+
- full: file.elf
69836973
schema_name: elf
69846974
short: These fields contain Linux Executable Linkable Format (ELF) metadata.
69856975
- beta: This field reuse is beta and subject to change.
@@ -7397,7 +7387,6 @@ host:
73977387
short: Operating system architecture.
73987388
type: keyword
73997389
host.boot.id:
7400-
beta: This field is beta and subject to change.
74017390
dashed_name: host-boot-id
74027391
description: Linux boot uuid taken from /proc/sys/kernel/random/boot_id. Note
74037392
the boot_id value from /proc may or may not be the same in containers as on
@@ -7858,7 +7847,6 @@ host:
78587847
short: Operating system version as a raw string.
78597848
type: keyword
78607849
host.pid_ns_ino:
7861-
beta: This field is beta and subject to change.
78627850
dashed_name: host-pid-ns-ino
78637851
description: This is the inode number of the namespace in the namespace file
78647852
system (nsfs). Unsigned int inum in include/linux/ns_common.h.
@@ -15666,8 +15654,7 @@ process:
1566615654
- full: process.code_signature
1566715655
schema_name: code_signature
1566815656
short: These fields contain information about binary code signatures.
15669-
- beta: This field reuse is beta and subject to change.
15670-
full: process.elf
15657+
- full: process.elf
1567115658
schema_name: elf
1567215659
short: These fields contain Linux Executable Linkable Format (ELF) metadata.
1567315660
- beta: This field reuse is beta and subject to change.
@@ -25860,7 +25847,6 @@ vlan:
2586025847
title: VLAN
2586125848
type: group
2586225849
volume:
25863-
beta: These fields are beta and are subject to change.
2586425850
description: Fields related to storage volume details.
2586525851
fields:
2586625852
volume.bus_type:

generated/ecs/ecs_flat.yml

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3446,8 +3446,7 @@ event.kind:
34463446
This value is not used by Elastic solutions for alert documents that are created
34473447
by rules executing within the Kibana alerting framework.'
34483448
name: alert
3449-
- beta: This event categorization value is beta and subject to change.
3450-
description: 'This value indicates events whose primary purpose is to store an
3449+
- description: 'This value indicates events whose primary purpose is to store an
34513450
inventory of assets/entities and their attributes. Assets/entities are objects
34523451
(such as users and hosts) that are expected to be subjects of detailed analysis
34533452
within the system.
@@ -5862,7 +5861,6 @@ host.architecture:
58625861
short: Operating system architecture.
58635862
type: keyword
58645863
host.boot.id:
5865-
beta: This field is beta and subject to change.
58665864
dashed_name: host-boot-id
58675865
description: Linux boot uuid taken from /proc/sys/kernel/random/boot_id. Note the
58685866
boot_id value from /proc may or may not be the same in containers as on the host.
@@ -6321,7 +6319,6 @@ host.os.version:
63216319
short: Operating system version as a raw string.
63226320
type: keyword
63236321
host.pid_ns_ino:
6324-
beta: This field is beta and subject to change.
63256322
dashed_name: host-pid-ns-ino
63266323
description: This is the inode number of the namespace in the namespace file system
63276324
(nsfs). Unsigned int inum in include/linux/ns_common.h.

0 commit comments

Comments
 (0)