Skip to content

Commit 6aa0db8

Browse files
authored
[DOCS] Migration information about ES logging breaking changes (#79146)
Adds breaking change docs for #47105. (ECS layout and plaintext log files removal) Relates to #46119
1 parent afe0010 commit 6aa0db8

File tree

2 files changed

+44
-0
lines changed

2 files changed

+44
-0
lines changed

docs/reference/migration/migrate_8_0.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ coming[8.0.0]
2424
* <<breaking_80_indices_changes>>
2525
* <<breaking_80_ingest_changes>>
2626
* <<breaking_80_java_changes>>
27+
* <<breaking_80_logging_changes>>
2728
* <<breaking_80_mappings_changes>>
2829
* <<breaking_80_network_changes>>
2930
* <<breaking_80_node_changes>>
@@ -126,6 +127,7 @@ include::migrate_8_0/ilm.asciidoc[]
126127
include::migrate_8_0/indices.asciidoc[]
127128
include::migrate_8_0/ingest.asciidoc[]
128129
include::migrate_8_0/java.asciidoc[]
130+
include::migrate_8_0/logging.asciidoc[]
129131
include::migrate_8_0/mappings.asciidoc[]
130132
include::migrate_8_0/network.asciidoc[]
131133
include::migrate_8_0/node.asciidoc[]
Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
[discrete]
2+
[[breaking_80_logging_changes]]
3+
==== Logging changes
4+
5+
//NOTE: The notable-breaking-changes tagged regions are re-used in the
6+
//Installation and Upgrade Guide
7+
8+
//tag::notable-breaking-changes[]
9+
.{es} JSON logs now comply with ECS.
10+
[%collapsible]
11+
====
12+
*Details* +
13+
{es}'s {ref}/logging.html[JSON logs] now comply with the
14+
{ecs-ref}/index.html[Elastic Common Schema (ECS)]. Previously, {es}'s JSON logs
15+
used a custom schema.
16+
17+
*Impact* +
18+
If your application parses {es}'s JSON logs, update it to support the new ECS
19+
format.
20+
====
21+
22+
23+
.{es} no longer emits deprecation logs or slow logs in plaintext.
24+
[%collapsible]
25+
====
26+
*Details* +
27+
{es} no longer emits a plaintext version of the following logs:
28+
29+
* Deprecation logs
30+
* Indexing slow logs
31+
* Search slow logs
32+
33+
These logs are now only available in JSON.
34+
35+
Server logs are still available in both a JSON and plaintext format.
36+
37+
*Impact* +
38+
If your application parses {es}'s plaintext logs, update it to use the new ECS
39+
JSON logs.
40+
====
41+
42+
// end::notable-breaking-changes[]

0 commit comments

Comments
 (0)