diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index 47928a5e8e8..2d1be046210 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -1 +1,7 @@ +// tag::list[] +* <> +// end::list[] + +// tag::includes[] include::./changelogs/8.0.asciidoc[] +// end::includes[] diff --git a/changelogs/all-breaking-changes.asciidoc b/changelogs/all-breaking-changes.asciidoc new file mode 100644 index 00000000000..1a62c961c1f --- /dev/null +++ b/changelogs/all-breaking-changes.asciidoc @@ -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[]