Skip to content

Commit

Permalink
[8.0] docs: Add tagged regions to changelog (backport #12251) (#12258)
Browse files Browse the repository at this point in the history
* docs: Add tagged regions to changelog (#12251)

* add tagged regions to changelog

* add back changelogs to file paths

* rename and move breaking changes file

(cherry picked from commit 0f69547)

* remove future versions

* remove breaking changes from future versions

---------

Co-authored-by: Colleen McGinnis <[email protected]>
  • Loading branch information
mergify[bot] and colleenmcginnis authored Dec 22, 2023
1 parent 9ec7402 commit 7591229
Show file tree
Hide file tree
Showing 2 changed files with 155 additions and 0 deletions.
6 changes: 6 additions & 0 deletions CHANGELOG.asciidoc
Original file line number Diff line number Diff line change
@@ -1 +1,7 @@
// tag::list[]
* <<release-notes-8.0>>
// end::list[]
// tag::includes[]
include::./changelogs/8.0.asciidoc[]
// end::includes[]
149 changes: 149 additions & 0 deletions changelogs/all-breaking-changes.asciidoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,149 @@
:issue: https://github.com/elastic/apm-server/issues/
:pull: https://github.com/elastic/apm-server/pull/

[[apm-breaking]]
=== Breaking Changes

This section describes the breaking changes and deprecations introduced in this release
and previous minor versions.

[float]
[[breaking-changes-8.0]]
=== 8.0

// tag::80-bc[]
The following breaking changes are introduced in APM version 8.0.

[float]
==== Indices are now manged by {fleet}

All index management has been removed from APM Server;
{fleet} is now entirely responsible for setting up index templates, index lifecycle polices,
and index pipelines.

As a part of this change, the following settings have been removed:

* `apm-server.ilm.*`
* `apm-server.register.ingest.pipeline.*`
* `setup.*`

[float]
==== Data streams by default

APM Server now only writes to well-defined data streams;
writing to classic indices is no longer supported.

As a part of this change, the following settings have been removed:

* `apm-server.data_streams.enabled`
* `output.elasticsearch.index`
* `output.elasticsearch.indices`
* `output.elasticsearch.pipeline`
* `output.elasticsearch.pipelines`

[float]
==== New {es} output

APM Server has a new {es} output implementation; it is no longer necessary to manually
tune the output of APM Server.

As a part of this change, the following settings have been removed:

* `output.elasticsearch.bulk_max_size`
* `output.elasticsearch.worker`
* `queue.*`

[float]
==== New source map upload endpoint

The source map upload endpoint has been removed from APM Server.
Source maps should now be uploaded directly to {kib} instead.

[float]
==== Legacy Jaeger endpoints have been removed

The legacy Jaeger gRPC and HTTP endpoints have been removed from APM Server.

As a part of this change, the following settings have been removed:

* `apm-server.jaeger`

[float]
==== Homebrew no longer supported

APM Server no longer supports installation via Homebrew.

[float]
==== All removed and changed settings

Below is a list of all **removed settings** (in alphabetical order) for
users upgrading a standalone APM Server to {stack} version 8.0.

[source,yml]
----
apm-server.data_streams.enabled
apm-server.ilm.*
apm-server.jaeger
apm-server.register.ingest.pipeline.*
apm-server.sampling.keep_unsampled
output.elasticsearch.bulk_max_size
output.elasticsearch.index
output.elasticsearch.indices
output.elasticsearch.pipeline
output.elasticsearch.pipelines
output.elasticsearch.worker
queue.*
setup.*
----

Below is a list of **renamed settings** (in alphabetical order) for
users upgrading a standalone APM Server to {stack} version 8.0.

[source,yml]
----
previous setting --> new setting
apm-server.api_key --> apm-server.auth.api_key
apm-server.instrumentation --> instrumentation
apm-server.rum.allowed_service --> apm-server.auth.anonymous.allow_service
apm-server.rum.event_rate --> apm-server.auth.anonymous.rate_limit
apm-server.secret_token --> apm-server.auth.secret_token
----

[float]
==== Supported {ecloud} settings

Below is a list of all **supported settings** (in alphabetical order) for
users upgrading an {ecloud} standalone cluster to {stack} version 8.0.
Any previously supported settings not listed below will be removed when upgrading.

[source,yml]
----
apm-server.agent.config.cache.expiration
apm-server.aggregation.transactions.*
apm-server.auth.anonymous.allow_agent
apm-server.auth.anonymous.allow_service
apm-server.auth.anonymous.rate_limit.event_limit
apm-server.auth.anonymous.rate_limit.ip_limit
apm-server.auth.api_key.enabled
apm-server.auth.api_key.limit
apm-server.capture_personal_data
apm-server.default_service_environment
apm-server.max_event_size
apm-server.rum.allow_headers
apm-server.rum.allow_origins
apm-server.rum.enabled
apm-server.rum.exclude_from_grouping
apm-server.rum.library_pattern
apm-server.rum.source_mapping.enabled
apm-server.rum.source_mapping.cache.expiration
logging.level
logging.selectors
logging.metrics.enabled
logging.metrics.period
max_procs
output.elasticsearch.flush_bytes
output.elasticsearch.flush_interval
----

// end::80-bc[]

0 comments on commit 7591229

Please sign in to comment.