diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc deleted file mode 100644 index ed7765c4a7d..00000000000 --- a/CHANGELOG.asciidoc +++ /dev/null @@ -1,46 +0,0 @@ -// tag::list[] -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -// end::list[] - -// tag::includes[] -include::./changelogs/head.asciidoc[] -include::./changelogs/9.0.asciidoc[] -include::./changelogs/8.18.asciidoc[] -include::./changelogs/8.17.asciidoc[] -include::./changelogs/8.16.asciidoc[] -include::./changelogs/8.15.asciidoc[] -include::./changelogs/8.14.asciidoc[] -include::./changelogs/8.13.asciidoc[] -include::./changelogs/8.12.asciidoc[] -include::./changelogs/8.11.asciidoc[] -include::./changelogs/8.10.asciidoc[] -include::./changelogs/8.9.asciidoc[] -include::./changelogs/8.8.asciidoc[] -include::./changelogs/8.7.asciidoc[] -include::./changelogs/8.6.asciidoc[] -include::./changelogs/8.5.asciidoc[] -include::./changelogs/8.4.asciidoc[] -include::./changelogs/8.3.asciidoc[] -include::./changelogs/8.2.asciidoc[] -include::./changelogs/8.1.asciidoc[] -include::./changelogs/8.0.asciidoc[] -// end::includes[] diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 00000000000..26a356dad5b --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,5 @@ +# Changelog + + +* [Elastic APM v8.x](https://www.elastic.co/guide/en/observability/8.x/apm-release-notes.html) +* [Elastic APM v7.x](https://www.elastic.co/guide/en/apm/guide/7.17/release-notes.html) \ No newline at end of file diff --git a/changelogs/6.1.asciidoc b/changelogs/6.1.asciidoc deleted file mode 100644 index ef5af21cb3c..00000000000 --- a/changelogs/6.1.asciidoc +++ /dev/null @@ -1,78 +0,0 @@ -[[release-notes-6.1]] -== APM Server version 6.1 - -https://github.com/elastic/apm-server/compare/6.0\...6.1[View commits] - -* <> -* <> -* <> -* <> -* <> - -[float] -[[release-notes-6.1.4]] -=== APM Server version 6.1.4 - -https://github.com/elastic/apm-server/compare/v6.1.3\...v6.1.4[View commits] - -No significant changes. - -[float] -[[release-notes-6.1.3]] -=== APM Server version 6.1.3 - -https://github.com/elastic/apm-server/compare/v6.1.2\...v6.1.3[View commits] - -No significant changes. - -[float] -[[release-notes-6.1.2]] -=== APM Server version 6.1.2 - -https://github.com/elastic/apm-server/compare/v6.1.1\...v6.1.2[View commits] - -No significant changes. - -[float] -[[release-notes-6.1.1]] -=== APM Server version 6.1.1 - -https://github.com/elastic/apm-server/compare/v6.1.0\...v6.1.1[View commits] - -No significant changes. - -[float] -[[release-notes-6.1.0]] -=== APM Server version 6.1.0 - -https://github.com/elastic/apm-server/compare/v6.0.1\...v6.1.0[View commits] - -[float] -==== Breaking changes -- Allow ES template index prefix to be `apm` {pull}152[152]. -- Remove `git_ref` from Intake API and {es} output {pull}158[158]. -- Switch to Go 1.9.2 - -[float] -==== Bug fixes -- Fix dashboard loading for {kib} 5x {pull}221[221]. -- Fix command for loading dashboards in docs {pull}205[205]. -- Log a warning message if secret token is set but ssl is not {pull}204[204]. -- Fix wrong content-type in response {pull}171[171]. -- Remove duplicate dashboard entries {pull}162[162]. -- Remove `context.db` from `fields.yml` for consistency, has not been indexed before {pull}159[159]. -- Update dashboard with fix for rpm graphs {pull}315[315]. -- Dashboards: Remove time from url_templates {pull}321[321]. - -[float] -==== Added -- Added wildcard matching for allowed origins for front-end {pull}287[287]. -- Added rate limit per IP for front-end {pull}257[257]. -- Allow null for all optional fields {pull}253[253]. -- Make context.app.language.version optional {pull}246[246]. -- CORS support for front-end {pull}244[244]. -- Added support for front-end {pull}227[227]. -- Show transaction.result in Requests per Minute {pull}226[226]. -- Added {kib} 5.6 compatible dashboards {pull}208[208]. -- Send document to output on start of server {pull}117[117]. -- Log front-end status at startup {pull}284[284]. diff --git a/changelogs/6.2.asciidoc b/changelogs/6.2.asciidoc deleted file mode 100644 index d632eaf5dba..00000000000 --- a/changelogs/6.2.asciidoc +++ /dev/null @@ -1,92 +0,0 @@ -[[release-notes-6.2]] -== APM Server version 6.2 - -https://github.com/elastic/apm-server/compare/6.1...6.2[View commits] - -* <> -* <> -* <> -* <> -* <> - -[float] -[[release-notes-6.2.4]] -=== APM Server version 6.2.4 - -https://github.com/elastic/apm-server/compare/v6.2.3\...v6.2.4[View commits] - -No significant changes. - -[float] -[[release-notes-6.2.3]] -=== APM Server version 6.2.3 - -https://github.com/elastic/apm-server/compare/v6.2.2\...v6.2.3[View commits] - -No significant changes. - -[float] -[[release-notes-6.2.2]] -=== APM Server version 6.2.2 - -https://github.com/elastic/apm-server/compare/v6.2.1\...v6.2.2[View commits] - -No significant changes. - -[float] -[[release-notes-6.2.1]] -=== APM Server version 6.2.1 - -https://github.com/elastic/apm-server/compare/v6.2.0\...v6.2.1[View commits] - -No significant changes. - -[float] -[[release-notes-6.2.0]] -=== APM Server version 6.2.0 - -https://github.com/elastic/apm-server/compare/v6.1.4\...v6.2.0[View commits] - -[float] -==== Breaking changes -- Renaming and reverse boolean `in_app` to `library_frame` {pull}385[385]. -- Renaming `app` to `service` {pull}377[377] -- Move `trace.transaction_id` to `transaction.id` {pull}345[345], {pull}347[347], {pull}371[371] -- Renaming `trace` to `span` {pull}352[352]. -- Renaming and reverse boolean `exception.uncaught` to `exception.handled` {pull}434[434]. -- Move process related fields to their own namespace {pull}445[445]. -- Rename {kib} directories according to changed structure in beats framework. {pull}454[454] -- Change config option `max_header_bytes` to `max_header_size` {pull}492[492]. -- Change config option `frontend.sourcemapping.index` to `frontend.source_mapping.index_pattern` and remove adding a '*' by default. {pull}492[492]. -- Remove untested config options from config yml files {pull}496[496] - -[float] -==== Bug fixes -- Updated systemd doc url {pull}354[354] -- Updated readme doc urls {pull}356[356] -- Use updated stack trace frame values for calculating error `grouping_keys` {pull}485[485] -- Fix panic when a signal is delivered before the server is instantiated {pull}580[580] - -[float] -==== Added -- service.environment {pull}366[366] -- Consider exception or log message for grouping key when nothing else is available {pull}435[435] -- Add context.request.url.full {pull}436[436] -- Report more detail on max data size error {pull}442[442] -- Increase default 'MaxUnzippedSize' from 10mb to 50mb {pull}439[439] -- Add transaction.id to errors {pull}437[437] -- Support for `transaction.marks` {pull}430[430] -- Support for uploading source maps {pull}302[302]. -- Support for source mapping on incoming front-end requests {pull}381[381], {pull}462[462], {pull}502[502] -- Support for `transaction.span_count.dropped.total` {pull}448[448]. -- Optional field `transaction.sampled` {pull}441[441] -- Add {kib} sourcefilter for `sourcemap.sourcemap` {pull}454[454] -- Increase default 'ConcurrentRequests' from 20 to 40 {pull}492[492] -- Add Config option for excluding stack trace frames from `grouping_key` calculation {pull}482[482] -- Expose expvar {pull}509[509] -- Add `process.ppid` as optional field {pull}564[564] -- Change `error.culprit` after successfully applying source mapping {pull}520[520] -- Make `transaction.name` optional {pull}554[554] -- Remove config files from beats. Manually add relevant config options {pull}578[578] -- Use separate index for uploaded `source maps` {pull}582[582]. -- Store original values when applying source mapping or changing `library_frame` value {pull}647[647] diff --git a/changelogs/6.3.asciidoc b/changelogs/6.3.asciidoc deleted file mode 100644 index beca9f301f9..00000000000 --- a/changelogs/6.3.asciidoc +++ /dev/null @@ -1,56 +0,0 @@ -[[release-notes-6.3]] -== APM Server version 6.3 - -https://github.com/elastic/apm-server/compare/6.2\...6.3[View commits] - -* <> -* <> -* <> - -[float] -[[release-notes-6.3.2]] -=== APM Server version 6.3.2 - -https://github.com/elastic/apm-server/compare/v6.3.1\...v6.3.2[View commits] - -No significant changes. - -[float] -[[release-notes-6.3.1]] -=== APM Server version 6.3.1 - -https://github.com/elastic/apm-server/compare/v6.3.0\...v6.3.1[View commits] - -No significant changes. - -[float] -[[release-notes-6.3.0]] -=== APM Server version 6.3.0 - -https://github.com/elastic/apm-server/compare/v6.2.4\...v6.3.0[View commits] - -[float] -==== Bug fixes - -- Accept charset in request's content type {pull}677[677]. -- Use type integer instead of number in JSON schemas where applicable {pull}641[641]. -- Set array item types to string in JSON schemas {pull}651[651]. -- Fix issue preventing server from being stopped {pull}704[704]. -- Limit the amount of concurrent requests being processed {pull}731[731]. -- Return proper response code for request entity too large {pull}862[862]. -- Make APM Server docker image listen on all interfaces by default https://github.com/elastic/apm-server-docker/pull/16[apm-server-dockers#16] - -[float] -==== Added - -- Enriched data with IP and UserAgent {pull}393[393], {pull}701[701], {pull}730[730], {pull}923[923]. -- Push errors and transactions to different ES indices {pull}706[706]. -- Allow custom `error.log.level` {pull}712[712]. -- Change `concurrent_request` default from 40 to 5 {pull}731[731]. -- Change `max_unzipped_size` default from 50mb to 30mb {pull}731[731]. -- Change `read_timeout` and `write_timeout` defaults from 2s to 30s {pull}748[748], {pull}752[752]. -- Limit number of new connections to accept simultaneously {pull}751[751]. -- Push spans to separate ES index {pull}774[774]. -- Update Go to 1.9.4 {pull}786[786]. -- Listen on Unix domain socket with `host=unix:/path` {pull}768[768]. -- Make timestamp optional in the intake api {pull}819[819]. diff --git a/changelogs/6.4.asciidoc b/changelogs/6.4.asciidoc deleted file mode 100644 index 386b4a8663e..00000000000 --- a/changelogs/6.4.asciidoc +++ /dev/null @@ -1,60 +0,0 @@ -[[release-notes-6.4]] -== APM Server version 6.4 - -https://github.com/elastic/apm-server/compare/6.3\...6.4[View commits] - -* <> -* <> -* <> -* <> - -[float] -[[release-notes-6.4.3]] -=== APM Server version 6.4.3 - -https://github.com/elastic/apm-server/compare/v6.4.2\...v6.4.3[View commits] - -No significant changes. - -[float] -[[release-notes-6.4.2]] -=== APM Server version 6.4.2 - -https://github.com/elastic/apm-server/compare/v6.4.1\...v6.4.2[View commits] - -No significant changes. - -[float] -[[release-notes-6.4.1]] -=== APM Server version 6.4.1 - -https://github.com/elastic/apm-server/compare/v6.4.0\...v6.4.1[View commits] - -No significant changes. - -[float] -[[release-notes-6.4.0]] -=== APM Server version 6.4.0 - -https://github.com/elastic/apm-server/compare/v6.3.2\...v6.4.0[View commits] - -[float] -==== Bug fixes - -- Listen on default port 8200 if unspecified {pull}886[886]. -- Remove regexProperties validation rules {pull}1148[1148], {pull}1150[1150]. - -[float] -==== Added - -- Change `frontend` to `rum` in config file, but still support `frontend` for backwards compatibility {pull}1155[1155]. -- Support `rum` and `client-side` endpoint for RUM for backwards compatibility {pull}1155[1155]. -- Update Go to 1.10.3 {pull}1054[1054]. -- Combine `apm-server.yml` and `apm-server.reference.yml` into one file {pull}958[958]. -- Add optional tracing for the server's API and event publisher {pull}816[816]. -- Read source map content and fill context lines {pull}972[972]. -- Add source_mapping.elasticsearch configuration option {pull}1114[1114]. -- Add /v1/metrics endpoint {pull}1000[1000], {pull}1121[1121]. -- Push onboarding doc to separate ES index {pull}1159[1159]. -- Deprecate usage of `apm-server setup` for dashboards and index-pattern {pull}1142[1142], {pull}1261[1261]. -- Disable metrics logging by default {pull}1127[1127]. diff --git a/changelogs/6.5.asciidoc b/changelogs/6.5.asciidoc deleted file mode 100644 index c72fa8e784b..00000000000 --- a/changelogs/6.5.asciidoc +++ /dev/null @@ -1,62 +0,0 @@ -[[release-notes-6.5]] -== APM Server version 6.5 - -https://github.com/elastic/apm-server/compare/6.4\...6.5[View commits] - -* <> -* <> -* <> -* <> -* <> - -[float] -[[release-notes-6.5.4]] -=== APM Server version 6.5.4 - -https://github.com/elastic/apm-server/compare/v6.5.3\...v6.5.4[View commits] - -[float] -==== Added - -- Update Go to 1.10.6 {pull}1656[1656]. - -[float] -[[release-notes-6.5.3]] -=== APM Server version 6.5.3 - -https://github.com/elastic/apm-server/compare/v6.5.2\...v6.5.3[View commits] - -No significant changes. - -[float] -[[release-notes-6.5.2]] -=== APM Server version 6.5.2 - -https://github.com/elastic/apm-server/compare/v6.5.1\...v6.5.2[View commits] - -No significant changes. - -[float] -[[release-notes-6.5.1]] -=== APM Server version 6.5.1 - -https://github.com/elastic/apm-server/compare/v6.5.0\...v6.5.1[View commits] - -No significant changes. - -[float] -[[release-notes-6.5.0]] -=== APM Server version 6.5.0 - -https://github.com/elastic/apm-server/compare/v6.4.2\...v6.5.0[View commits] - -[float] -==== Added - -- Provide basic server information at `/` {pull}1197[1197]. -- Add pipeline registration and pipeline usage {pull}1258[1258], {pull}1296[1296]. -- Allow sending `tags` for `spans`, that get indexed in ES {pull}1156[1156]. -- Add apm-server monitoring {pull}1382[1382]. -- Enable sending instrumentation to a remote APM Server with `instrumentation.hosts` {pull}1389[1389]. -- Added Intake Protocol v2 with distributed tracing support {pull}1237[1237], {pull}1390[1390]. -- Set some configuration defaults (setup.template.settings.index.*, logging.metrics.enabled) in code {pull}1494[1494]. diff --git a/changelogs/6.6.asciidoc b/changelogs/6.6.asciidoc deleted file mode 100644 index 6943412a8ff..00000000000 --- a/changelogs/6.6.asciidoc +++ /dev/null @@ -1,48 +0,0 @@ -[[release-notes-6.6]] -== APM Server version 6.6 - -https://github.com/elastic/apm-server/compare/6.5\...6.6[View commits] - -* <> -* <> -* <> - -[float] -[[release-notes-6.6.2]] -=== APM Server version 6.6.2 - -https://github.com/elastic/apm-server/compare/v6.6.1\...v6.6.2[View commits] - -No significant changes. - -[float] -[[release-notes-6.6.1]] -=== APM Server version 6.6.1 - -https://github.com/elastic/apm-server/compare/v6.6.0\...v6.6.1[View commits] - -No significant changes. - -[float] -[[release-notes-6.6.0]] -=== APM Server version 6.6.0 - -https://github.com/elastic/apm-server/compare/v6.5.4\...v6.6.0[View commits] - -[float] -==== Added - -- Set some configuration defaults (`setup.template.settings.index.*`, `logging.metrics.enabled`) in code {pull}1494[1494]. -- Add `span.sync` property to intake json spec and index field in ES. {pull}1548[1548]. -- Make `service.framework` properties optional and nullable {pull}1546[1546]. -- Add optional `span.subtype` and `span.action` properties. {pull}1618[1618]. -- Add `transaction.sampled` to errors {pull}1662[1662]. -- Lookup source maps by full URL and URL path only {pull}1661[1661]. -- Update Go to 1.10.8 {pull}1832[1832]. - -[float] -==== Bug fixes - -- Fix index pattern bundled with {kib} to be in sync with ES template {pull}1571[1571]. -- Ensure all `transaction.marks.*.*` values are stored as scaled floats {pull}1704[1704]. -- Prevent slice out of bounds panic when source map line numbers are off {pull}1764[1764]. diff --git a/changelogs/6.7.asciidoc b/changelogs/6.7.asciidoc deleted file mode 100644 index 0d8282e17ff..00000000000 --- a/changelogs/6.7.asciidoc +++ /dev/null @@ -1,48 +0,0 @@ -[[release-notes-6.7]] -== APM Server version 6.7 - -https://github.com/elastic/apm-server/compare/6.6\...6.7[View commits] - -* <> -* <> -* <> - -[float] -[[release-notes-6.7.2]] -=== APM Server version 6.7.2 - -https://github.com/elastic/apm-server/compare/v6.7.1\...v6.7.2[View commits] - -[float] -==== Bug fixes - -- Fix numeric user id decoding {pull}2147[2147]. - -[float] -[[release-notes-6.7.1]] -=== APM Server version 6.7.1 - -https://github.com/elastic/apm-server/compare/v6.7.0\...v6.7.1[View commits] - -[float] -==== Bug fixes - -- Remove IP fields from query in index pattern {pull}2046[2046]. - -[float] -[[release-notes-6.7.0]] -=== APM Server version 6.7.0 - -https://github.com/elastic/apm-server/compare/v6.6.0\...v6.7.0[View commits] - -[float] -==== Added - -- Allow numbers and boolean values for `transaction.tags`, `span.tags`, `metricset.tags` {pull}1712[1712]. -- Retrieve `span.subtype` and `span.action` from `span.type` if not given {pull}1843[1843]. -- Set default query fields in index pattern {pull}1996[1996]. - -[float] -==== Removed -- Remove support for using dots in tags for experimental metricset endpoint {pull}1712[1712]. -- Remove formatting of `duration.us` to milliseconds in index pattern {pull}1717[1717]. diff --git a/changelogs/6.8.asciidoc b/changelogs/6.8.asciidoc deleted file mode 100644 index 402c9f6a415..00000000000 --- a/changelogs/6.8.asciidoc +++ /dev/null @@ -1,227 +0,0 @@ -[[release-notes-6.8]] -== APM Server version 6.8 - -https://github.com/elastic/apm-server/compare/6.7\...6.8[View commits] - -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> - -[float] -[[release-notes-6.8.23]] -=== APM Server version 6.8.23 - -https://github.com/elastic/apm-server/compare/v6.8.22\...v6.8.23[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.22]] -=== APM Server version 6.8.22 - -https://github.com/elastic/apm-server/compare/v6.8.21\...v6.8.22[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.21]] -=== APM Server version 6.8.21 - -https://github.com/elastic/apm-server/compare/v6.8.20\...v6.8.21[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.20]] -=== APM Server version 6.8.20 - -https://github.com/elastic/apm-server/compare/v6.8.19\...v6.8.20[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.19]] -=== APM Server version 6.8.19 - -https://github.com/elastic/apm-server/compare/v6.8.18\...v6.8.19[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.18]] -=== APM Server version 6.8.18 - -https://github.com/elastic/apm-server/compare/v6.8.17\...v6.8.18[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.17]] -=== APM Server version 6.8.17 - -https://github.com/elastic/apm-server/compare/v6.8.16\...v6.8.17[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.16]] -=== APM Server version 6.8.16 - -https://github.com/elastic/apm-server/compare/v6.8.15\...v6.8.16[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.15]] -=== APM Server version 6.8.15 - -https://github.com/elastic/apm-server/compare/v6.8.14\...v6.8.15[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.14]] -=== APM Server version 6.8.14 - -https://github.com/elastic/apm-server/compare/v6.8.13\...v6.8.14[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.13]] -=== APM Server version 6.8.13 - -https://github.com/elastic/apm-server/compare/v6.8.12\...v6.8.13[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.12]] -=== APM Server version 6.8.12 - -https://github.com/elastic/apm-server/compare/v6.8.11\...v6.8.12[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.11]] -=== APM Server version 6.8.11 - -https://github.com/elastic/apm-server/compare/v6.8.10\...v6.8.11[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.10]] -=== APM Server version 6.8.10 - -https://github.com/elastic/apm-server/compare/v6.8.9\...v6.8.10[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.9]] -=== APM Server version 6.8.9 - -https://github.com/elastic/apm-server/compare/v6.8.8\...v6.8.9[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.8]] -=== APM Server version 6.8.8 - -https://github.com/elastic/apm-server/compare/v6.8.7\...v6.8.8[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.7]] -=== APM Server version 6.8.7 - -https://github.com/elastic/apm-server/compare/v6.8.6\...v6.8.7[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.6]] -=== APM Server version 6.8.6 - -https://github.com/elastic/apm-server/compare/v6.8.5\...v6.8.6[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.5]] -=== APM Server version 6.8.5 - -https://github.com/elastic/apm-server/compare/v6.8.4\...v6.8.5[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.4]] -=== APM Server version 6.8.4 - -https://github.com/elastic/apm-server/compare/v6.8.3\...v6.8.4[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.3]] -=== APM Server version 6.8.3 - -https://github.com/elastic/apm-server/compare/v6.8.2\...v6.8.3[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.2]] -=== APM Server version 6.8.2 - -https://github.com/elastic/apm-server/compare/v6.8.1\...v6.8.2[View commits] - -No significant changes. - -[float] -[[release-notes-6.8.1]] -=== APM Server version 6.8.1 - -https://github.com/elastic/apm-server/compare/v6.8.0\...v6.8.1[View commits] - -[float] -==== Added - -- Support more SSL config options for agent/server communication {pull}2224[2224], {pull}2281[2281]. - -[float] -[[release-notes-6.8.0]] -=== APM Server version 6.8.0 - -https://github.com/elastic/apm-server/compare/v6.7.2\...v6.8.0[View commits] - -[float] -==== Bug fixes - -- Fix numeric user id decoding {pull}2147[2147]. diff --git a/changelogs/7.0.asciidoc b/changelogs/7.0.asciidoc deleted file mode 100644 index a983b80c049..00000000000 --- a/changelogs/7.0.asciidoc +++ /dev/null @@ -1,158 +0,0 @@ -[[release-notes-7.0]] -== APM Server version 7.0 - -https://github.com/elastic/apm-server/compare/6.8\...7.0[View commits] - -* <> -* <> -* <> -* <> -* <> -* <> -* <> - -[float] -[[release-notes-7.0.1]] -=== APM Server version 7.0.1 - -https://github.com/elastic/apm-server/compare/v7.0.0\...v7.0.1[View commits] - -[float] -==== Bug fixes -- Set user/group under systemd {pull}2101[2101]. - -[float] -[[release-notes-7.0.0]] -=== APM Server version 7.0.0 - -https://github.com/elastic/apm-server/compare/v6.8.18\...v7.0.0[View commits] - -These release notes include all changes made in the alpha, beta, and RC releases of 7.0.0. - -Also see: - -* {apm-guide-ref}/breaking-changes.html[Breaking changes in 7.0] - -[float] -==== Added - -- Perform Basic license check on {es} connect {pull}2077[2077]. -- Update Elastic APM Go agent to v1.1.2 {pull}1711[1711], {pull}1728[1728]. -- Update response format of the healthcheck handler and prettyfy all JSON responses {pull}1748[1748]. -- Add `transaction.type` to error data {pull}1781[1781]. -- Change ownership to apm-server user/group for deb/rpm installs {pull}1833[1833]. -- Add `observer.version_major` {pull}1857[1857]. -- Move default index configuration to code {pull}1865[1865]. -- Change default user-agent pipeline to index information under root key `user_agent` {pull}1871[1871]. -- Use _doc as document type for {es} >= 7.0.0 https://github.com/elastic/beats/pull/9056[beats/9057]. -- Automatically cap signed integers to 63bits https://github.com/elastic/beats/pull/8991[beats/8991]. -- Build default distribution under the Elastic License. {pull}1645[1645]. -- Log to journald under systemd by default rather than file. To revert this behaviour override BEAT_LOG_OPTS with an empty value https://github.com/elastic/beats/pull/8942[beats/8942] via {pull}1645[1645]. - -[float] -==== Removed - -- Remove support for deprecated Intake v1 endpoints. {apm-guide-ref}/breaking-7.0.0.html#breaking-remove-v1[More information], {pull}1731[1731]. -- Remove `concurrent_requests` setting and use number of CPUs instead {pull}1749[1749]. -- Remove `frontend` setting {pull}1751[1751]. -- Remove `metrics.enabled` setting {pull}1759[1759]. -- Remove dashboards from being shipped with APM Server and all logic around them {pull}[1815]. - -[float] -==== Bug fixes - -- Fix index template always being overwritten {pull}2077[2077]. -- Ensure setup cmd uses expected configuration {pull}1934[1934]. -- Ensure `host.name` is not added {pull}1934[1934], {pull}1982[1982]. -- Ensure enabling user-agent pipeline indexes data at the same key by default {pull}1966[1966]. -- Request and Response headers are stored in a canonicalized way {pull}1966[1966]. -- Use changed processor handling from libbeat {pull}1982[1982]. - -[float] -==== Breaking Changes -- Move fields in ES to be ECS compliant. {apm-guide-ref}/breaking-7.0.0.html#breaking-ecs[More information], {pull}1766[1766], {pull}1783[1783], {pull}1813[1813], {pull}1836[1836], {pull}1838[1838], {pull}1844[1844], {pull}1848[1848], {pull}1849[1849], {pull}1863[1863], {pull}1870[1870]. -- Rename `transaction.span_count.dropped.total` to `transaction.span_count.dropped` {pull}1809[1809]. -- Rename `span.hex_id` to `span.id` {pull}1811[1811]. -- Index `error.exception` as array of objects {pull}1825[1825] -- Change `transaction.name` to keyword, add `transaction.name.text` {pull}1859[1859]. -- Change `error.culprit` to keyword, limit length on intake {pull}1859[1859]. - -[float] -[[release-notes-7.0.0-rc2]] -=== APM Server version 7.0.0-rc2 - -https://github.com/elastic/apm-server/compare/v7.0.0-rc1\...v7.0.0-rc2[View commits] - -No significant changes. - -[float] -[[release-notes-7.0.0-rc1]] -=== APM Server version 7.0.0-rc1 - -https://github.com/elastic/apm-server/compare/v7.0.0-beta1\...v7.0.0-rc1[View commits] - -[float] -==== Bug fixes - -- Ensure setup cmd uses expected configuration {pull}1934[1934]. -- Ensure host.name is not added {pull}1934[1934], {pull}1982[1982]. -- Update Go version to 1.11.5 {pull}1840[1840], {pull}1950[1950]. -- Ensure enabling user-agent pipeline indexes data at the same key by default {pull}1966[1966]. -- Request and Response headers are stored in a canonicalized way {pull}1966[1966]. -- Use changed processor handling from libbeat {pull}1982[1982]. - -[float] -[[release-notes-7.0.0-beta1]] -=== APM Server version 7.0.0-beta1 - -https://github.com/elastic/apm-server/compare/v7.0.0-alpha2\...v7.0.0-beta1[View commits] - -[float] -==== Breaking Changes -- Move fields in ES to be ECS compliant. {apm-guide-ref}/breaking-7.0.0.html#breaking-ecs[More information], {pull}1766[1766], {pull}1783[1783], {pull}1813[1813], {pull}1836[1836], {pull}1838[1838], {pull}1844[1844], {pull}1848[1848], {pull}1849[1849], {pull}1863[1863], {pull}1870[1870]. - -[float] -==== Added - -- Update Elastic APM Go agent to v1.1.2 {pull}1711[1711], {pull}1728[1728]. -- Update response format of the healthcheck handler and prettyfy all JSON responses {pull}1748[1748]. -- Add transaction.type to error data {pull}1781[1781]. -- Rename transaction.span_count.dropped.total to transaction.span_count.dropped {pull}1809[1809]. -- Rename span.hex_id to span.id {pull}1811[1811]. -- Index error.exception as array of objects {pull}1825[1825] -- Change ownership to apm-server user/group for deb/rpm installs {pull}1833[1833]. -- Add observer.version_major {pull}1857[1857]. -- Change transaction.name to keyword, add transaction.name.text {pull}1859[1859]. -- Change error.culprit to keyword, limit length on intake {pull}1859[1859]. -- Move default index configuration to code {pull}1865[1865]. -- Change default user-agent pipeline to index information under root key `user_agent` {pull}1871[1871]. - -[float] -==== Removed - -- Remove support for deprecated Intake v1 endpoints. {apm-guide-ref}/breaking-7.0.0.html#breaking-remove-v1[More information], {pull}1731[1731]. -- Remove `concurrent_requests` setting and use number of CPUs instead {pull}1749[1749]. -- Remove `frontend` setting {pull}1751[1751]. -- Remove `metrics.enabled` setting {pull}1759[1759]. -- Remove dashboards from being shipped with APM Server and all logic around them {pull}[1815]. - -[float] -[[release-notes-7.0.0-alpha2]] -=== APM Server version 7.0.0-alpha2 - -https://github.com/elastic/apm-server/compare/v7.0.0-alpha1\...v7.0.0-alpha2[View commits] - -[float] -==== Added - -- Update Go to 1.11.2 {pull}1605[1605]. -- Use _doc as document type for {es} >= 7.0.0 https://github.com/elastic/beats/pull/9056[beats/9057]. -- Automatically cap signed integers to 63bits https://github.com/elastic/beats/pull/8991[beats/8991]. -- Build default distribution under the Elastic License. {pull}1645[1645]. -- Log to journald under systemd by default rather than file. To revert this behaviour override BEAT_LOG_OPTS with an empty value https://github.com/elastic/beats/pull/8942[beats/8942] via {pull}1645[1645]. - -[float] -[[release-notes-7.0.0-alpha1]] -=== APM Server version 7.0.0-alpha1 - -No significant changes. diff --git a/changelogs/7.1.asciidoc b/changelogs/7.1.asciidoc deleted file mode 100644 index 699ce4e5d45..00000000000 --- a/changelogs/7.1.asciidoc +++ /dev/null @@ -1,23 +0,0 @@ -[[release-notes-7.1]] -== APM Server version 7.1 - -https://github.com/elastic/apm-server/compare/7.0\...7.1[View commits] - -* <> -* <> - -[float] -[[release-notes-7.1.1]] -=== APM Server version 7.1.1 - -https://github.com/elastic/apm-server/compare/v7.1.0\...v7.1.1[View commits] - -No significant changes. - -[float] -[[release-notes-7.1.0]] -=== APM Server version 7.1.0 - -https://github.com/elastic/apm-server/compare/v7.0.1\...v7.1.0[View commits] - -No significant changes. diff --git a/changelogs/7.10.asciidoc b/changelogs/7.10.asciidoc deleted file mode 100644 index ecf9079bd05..00000000000 --- a/changelogs/7.10.asciidoc +++ /dev/null @@ -1,77 +0,0 @@ -[[release-notes-7.10]] -== APM Server version 7.10 - -https://github.com/elastic/apm-server/compare/7.9\...7.10[View commits] - -* <> -* <> -* <> - -[float] -[[release-notes-7.10.2]] -=== APM Server version 7.10.2 - -https://github.com/elastic/apm-server/compare/v7.10.1\...v7.10.2[View commits] - -No significant changes. - -[float] -[[release-notes-7.10.1]] -=== APM Server version 7.10.1 - -https://github.com/elastic/apm-server/compare/v7.10.0\...v7.10.1[View commits] - -[float] -==== Added -* Upgrade Go to 1.14.12 {pull}4478[4478] - -[float] -==== Bug fixes -* Add maxLen=1024 requirement to `metadata.system.container.id` {pull}4429[4429] - -[float] -[[release-notes-7.10.0]] -=== APM Server version 7.10.0 - -https://github.com/elastic/apm-server/compare/v7.9.2\...v7.10.0[View commits] - -[float] -==== Breaking Changes - -[float] -==== Bug fixes - -* Transaction metrics aggregation now flushes on shutdown, respecting apm-server.shutdown_timeout {pull}3971[3971] -* De-dot Jaeger process tag keys, fixing indexing errors when using jaeger-php {pull}4191[4191] -* Fix json schema validation on `metadata.service.*` fields {pull}4142[4142] -* Fix regression where policy_name was ignored in {ilm-init} setup {pull}4354[4354] - -[float] -==== Intake API Changes -* Changed error messages for invalid events due to internal changes of decoder logic {pull}4261[4261] - -[float] -==== Added - -* Use peer.address for destinationService.Resource if peer.address is not given on Jaeger span {pull}3975[3975] -* Add event.duration to API request logs {pull}4030[4030] -* Set destination.service.* from http.url for Jaeger spans {pull}4046[4046] -* Use service.version for Metadata.Service.Version when converting a Jaeger span {pull}4061[4061] -* Report basic telemetry {pull}4055[4055] -* Add transaction.experience fields {pull}4056[4056] -* Upgrade Go to 1.14.7 {pull}4067[4067] -* Aggregate service destination span metrics {pull}4077[4077] -* Added apm-server.kibana.headers configuration {pull}4087[4087] -* Add a new Docker image based on UBI minimal 8 to packaging. {pull}4105[4105] -* Add event.outcome to transactions and spans {pull}4064[4064] -* Add event.outcome to aggregated transaction metrics {pull}4110[4110] -* Set event.outcome for Jaeger spans based on http.status_code {pull}4127[4127] -* Set event.outcome for transactions and spans based on http.status_code {pull}4165[4165] -* Add mapping for `system.process.cgroup.*` metrics {pull}4176[4176] -* Use transaction.sample_rate to calculate transaction metrics {pull}4212[4212] -* Add longtask metric fields to transaction.experience {pull}4230[4230] - -[float] -==== Comments - -A big thank you to https://github.com/tobiasstadler[@tobiasstadler] for their contributions to this release! diff --git a/changelogs/7.11.asciidoc b/changelogs/7.11.asciidoc deleted file mode 100644 index 6192eb4c612..00000000000 --- a/changelogs/7.11.asciidoc +++ /dev/null @@ -1,55 +0,0 @@ -[[release-notes-7.11]] -== APM Server version 7.11 - -https://github.com/elastic/apm-server/compare/7.10\...7.11[View commits] - -* <> -* <> -* <> - -[float] -[[release-notes-7.11.2]] -=== APM Server version 7.11.2 - -https://github.com/elastic/apm-server/compare/v7.11.1\...v7.11.2[View commits] - -No significant changes. - -[float] -[[release-notes-7.11.1]] -=== APM Server version 7.11.1 - -https://github.com/elastic/apm-server/compare/v7.11.0\...v7.11.1[View commits] - -No significant changes. - -[float] -[[release-notes-7.11.0]] -=== APM Server version 7.11.0 - -https://github.com/elastic/apm-server/compare/v7.10.2\...v7.11.0[View commits] - -[float] -==== Bug fixes -* JSON schema metricset: nest type and subtype under span {pull}4329[4329] -* JSON schema metricset: nest type and name under transaction {pull}4329[4329] -* Carriage returns are now stripped from source-mapped context source lines {pull}4348[4348] -* Remove config defaults from `apm-server export config` {pull}4458[4458] - -[float] -==== Intake API Changes -* Intake RUM v3: Changed error messages for invalid events due to internal changes of decoder logic {pull}4358[4358] -* Auto-generate JSON schemas for Intake API v2 and v3/rum {pull}4393[4393] - -[float] -==== Added -* Monitoring for aggregation of transaction metrics {pull}4287[4287] -* Log warnings in aggregation of transaction metrics when grouping limit is reached {pull}4313[4313] -* Configurable tail-based sampling policies {pull}4320[4320] -* Monitoring and telemetry for tail-based sampling {pull}4346[4346] {pull}4360[4360] -* Experimental support for data streams {pull}4409[4409] -* Label/custom/mark keys are now sanitized (rather than validated and rejected) by the server {pull}4465[4465] -* Upgrade Go to 1.14.12 {pull}4478[4478] -* Added apm-server.response_headers config {pull}4523[4523] -* Switch logging format to be ECS compliant where possible {pull}3829[3829] -* Switch logging format to JSON to work with ECS logging {pull}4590[4590] diff --git a/changelogs/7.12.asciidoc b/changelogs/7.12.asciidoc deleted file mode 100644 index add05408330..00000000000 --- a/changelogs/7.12.asciidoc +++ /dev/null @@ -1,55 +0,0 @@ -[[release-notes-7.12]] -== APM Server version 7.12 - -https://github.com/elastic/apm-server/compare/7.11\...7.12[View commits] - -* <> -* <> - -[float] -[[release-notes-7.12.1]] -=== APM Server version 7.12.1 - -https://github.com/elastic/apm-server/compare/v7.12.0\...v7.12.1[View commits] - -[float] -==== Added -* Upgrade Go to 1.15.9 {pull}5100[5100] - -[float] -[[release-notes-7.12.0]] -== APM Server version 7.12.0 - -https://github.com/elastic/apm-server/compare/v7.11.2\...v7.12.0[View commits] - -[float] -==== Breaking Changes -* Leading 0s are no longer removed from trace/span ids if they are created by Jaeger {pull}4671[4671] -* Jaeger spans will now have a type of "app" where they previously were "custom" {pull}4711[4711] -* Jaeger spans may now have a (more accurate) outcome of "unknown" where they previously were "success" {pull}4711[4711] - -[float] -==== Bug fixes -* Dynamic templates for labels are no longer repeated {pull}4695[4695] -* Tail-based sampling policies are now always matched in the order given {pull}4685[4685] - -[float] -==== Intake API Changes -* Add `cloud.service.name` support for metadata {pull}4626[4626] - -[float] -==== Added -* Jaeger gRPC is now served over the same port as the Elastic {apm-agent} protocol {pull}4618[4618] -* Support for reloading config in {fleet} mode, gracefully stopping the HTTP server and starting a new one {pull}4623[4623] -* Add a `_doc_count` field to transaction histogram docs {pull}4647[4647] -* OpenTelemetry Protocol (OTLP) over gRPC is now supported on the standard endpoint (8200) {pull}4677[4677] {pull}4722[4722] -* Add initial support for APM central config and source maps when running under {fleet} {pull}4670[4670] -* Data stream and {ilm-init} policy for tail-based sampling {pull}4707[4707] -* Add service name to index dataset {pull}4674[4674] -* When tail-sampling is enabled, a default policy must be defined {pull}4729[4729] -* Support additional config options when running under {fleet} {pull}4690[4690] -* Upgrade Go to 1.15.8 {pull}4733[4733] - -[float] -==== Deprecated -* `apm-server.jaeger` config is deprecated and will be removed in 8.0. Jaeger is now served on 8200 {pull}4618[4618] diff --git a/changelogs/7.13.asciidoc b/changelogs/7.13.asciidoc deleted file mode 100644 index 25777b9ea58..00000000000 --- a/changelogs/7.13.asciidoc +++ /dev/null @@ -1,87 +0,0 @@ -[[release-notes-7.13]] -== APM Server version 7.13 - -https://github.com/elastic/apm-server/compare/7.12\...7.13[View commits] - -* <> -* <> -* <> -* <> -* <> - -[float] -[[release-notes-7.13.4]] -=== APM Server version 7.13.4 - -https://github.com/elastic/apm-server/compare/v7.13.3\...v7.13.4[View commits] - -No significant changes. - -[float] -[[release-notes-7.13.3]] -=== APM Server version 7.13.3 - -https://github.com/elastic/apm-server/compare/v7.13.2\...v7.13.3[View commits] - -No significant changes. - -[float] -[[release-notes-7.13.2]] -=== APM Server version 7.13.2 - -https://github.com/elastic/apm-server/compare/v7.13.1\...v7.13.2[View commits] - -No significant changes. - -[float] -[[release-notes-7.13.1]] -=== APM Server version 7.13.1 - -https://github.com/elastic/apm-server/compare/v7.13.0\...v7.13.1[View commits] - -[float] -==== Bug fixes - -* Fix document grouping of translated OpenTelemetry Java metrics {pull}5309[5309] -* model/modeldecoder: fix 32-bit timestamp decoding {pull}5308[5308] -* OpenTelemetry: record array attributes as labels {pull}5286[5286] -* Don't auto-disable {ilm-init} due to a failure to communicate with {es} {pull}5264[5264] - -[float] -[[release-notes-7.13.0]] -=== APM Server version 7.13.0 - -https://github.com/elastic/apm-server/compare/v7.12.1\...v7.13.0[View commits] - -[float] -==== Bug fixes -* Fix `setup.template` config merging {pull}4950[4950] -* The server now responds with 503 instead of 401 when failure is unrelated to API Key validity, e.g. if {es} is inaccessible {pull}5053[5053] -* Fix panic due to misaligned 64-bit access on 32-bit architectures {pull}5277[5277] - -[float] -==== Added -* Add support for Node.js wall time profiles {pull}4728[4728] -* Add `metricset.name` field to metric docs {pull}4857[4857] -* Add `apm-server.default_service_environment` config {pull}4861[4861] -* Transaction histogram metrics are now recorded by default {pull}4882[4882] -* Add `error.grouping_name` field to speed up error grouping aggregations {pull}4886[4886] -* Add support for OpenTelemetry exception span events {pull}4876[4876] -* Set `metricset.name` for breakdown metrics {pull}4910[4910] -* Set log and http responses for server timeout {pull}4918[4918] -* Define ES fields for `cgroup.cpu` and `cgroup.cpuacct` metrics {pull}4956[4956] -* Log gRPC tracing requests {pull}4934[4934] -* Improved coverage of translation of OpenTelemetry resource conventions {pull}4955[4955] -* Set `client.ip` for events from the Elastic APM iOS agent {pull}4975[4975] -* Calculate service destination metrics for OpenTelemetry spans {pull}4976[4976] -* Add exponential retries to api key and tail sampling requests{pull}4991[4991] -* Add `apm-server.rum.allow_service_names` config {pull}5030[5030] -* Ingest pipeline for translating OpenTelemetry Java metrics to Elastic APM fields {pull}4986[4986] -* Set `event.ingested` first in the ingest pipeline {pull}5048[5048] -* The server now responds with a reason for some 401 Unauthorized requests {pull}5053[5053] -* Add `session.id` and `session.sequence` fields for RUM session tracking {pull}5056[5056] -* Support for ingesting `user.domain` {pull}5067[5067] -* Add `"application": "apm"` metadata to API Keys created with `apm-server apikey create` {pull}5090[5090] -* API Key auth is no longer considered experimental {pull}5091[5091] -* Set gRPC status code to `DEADLINE_EXCEEDED` on request timeout {pull}5089[5089] -* Add support for OpenTelemetry RPC semantic conventions {pull}5074[5074] diff --git a/changelogs/7.14.asciidoc b/changelogs/7.14.asciidoc deleted file mode 100644 index c29d05460d7..00000000000 --- a/changelogs/7.14.asciidoc +++ /dev/null @@ -1,68 +0,0 @@ -[[release-notes-7.14]] -== APM Server version 7.14 - -https://github.com/elastic/apm-server/compare/7.13\...7.14[View commits] - -* <> -* <> -* <> - -[float] -[[release-notes-7.14.2]] -=== APM Server version 7.14.2 - -https://github.com/elastic/apm-server/compare/v7.14.1\...v7.14.2[View commits] - -No significant changes. - -[float] -[[release-notes-7.14.1]] -=== APM Server version 7.14.1 - -https://github.com/elastic/apm-server/compare/v7.14.0\...v7.14.1[View commits] - -No significant changes. - -[float] -[[release-notes-7.14.0]] -=== APM Server version 7.14.0 - -https://github.com/elastic/apm-server/compare/v7.13.4\...v7.14.0[View commits] - -[float] -==== Breaking Changes -* Removed monitoring counters `apm-server.processor.stream.errors.{queue,server,closed}` {pull}5453[5453] - -[float] -==== Bug fixes -* Fix panic on {fleet} policy change when transaction metrics or tail-based sampling are enabled {pull}5670[5670] -* Remove multipart form temporary files left behind by source map uploads {pull}5718[5718] -* Removed service name from dataset {pull}5451[5451] -* Fixed tail-based sampling pubsub to use _seq_no correctly {pull}5126[5126] -* Fix apm_error_grouping_name and apm_convert_destination_address {pull}5876[5876] - - -[float] -==== Added -* Support fetching source maps from fleet {pull}5410[5410] -* Add support for more input variables in fleet integration {pull}5444[5444] -* Add debug logging of OpenTelemetry payloads {pull}5474[5474] -* Add support for OpenTelemetry labels describing mobile connectivity {pull}5436[5436] -* Introduce `apm-server.auth.*` config {pull}5457[5457] -* Add support for adjusting OTel event timestamps using `telemetry.sdk.elastic_export_timestamp` {pull}5433[5433] -* Add units to metric fields {pull}5395[5395] -* Add support for histograms to metrics intake {pull}5360[5360] -* Display apm-server url in fleet ui's apm-server integration {pull}4895[4895] -* Translate otel messaging.* semantic conventions to ECS {pull}5334[5334] -* Tail-sampling processor now resumes subscription from previous position after restart {pull}5350[5350] -* Add support for dynamic histogram metrics {pull}5239[5239] -* Support setting agent configuration from apm-server.yml {pull}5177[5177] -* Add metric_type and unit to field metadata of system metrics {pull}5230[5230] -* Under fleet, report which agent configs have been applied {pull}5481[5481] -* Server sends its raw config to kibana when running on ECE/ESS {pull}5424[5424] - -[float] -==== Deprecated -* Make `destination.service.name` and `destination.service.type` fields optional and deprecated {pull}5468[5468] -* `apm-server.secret_token` is now `apm-server.auth.secret_token` {pull}5457[5457] -* `apm-server.api_key` is now `apm-server.auth.api_key` {pull}5457[5457] diff --git a/changelogs/7.15.asciidoc b/changelogs/7.15.asciidoc deleted file mode 100644 index cfd6e6fd0fd..00000000000 --- a/changelogs/7.15.asciidoc +++ /dev/null @@ -1,57 +0,0 @@ -[[release-notes-7.15]] -== APM Server version 7.15 - -https://github.com/elastic/apm-server/compare/7.14\...7.15[View commits] - -* <> -* <> -* <> - -[float] -[[release-notes-7.15.2]] -=== APM Server version 7.15.2 - -https://github.com/elastic/apm-server/compare/v7.15.1\...v7.15.2[View commits] - -No significant changes. - -[float] -[[release-notes-7.15.1]] -=== APM Server version 7.15.1 - -https://github.com/elastic/apm-server/compare/v7.15.0\...v7.15.1[View commits] - -[float] -==== Bug fixes -- dedot `http.request.body.original` {pull}6256[6256] -- processor/otel: don't truncate `db.statement` {pull}6305[6305] - -[float] -[[release-notes-7.15.0]] -=== APM Server version 7.15.0 - -https://github.com/elastic/apm-server/compare/v7.14.2\...v7.15.0[View commits] - -[float] -==== Breaking Changes -- `network.connection_type` is now `network.connection.type` {pull}5671[5671] -- `transaction.page` and `error.page` no longer recorded {pull}5872[5872] -- experimental:["This breaking change applies to the experimental tail-based sampling feature."] `apm-server.sampling.tail` now requires `apm-server.data_streams.enabled` {pull}5952[5952] -- beta:["This breaking change applies to the beta APM integration."] The `traces-sampled-*` data stream is now `traces-apm.sampled-*` {pull}5952[5952] - -[float] -==== Bug fixes -- corrected OTel attribute names for `net.host.connection.*` {pull}5671[5671] -- Fix response to agent config when running under {fleet} with no agent config defined {pull}5917[5917] -- Fix handling of OTLP sum/gauge metrics with integer values {pull}6106[6106] - -[float] -==== Intake API changes -- `network.connection.type` was added to stream metadata {pull}5671[5671] - -[float] -==== Added -- `service_destination` span metrics now take into account composite spans {pull}5896[5896] -- add zero-downtime config reloads via `SO_REUSEPORT` {pull}5911[5911] -- experimental support for writing data streams in standalone mode {pull}5928[5928] -- Data streams now define a default `dynamic` mapping parameter, overridable in the `@custom` template {pull}5947[5947] diff --git a/changelogs/7.16.asciidoc b/changelogs/7.16.asciidoc deleted file mode 100644 index db5fdc4fc21..00000000000 --- a/changelogs/7.16.asciidoc +++ /dev/null @@ -1,107 +0,0 @@ -[[release-notes-7.16]] -== APM version 7.16 - -https://github.com/elastic/apm-server/compare/7.15\...7.16[View commits] - -* <> -* <> -* <> -* <> - -[float] -[[release-notes-7.16.3]] -=== APM Server version 7.16.3 - -https://github.com/elastic/apm-server/compare/v7.16.2\...v7.16.3[View commits] - -No significant changes. - -[float] -[[release-notes-7.16.2]] -=== APM Server version 7.16.2 - -https://github.com/elastic/apm-server/compare/v7.16.1\...v7.16.2[View commits] - -No significant changes. - -[float] -[[release-notes-7.16.1]] -=== APM version 7.16.1 - -https://github.com/elastic/apm-server/compare/v7.16.0\...v7.16.1[View commits] - -[float] -==== Bug fixes -- Agent configuration metrics are now sent to the `metrics-apm.internal*` data stream {pull}6767[6767] -- Improve logged message when APM Server blocks ingestion to wait for the integration to be installed {pull}6796[6796] - -[float] -[[release-notes-7.16.0]] -=== APM version 7.16.0 - -https://github.com/elastic/apm-server/compare/v7.15.2\...v7.16.0[View commits] - -**** -The APM integration for {agent} is now generally available! -This new APM ecosystem brings a number of new benefits to Elastic APM. -Learn more about this change in the {apm-guide-ref}/upgrade-to-apm-integration.html[Upgrade guide]. -Documentation for standalone APM Server has moved to the {apm-guide-ref}/legacy-apm-overview.html[Legacy APM Overview] and {apm-guide-ref}/overview.html[Legacy APM Server Reference]. -**** - -[float] -==== Breaking Changes -- Removed unused stack trace/frame monitoring counters {pull}5984[5984] -- Removed unused support for top-level metricsets and metricset tags for RUMv3 {pull}6065[6065] -- Removed `apm-server.mode` configuration, and "experimental" fields {pull}6086[6086] -- `transaction.sampled` is now only set for sampled transactions {pull}6066[6066] -- Unknown metrics are dropped when `transaction.*` or `span.*` are present in a metricset {pull}6111[6111] -- Removed `metricset.period` from service_destination metrics {pull}6111[6111] -- Removed `http.request.socket` fields {pull}6152[6152] -- Removed unused `transaction.duration.{count,sum.us}` metric fields {pull}6180[6180] -- Removed `ProcessPending` self-instrumentation events {pull}6243[6243] -- Removed warm phase from default {ilm-init} policy {pull}6322[6322] -- Removed unused `transaction.breakdown.count` metric field {pull}6366[6366] -- experimental:["This breaking change applies to the experimental tail-based sampling feature."] Changed `apm-server.sampling.tail.events.*` metrics semantics {pull}6273[6273] -- experimental:["This breaking change applies to the experimental tail-based sampling feature."] Removed `apm-server.sampling.tail.storage_dir` config {pull}6236[6236] - -[float] -==== Bug fixes -- Use timestamp of original events for transaction/span metrics {pull}6311[6311] -- Populate the timestamp field for `agent_config` metricsets {pull}6382[6382] -- Query elasticsearch output `cluster_uuid` on startup {pull}6591[6591] -- Skip unhandled fields in bulk responses in the experimental {es} output {pull}6631[6631] -- Fix the format of `@timestamp` to include fractional seconds when using experimental {es} output {pull}6646[6646] -- NaN and +/-Inf values are now filtered out when translating OTLP metrics {pull}6698[6698] - -[float] -==== Intake API changes -- `faas`, `service.origin.*`, and `cloud.origin.*` added for supporting function as a service fields {pull}6161[6161] -- `context.message.routing_key` was added to the intake API {pull}6177[6177] -- `transaction.dropped_spans_stats` was added to the intake API {pull}6200[6200] -- map incoming OTel spans from agent bridges to apm spans/transactions {pull}6308[6308] - -[float] -==== Added -- The `error.log.message` or `error.exception.message` field of errors will be copied to the ECS field `message` {pull}5974[5974] -- Add histogram dynamic_template to app metrics data stream {pull}6043[6043] -- With `apm-server.data_streams.enabled` in standalone mode, the server now accepts and enqueues events while waiting for the integration to be installed {pull}6130[6130] -- We now collect span destination metrics for transactions with too many spans (for example due to transaction_max_spans or exit_span_min_duration) when collected and sent by APM agents {pull}6200[6200] -- Define index sorting for internal metrics data stream {pull}6116[6116] -- Index OpenTelemetry span events and Jaeger logs into a log data stream {pull}6122[6122] -- HTTP server errors (e.g. TLS handshake errors) are now logged {pull}6141[6141] -- Span documents now duplicate extended HTTP fields, which were previously only under `span.http.*`, under `http.*` {pull}6147[6147] -- We now record the direct network peer for incoming requests as `source.ip` and `source.port`; origin IP is recorded in `client.ip` {pull}6152[6152] -- Add an experimental endpoint for AWS Kinesis Data Firehose {pull}6299[6299] -- `output.elasticsearch.experimental` can be used to enable a new, experimental {es} output using the go-elasticsearch client {pull}5970[5970] -- Added support for gzip compression to the experimental {es} output {pull}6449[6449] -- When `auth.anonymous.enabled` isn't specified and RUM is enabled (`rum.enabled:true`), `auth.anonymous.enabled` will be set to `true` {pull}6607[6607] -- Transaction metrics now also group by `service.node.name`, `cloud.provider`, `cloud.region`, `cloud.availability_zone` {pull}6323[6323] - -[float] -==== Deprecated -- Setting `service.version` as a span tag (Jaeger) or attribute (OTel) is deprecated; use tracer tags (Jaeger) and resource attributes (OTel) {pull}6131[6131] -- Setting up {es} templates, {ilm-init} policies, and pipelines directly with apm-server is now deprecated. Users should use the integration package {pull}6145[6145] -- `span.http.*` fields are deprecated, replaced by `http.*`, and will be removed in 8.0 {pull}6147[6147] -- Add deprecation warning for `sampling.keep_unsampled=true` {pull}6285[6285] -- `processors.*` config, which was never officially supported in apm-server, is now explicitly deprecated and will be removed in 8.0 {pull}6367[6367] -- Support for uploading source maps to APM Server is deprecated, and will be removed in 8.0. Users should use the new {kib} REST API in conjunction with the integration package {pull}6432[6432] diff --git a/changelogs/7.2.asciidoc b/changelogs/7.2.asciidoc deleted file mode 100644 index 72a8a132fbf..00000000000 --- a/changelogs/7.2.asciidoc +++ /dev/null @@ -1,35 +0,0 @@ -[[release-notes-7.2]] -== APM Server version 7.2 - -https://github.com/elastic/apm-server/compare/7.1\...7.2[View commits] - -* <> -* <> - -[float] -[[release-notes-7.2.1]] -=== APM Server version 7.2.1 - -https://github.com/elastic/apm-server/compare/v7.2.0\...v7.2.1[View commits] - -[float] -==== Bug fixes -- Update `apm-server.yml` to reflect pipeline overwrite behavior {pull}2452[2452]. - -[float] -[[release-notes-7.2.0]] -=== APM Server version 7.2.0 - -https://github.com/elastic/apm-server/compare/v7.1.0\...v7.2.0[View commits] - -[float] -==== Added -- Make stack trace lineno optional {pull}2105[2105]. -- Return response body with number of accepted events when queries pass a `verbose` param. {pull}2110[2110]. -- Add Idle timeout to server config {pull}2122[2122]. -- Upgrade Go to 1.12.4 {pull}2132[2132]. -- Add geoip processing to the default ingest pipeline {pull}2177[2177]. -- Add ephemeral_id attribute in the metadata {pull}2179[2179]. -- Add {ilm-init} support for APM Server, using fixed policies {pull}2099[2099], {pull}2209[2209]. -- Add `setup --index-management` cmd, deprecate `setup --template` cmd {pull}2180[2180], {pull}2099[2099]. -- Support more SSL config options for agent/server communication {pull}2224[2224], {pull}2281[2281]. diff --git a/changelogs/7.3.asciidoc b/changelogs/7.3.asciidoc deleted file mode 100644 index 12b62754c21..00000000000 --- a/changelogs/7.3.asciidoc +++ /dev/null @@ -1,45 +0,0 @@ -[[release-notes-7.3]] -== APM Server version 7.3 - -https://github.com/elastic/apm-server/compare/7.2\...7.3[View commits] - -* <> -* <> -* <> - -[float] -[[release-notes-7.3.2]] -=== APM Server version 7.3.2 - -https://github.com/elastic/apm-server/compare/v7.3.1\...v7.3.2[View commits] - -No significant changes. - -[float] -[[release-notes-7.3.1]] -=== APM Server version 7.3.1 - -https://github.com/elastic/apm-server/compare/v7.3.0\...v7.3.1[View commits] - -No significant changes. - -[float] -[[release-notes-7.3.0]] -=== APM Server version 7.3.0 - -https://github.com/elastic/apm-server/compare/v7.2.1\...v7.3.0[View commits] - -[float] -==== Bug fixes -- Abort server startup on source map configuration error {pull}2278[2278]. -- Process all user-agent information from headers {pull}2271[2271]. - -[float] -==== Added -- Support adding transaction and span information to metrics {pull}2265[2265], {pull}2287[2287]. -- Initial support for remote agent configuration, requires {kib} {pull}2289[2289], {pull}2301[2301], {pull}2386[2386], {pull}2407[2407], {pull}2421[2421], {pull}2441[2441], {pull}2443[2443]. -- Add basic caching to remote agent configuration {pull}2337[2337]. -- Enable APM pipeline by default {pull}2301[2301]. -- Add fields required by breakdown graphs APM pipeline by default {pull}2315[2315], {pull}2397[2397]. -- Require client auth when CA is configured and SSL enabled {pull}2340[2340]. -- Enable {ilm-init} by default when configured {es} >= 7.0 {pull}2356[2356]. diff --git a/changelogs/7.4.asciidoc b/changelogs/7.4.asciidoc deleted file mode 100644 index 169abd88ddf..00000000000 --- a/changelogs/7.4.asciidoc +++ /dev/null @@ -1,42 +0,0 @@ -[[release-notes-7.4]] -== APM Server version 7.4 - -https://github.com/elastic/apm-server/compare/7.3\...7.4[View commits] - -* <> -* <> - -[float] -[[release-notes-7.4.1]] -=== APM Server version 7.4.1 - -https://github.com/elastic/apm-server/compare/v7.4.0\...v7.4.1[View commits] - -[float] -==== Bug fixes -- Ensure only valid IP addresses are indexed in `client.ip` {pull}2772[2772]. - -[float] -[[release-notes-7.4.0]] -=== APM Server version 7.4.0 - -https://github.com/elastic/apm-server/compare/v7.3.1\...v7.4.0[View commits] - -[float] -==== Bug fixes -- Return 404 json error on requests to non existing paths {pull}2526[2526]. -- Remove additional nesting of error values in logs {pull}2526[2526]. -- Remove requests to root, assets and agent config API from monitoring counters for Intake API {pull}2527[2527]. -- Make metricset timestamp optional {pull}2711[2711]. - -[float] -==== Added -- Add config option to disable source mapping {pull}2488[2488]. -- Store service environment for spans {pull}2500[2500]. -- Index span.db.link field as keyword {pull}2504[2504]. -- Add support for exception trees with cause attribute {pull}2541[2541], {pull}2609[2609]. -- Use dedicated monitoring counters for all APIs {pull}2527[2527]. -- Adapt log info to use keyword over generic information {pull}2528[2528]. -- Add support for host.name, adapt Intake API to accept detected and configured host information {pull}2531[2531], {pull}2540[2540]. -- Index `http.request.socket.remote_address` as `client.ip` {pull}2588[2588]. -- Upgrade Go to 1.12.9 {pull}2635[2635]. diff --git a/changelogs/7.5.asciidoc b/changelogs/7.5.asciidoc deleted file mode 100644 index 62c20731160..00000000000 --- a/changelogs/7.5.asciidoc +++ /dev/null @@ -1,55 +0,0 @@ -[[release-notes-7.5]] -== APM Server version 7.5 - -https://github.com/elastic/apm-server/compare/7.4\...7.5[View commits] - -* <> -* <> -* <> - -[float] -[[release-notes-7.5.2]] -=== APM Server version 7.5.2 - -https://github.com/elastic/apm-server/compare/v7.5.1\...v7.5.2[View commits] - -No significant changes. - -[float] -[[release-notes-7.5.1]] -=== APM Server version 7.5.1 - -https://github.com/elastic/apm-server/compare/v7.5.0\...v7.5.1[View commits] - -[float] -==== Bug fixes -- Update {kib} client when its version becomes stale {pull}3031[3031]. - -[float] -[[release-notes-7.5.0]] -=== APM Server version 7.5.0 - -https://github.com/elastic/apm-server/compare/v7.4.1\...v7.5.0[View commits] - -[float] -==== Breaking Changes -- Introduce dedicated {ilm-init} setup flags and ignore `setup.template.*` flags for {ilm-init} {pull}2764[2764], {pull}2877[2877]. -- Remove {ilm-init} specific templates from `apm-server export template` command {pull}2764[2764]. - -[float] -==== Bug fixes -- Fix a denial of service flaw when parsing malformed DSA public keys in Go. -If APM Server is configured to accept incoming TLS connections with client -authentication enabled, a remote attacker could cause the APM Server to stop -processing events (CVE-2019-17596). -See https://www.elastic.co/community/security/[Elastic security issues]. - -[float] -==== Added -- Add `service.node.configured_name` to Intake API and transform to `service.node.name` for ES output {pull}2746[2746]. -- Index value from `client.ip` in `source.ip` for ECS compatibility {pull}2771[2771]. -- Make {ilm-init} policies configurable {pull}2764[2764]. -- Add support for agent config GA {pull}2747[2747]. -- Change {ilm-init} default policies to rollover after 30 days {pull}2798[2798]. -- Introduce `apm-server.ilm.setup.overwrite` config option and stop overwriting by default {pull}2877[2877]. -- Upgrade Go to 1.12.12 {pull}2922[2922]. diff --git a/changelogs/7.6.asciidoc b/changelogs/7.6.asciidoc deleted file mode 100644 index 369dd4c7c2a..00000000000 --- a/changelogs/7.6.asciidoc +++ /dev/null @@ -1,54 +0,0 @@ -[[release-notes-7.6]] -== APM Server version 7.6 - -https://github.com/elastic/apm-server/compare/7.5\...7.6[View commits] - -* <> -* <> -* <> - -[float] -[[release-notes-7.6.2]] -=== APM Server version 7.6.2 - -https://github.com/elastic/apm-server/compare/v7.6.1\...v7.6.2[View commits] - -No significant changes. - -[float] -[[release-notes-7.6.1]] -=== APM Server version 7.6.1 - -https://github.com/elastic/apm-server/compare/v7.6.0\...v7.6.1[View commits] - -[float] -==== Added -* Upgrade Go to 1.13.8 {pull}3326[3326] - -[float] -[[release-notes-7.6.0]] -=== APM Server version 7.6.0 - -https://github.com/elastic/apm-server/compare/v7.5.2\...v7.6.0[View commits] - -[float] -==== Intake API Changes -- Add support for `span.context.db.rows_affected` {pull}3095[3095]. -- Add support for `classname` as `stacktrace` frame attribute {pull}3096[3096]. -- Add support for `message.*` information for spans and transactions {pull}3104[3104]. - -[float] -==== Added -- Adds support for global labels in spans {pull}2806[2806]. -- Updated `go.elastic.co/apm` to v1.6.0, enabling central config {pull}2913[2913]. -- Use go-elasticsearch client for fetching source maps from {es} {pull}2897[2897]. -- Try to extract IP address from headers before using socket remote_address for `client.ip` and `source.ip` {pull}2935[2935]. -- Only use extracted hostname when valid IP for enriching events {pull}2935[2935]. -- Added experimental support for continuous profiling of the server {pull}2839[2839]. -- Build UBI based images also {pull}2994[2994]. -- Adds support for API Key authorization for incoming requests {pull}3004[3004]. -- Add experimental support for receiving Jaeger trace data {pull}3129[3129]. -- Upgrade APM Go agent to 1.7.0, and add support for API Key auth for self-instrumentation {pull}3134[3134]. -- Add correlation for server trace/log data {pull}3136[3136]. -- Add subcommand to create API Keys {pull}3063[3063]. -- Upgrade Go to 1.13.7 {pull}3264[3264]. diff --git a/changelogs/7.7.asciidoc b/changelogs/7.7.asciidoc deleted file mode 100644 index ef8db69b67a..00000000000 --- a/changelogs/7.7.asciidoc +++ /dev/null @@ -1,48 +0,0 @@ -[[release-notes-7.7]] -== APM Server version 7.7 - -https://github.com/elastic/apm-server/compare/7.6\...7.7[View commits] - -* <> -* <> - -[float] -[[release-notes-7.7.1]] -=== APM Server version 7.7.1 - -https://github.com/elastic/apm-server/compare/v7.7.0\...v7.7.1[View commits] - -No significant changes. - -[float] -[[release-notes-7.7.0]] -=== APM Server version 7.7.0 - -https://github.com/elastic/apm-server/compare/v7.6.2\...v7.7.0[View commits] - -[float] -==== Breaking Changes -* Remove enroll subcommand {pull}3270[3270]. - -[float] -==== Bug fixes -* Merge default values with custom {es} config for API Keys and add `required` tag for `host` {pull}3342[3342] -* Merge default values with custom Source map {es} config {pull}3355[3355] - -[float] -==== Intake API Changes -* Add `transfer_size`, `encoded_body_size` and `decoded_body_size` to `transaction.context.http.response` {pull}3327[3327] -* Add `transfer_size`, `encoded_body_size`, `decoded_body_size` and `headers` to `span.context.http.response` {pull}3327[3327] -* Deprecate `span.context.http.status_code` in favor of newly introduced `span.context.http.response.status_code` {pull}3327[3327] - -[float] -==== Added -* Instrumentation for go-elasticsearch {pull}3305[3305] -* Make the list of Access-Control-Allow-Headers for RUM preflight requests configurable {pull}3299[3299] -* Instrumentation for kibana client {pull}3359[3359] -* Added support for Jaeger auth tags {pull}3394[3394] -* Add pipeline for removing metadata fields from spans {pull}3408[3408] -* Add gRPC sampling endpoint for Jaeger {pull}3490[3490] -* Change default value for apm-server.ssl.client_authentication from optional to none {pull}3500[3500] -* Enabled instrumentation of source maps {pull}3515[3515] -* Upgrade Go to 1.13.9 {pull}3539[3539] diff --git a/changelogs/7.8.asciidoc b/changelogs/7.8.asciidoc deleted file mode 100644 index c1b802c6a89..00000000000 --- a/changelogs/7.8.asciidoc +++ /dev/null @@ -1,40 +0,0 @@ -[[release-notes-7.8]] -== APM Server version 7.8 - -https://github.com/elastic/apm-server/compare/7.7\...7.8[View commits] - -* <> -* <> - -[float] -[[release-notes-7.8.1]] -=== APM Server version 7.8.1 - -https://github.com/elastic/apm-server/compare/v7.8.0\...v7.8.1[View commits] - -No significant changes. - -[float] -[[release-notes-7.8.0]] -=== APM Server version 7.8.0 - -https://github.com/elastic/apm-server/compare/v7.7.0\...v7.8.0[View commits] - -[float] -==== Bug fixes -* Ensure applied flag can be set for agent configurations fetched for Jaeger {pull}3677[3677]. -* Negative transaction and span durations now cause a schema validation error {pull}3721[3721]. - -[float] -==== Intake API Changes -* Add span child_ids intake {pull}3679[3679]. -* Add cloud metadata intake {pull}3729[3729]. - -[float] -==== Added -* RUM V3 endpoint {pull}3328[3328], {pull}3414[3414], {pull}3512[3512], {pull}3526[3526], {pull}3616[3616], {pull}3648[3648], {pull}3659[3659], {pull}3733[3733]. -* Publish libbeat metrics through the /debug/vars endpoint {pull}3550[3550]. -* Introduce transaction.duration.histogram aggregation {pull}3651[3651]. -* Introduce config to drop unsampled transactions {pull}3702[3702]. -* Add `logging.ecs` to add minimal required ECS logging fields to log lines {pull}3749[3749]. -* Upgrade Go to 1.13.10 {pull}3834[3834]. diff --git a/changelogs/7.9.asciidoc b/changelogs/7.9.asciidoc deleted file mode 100644 index 9ca9e5f2f07..00000000000 --- a/changelogs/7.9.asciidoc +++ /dev/null @@ -1,74 +0,0 @@ -[[release-notes-7.9]] -== APM Server version 7.9 - -https://github.com/elastic/apm-server/compare/7.8\...7.9[View commits] - -[IMPORTANT] -==== -*Known Issue:* APM Server introduced support for cloud metadata in v7.9 ({pull}3729[3729]). -Unfortunately, the JSON Schema was too strict, and does not account for `null` values. -As a result, sending `null` values for cloud metadata causes the payload to be rejected. -This issue was resolved in v7.10.0 ({pull}4142[4142]). -To avoid problems, we recommend updating to version ≥7.10.0. -==== - -* <> -* <> -* <> -* <> - -[float] -[[release-notes-7.9.3]] -=== APM Server version 7.9.3 - -https://github.com/elastic/apm-server/compare/v7.9.2\...v7.9.3[View commits] - -[float] -==== Bug fixes -* Ensure custom index names are lowercased {pull}4295[4295], {pull}4322[4322] - -[float] -[[release-notes-7.9.2]] -=== APM Server version 7.9.2 - -https://github.com/elastic/apm-server/compare/v7.9.1\...v7.9.2[View commits] - -[float] -==== Bug fixes -* De-dot metadata labels set from process and resource tags to prevent indexing errors {pull}4193[4193] - -[float] -[[release-notes-7.9.1]] -=== APM Server version 7.9.1 - -https://github.com/elastic/apm-server/compare/v7.9.0\...v7.9.1[View commits] - -[float] -==== Bug fixes -* Honour output.elasticsearch.headers configuration in API Key auth and source mapping {pull}4090[4090] - -[float] -[[release-notes-7.9.0]] -=== APM Server version 7.9.0 - -https://github.com/elastic/apm-server/compare/v7.8.0\...v7.9.0[View commits] - -[float] -==== Bug fixes -* Ensure unique names in dynamic templates for fields {pull}3832[3832] -* Process `user_agent` and `client.ip` for RUM Intake v3 requests {pull}3943[3943] - -[float] -==== Added -* Support configurable response headers for the RUM endpoints {pull}3820[3820] -* Support custom {ilm-init} index suffix {pull}3826[3826], {pull}3905[3905] -* Jaeger traceIds/spanIds are formatted without leading zeros {pull}3849[3849] -* Index Page URL and referer as ECS fields {pull}3857[3857] -* Map the Jaeger attribute message_bus.destination to the Elastic APM type messaging {pull}3884[3884] -* Added user_agent.name to grouping key for page-load transaction metrics {pull}3886[3886] -* Map the Jaeger attribute peer.service to span.destination.service.name {pull}3897[3897] -* Add timeseries.instance to transaction.duration.histogram docs {pull}3904[3904] -* Uses `instrumentation` config and APM tracer from libbeat, deprecating `apm-server.instrumentation` {pull}3836[3836] -* Scale Jaeger transaction counts by inverse sampling rate in histogram metrics {pull}3722[3722] -* Use peer.hostname for destination.address if peer.address is not given on Jaeger span {pull}3969[3969] -* Upgrade Go to 1.14.4 {pull}3961[3961] diff --git a/changelogs/8.0.asciidoc b/changelogs/8.0.asciidoc deleted file mode 100644 index 3a18fbe9d89..00000000000 --- a/changelogs/8.0.asciidoc +++ /dev/null @@ -1,197 +0,0 @@ -[[apm-release-notes-8.0]] -== APM version 8.0 - -* <> -* <> -* <> -* <> -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.0.1]] -=== APM version 8.0.1 - -https://github.com/elastic/apm-server/compare/v8.0.0\...v8.0.1[View commits] - -[float] -==== Bug fixes - -- Fix mixing of labels across OpenTelemetry log records {pull}7358[7358] -- Fix panic when processing OpenTelemetry histogram metrics without bounds {pull}7316[7316] -- Fix waiting for events to be flushed when shutting down APM Server {pull}7352[7352] - -[float] -[[apm-release-notes-8.0.0]] -=== APM version 8.0.0 - -https://github.com/elastic/apm-server/compare/v7.16.3\...v8.0.0[View commits] - -These release notes include all changes made in the alpha, beta, and RC -releases of 8.0.0. - -[float] -==== Breaking Changes -- Removed source map upload endpoint {pull}6447[6447] -- Removed unsupported libbeat `processors` configuration {pull}6474[6474] -- Introduced a delete phase for all data streams. Traces, errors and logs are kept for 10 days, metrics are kept for 90 days {pull}6480[6480] -- Changed RUM traces to use a dedicated data stream (`traces-apm.rum`). RUM traces are kept for 90 days {pull}6480[6480] -- Removed `apm-server.aggregation.transactions.enabled` configuration option {pull}6495[6495] -- Removed `apm-server.aggregation.service_destinations.enabled` configuration option {pull}6503[6503] -- Removed legacy Jaeger gRPC/HTTP endpoints {pull}6417[6417] -- Removed `apm-server.jaeger` configuration options {pull}6560[6560] -- Removed `apm-server.instrumentation` configuration options in favor of `instrumentation` {pull}6560[6560] -- Removed `apm-server.rum.{allowed_service,event_rate}` configuration option in favor of `apm-server.auth.anonymous.{allow_service,rate_limit}` {pull}6560[6560] -- Removed `apm-server.{api_key,secret_token}` configuration options in favor of `apm-server.auth.{api_key,secret_token}` {pull}6560[6560] -- Removed unused `span.start.us` field, and deprecated `span.http.*` fields {pull}6602[6602] -- Removed `apm-server.register.ingest.pipeline` and `output.elasticsearch.pipeline` configuration options {pull}6575[6575] -- Removed `logging.ecs` and `logging.json` config {pull}6613[6613] -- Removed `apm-server.data_streams.enabled`, and `setup.*` configuration options {pull}6606[6606] -- Removed `apm-server.sampling.keep_unsampled` configuration option; non-RUM unsampled transactions are always dropped {pull}6514[6514] {pull}6669[6669] -- Removed interpretation of non-standard "component" attribute from OpenTelemetry spans; changed default span type and subtypes {pull}6834[6834] -- Onboarding documents are no longer indexed {pull}6431[6431] -- APM Server now responds with 403 (HTTP) and PermissionDenied (gRPC) for authenticated but unauthorized requests {pull}5545[5545] -- `sourcemap.error` and `sourcemap.updated` are no longer set due to failing to find a matching source map {pull}5631[5631] -- Removed `service.name` from dataset {pull}5451[5451] -- Removed support for `fields` config {pull}10865[10865] - -[float] -==== Added -- Standalone apm-server can now fetch source maps uploaded to {kib}, when `apm-server.kibana` is configured {pull}6447[6447] -- Added metrics for new {es} output: `libbeat.output.events.{acked,batches,toomany}`; added tracing and log correlation {pull}6630[6630] -- The `labels` indexed field is now ECS compliant (string only) and added a new `numeric_labels` object that holds labels with numeric values {pull}6633[6633] -- APM Server is now using a new {es} output implementation {pull}6656[6656] -- Modify default standalone apm-server config values to be more in line with the default managed apm-server values {pull}6675[6675] -- APM Server now has beta support to receive OpenTelemetry Logs on the OTLP/GRPC receiver {pull}6768[6768] -- experimental: Add support for CloudWatch metric streams through firehose endpoint {pull}6380[6380] -- Add HTTP span fields as top level ECS fields {pull}5396[5396] -- Introduce `apm-server.auth.anonymous.*` config {pull}5623[5623] -- Upgrade Go to 1.17.6 {pull}7207[7207] -- Introduce ingest pipeline `apm_data_stream_migration` for migrating pre-data stream indices {pull}5768[5768] - -[float] -==== Bug fixes -- `host.ip` is now stored as an array, as specified by ECS {pull}6694[6694] -- In accord with ECS, the server logs now set `source.address` to the immediate network peer's IP address, and `client.ip` to the originating client IP if known {pull}6690[6690] -- Agent configuration metrics are now sent to the metrics-apm.internal* data stream {pull}6767[6767] -- Improve logged message when APM Server blocks ingestion to wait for the integration to be installed {pull}6796[6796] - -[float] -==== Intake API Changes -- `transaction.name` was added to the error objects in the intake API {pull}6539[6539] -- Add support for composite spans in the intake API {pull}5661[5661] -- Allow to overwrite `service.name` and `service.version` for metricset objects {pull}6407[6407] - -[float] -==== Licensing Changes -- Updated the `x-pack` source files license to the Elastic License 2.0 {pull}6524[6524] - -[float] -[[apm-release-notes-8.0.0-rc2]] -=== APM version 8.0.0-rc2 - -https://github.com/elastic/apm-server/compare/v8.0.0-rc1\...v8.0.0-rc2[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.0.0-rc1]] -=== APM version 8.0.0-rc1 - -https://github.com/elastic/apm-server/compare/v8.0.0-beta1\...v8.0.0-rc1[View commits] - -[float] -==== Breaking Changes -- Removed source map upload endpoint {pull}6447[6447] -- Removed unsupported libbeat `processors` configuration {pull}6474[6474] -- Removed `apm-server.aggregation.transactions.enabled` configuration option {pull}6495[6495] -- Removed `apm-server.aggregation.service_destinations.enabled` configuration option {pull}6503[6503] -- Removed legacy Jaeger gRPC/HTTP endpoints {pull}6417[6417] -- Removed `apm-server.jaeger` configuration options {pull}6560[6560] -- Removed `apm-server.instrumentation` configuration options in favor of `instrumentation` {pull}6560[6560] -- Removed `apm-server.rum.{allowed_service,event_rate}` configuration option in favor of `apm-server.auth.anonymous.{allow_service,rate_limit}` {pull}6560[6560] -- Removed `apm-server.{api_key,secret_token}` configuration options in favor of `apm-server.auth.{api_key,secret_token}` {pull}6560[6560] -- Removed unused `span.start.us` field, and deprecated `span.http.*` fields {pull}6602[6602] -- Removed `apm-server.register.ingest.pipeline` and `output.elasticsearch.pipeline` configuration options {pull}6575[6575] -- Removed `logging.ecs` and `logging.json` config {pull}6613[6613] -- Removed `apm-server.data_streams.enabled`, and `setup.*` configuration options {pull}6606[6606] -- Removed `apm-server.sampling.keep_unsampled` configuration option; non-RUM unsampled transactions are always dropped {pull}6514[6514] {pull}6669[6669] -- Removed interpretation of non-standard "component" attribute from OpenTelemetry spans; changed default span type and subtypes {pull}6834[6834] -- Onboarding documents are no longer indexed {pull}6431[6431] - -[float] -==== Bug fixes -- `host.ip` is now stored as an array, as specified by ECS {pull}6694[6694] -- In accord with ECS, the server logs now set `source.address` to the immediate network peer's IP address, and `client.ip` to the originating client IP if known {pull}6690[6690] -- Agent configuration metrics are now sent to the metrics-apm.internal* data stream {pull}6767[6767] -- Improve logged message when APM Server blocks ingestion to wait for the integration to be installed {pull}6796[6796] - -[float] -==== Intake API Changes -- `transaction.name` was added to the error objects in the intake API {pull}6539[6539] - -[float] -==== Added -- Introduced a delete phase for all data streams. Traces, errors and logs are kept for 10 days, metrics are kept for 90 days {pull}6480[6480] -- Changed RUM traces to use a dedicated data stream (`traces-apm.rum`). RUM traces are kept for 90 days {pull}6480[6480] -- Standalone apm-server can now fetch source maps uploaded to {kib}, when `apm-server.kibana` is configured {pull}6447[6447] -- Added metrics for new {es} output: `libbeat.output.events.{acked,batches,toomany}`; added tracing and log correlation {pull}6630[6630] -- The `labels` indexed field is now ECS compliant (string only) and added a new `numeric_labels` object that holds labels with numeric values {pull}6633[6633] -- APM Server is now using a new {es} output implementation {pull}6656[6656] -- Modify default standalone apm-server config values to be more in line with the default managed apm-server values {pull}6675[6675] -- APM Server now has beta support to receive OpenTelemetry Logs on the OTLP/GRPC receiver {pull}6768[6768] - -[float] -==== Licensing Changes -- Updated the `x-pack` source files license to the Elastic License 2.0 {pull}6524[6524] - -[float] -[[apm-release-notes-8.0.0-beta1]] -=== APM version 8.0.0-beta1 - -https://github.com/elastic/apm-server/compare/v8.0.0-alpha2\...v8.0.0-beta1[View commits] - -[float] -==== Added -- experimental:[] Add support for CloudWatch metric streams through firehose endpoint {pull}6380[6380] - -[float] -==== Intake API Changes -- Allow to overwrite `service.name` and `service.version` for metricset objects {pull}6407[6407] - -[float] -[[apm-release-notes-8.0.0-alpha2]] -=== APM version 8.0.0-alpha2 - -https://github.com/elastic/apm-server/compare/v8.0.0-alpha1\...v8.0.0-alpha2[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.0.0-alpha1]] -=== APM version 8.0.0-alpha1 - -[float] -==== Breaking Changes -* APM Server now responds with 403 (HTTP) and PermissionDenied (gRPC) for authenticated but unauthorized requests {pull}5545[5545] -* `sourcemap.error` and `sourcemap.updated` are no longer set due to failing to find a matching source map {pull}5631[5631] -* experimental:["This breaking change applies to the experimental APM integration."] Removed `service.name` from dataset {pull}5451[5451] - -// [float] -// ==== Bug fixes - -[float] -==== Intake API Changes -* Add support for composite spans in the intake API {pull}5661[5661] - -[float] -==== Added -* Upgrade Go to 1.16.5 {pull}5454[5454] -* Add HTTP span fields as top level ECS fields {pull}5396[5396] -* Introduce `apm-server.auth.anonymous.*` config {pull}5623[5623] -* Upgrade Go to 1.16.6 {pull}5754[5754] -* Introduce ingest pipeline `apm_data_stream_migration` for migrating pre-data stream indices {pull}5768[5768] - -// [float] -// ==== Deprecated diff --git a/changelogs/8.1.asciidoc b/changelogs/8.1.asciidoc deleted file mode 100644 index 217cc2f209d..00000000000 --- a/changelogs/8.1.asciidoc +++ /dev/null @@ -1,58 +0,0 @@ -[[apm-release-notes-8.1]] -== APM version 8.1 - -* <> -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.1.3]] -=== APM version 8.1.3 - -https://github.com/elastic/apm-server/compare/v8.1.2\...v8.1.3[View commits] - -This release includes an important APM Server bug fix. -Users running APM Server version 8.0.0 and above should upgrade immediately. - -[float] -==== Bug fixes -- Fix a bug that caused the APM Server to run out of memory when it receives events from a high number of APM agents {pull}7809[7809] - -[float] -[[apm-release-notes-8.1.2]] -=== APM version 8.1.2 - -https://github.com/elastic/apm-server/compare/v8.1.1\...v8.1.2[View commits] - -[float] -==== Bug fixes -- When gzip compressing {es} bulk requests, set the end of stream marker {pull}7624[7624] -- Fix setting a timestamp on RUM data when capturing personal data is disabled {pull}7567[7567] -- modelindexer: Fix indexing performance regression due to locking bug {pull}7649[7649] - -[float] -[[apm-release-notes-8.1.1]] -=== APM version 8.1.1 - -https://github.com/elastic/apm-server/compare/v8.1.0\...v8.1.1[View commits] - -[float] -==== Bug fixes -- Fix missing stack monitoring metrics {pull}7428[7428] - - -[float] -[[apm-release-notes-8.1.0]] -=== APM version 8.1.0 - -https://github.com/elastic/apm-server/compare/v8.0.1\...v8.1.0[View commits] - -[float] -==== Added -- Tail-based sampling is now generally available -- Added several dimensions to the aggregated transaction metrics {pull}7033[7033] - -[float] -==== Bug fixes -- Fix infinite loop in tail-based sampling subscriber causing high CPU and repeated {es} searches {pull}7211[7211] diff --git a/changelogs/8.10.asciidoc b/changelogs/8.10.asciidoc deleted file mode 100644 index f6da24ef814..00000000000 --- a/changelogs/8.10.asciidoc +++ /dev/null @@ -1,81 +0,0 @@ -[[apm-release-notes-8.10]] -== APM version 8.10 - -* <> -* <> -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.10.4]] -=== APM version 8.10.4 - -https://github.com/elastic/apm-server/compare/v8.10.3\...v8.10.4[View commits] - -[float] -==== Bug fixes - -- RPM package upgrade no longer overwrites the apm-server.yml config {pull}11808[11808] - -[float] -[[apm-release-notes-8.10.3]] -=== APM version 8.10.3 - -https://github.com/elastic/apm-server/compare/v8.10.2\...v8.10.3[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.10.2]] -=== APM version 8.10.2 - -https://github.com/elastic/apm-server/compare/v8.10.1\...v8.10.2[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.10.1]] -=== APM version 8.10.1 - -https://github.com/elastic/apm-server/compare/v8.10.0\...v8.10.1[View commits] - -[float] -==== Bug fixes -Fix tail-based sampling discarding low throughput and low sample rate traces {pull}11642[11642] - -[float] -[[apm-release-notes-8.10.0]] -=== APM version 8.10.0 - -https://github.com/elastic/apm-server/compare/v8.9.2\...v8.10.0[View commits] - -[float] -==== Breaking Changes -- Aggregated metrics now consider global labels to be part of a service's identity, and high cardinality global labels may cause services to be obscured {pull}11386[11386] -- Event protobuf encoding for tail-based sampling changed (to a more efficient encoding) for event timestamp and duration {pull}11386[11386] -- Use object notation for data_stream fields {pull}11311[11311] -- Removed `processor.event` and `processor.name` from the data model {pull}11028[11028] - -[float] -==== Bug fixes -- Add back handling of `queue.*` config for libbeat outputs, such as logstash and kafka {pull}11534[11534] -- Fix panic on missing `transaction.dropped_spans_stats.duration` field {pull}11117[11117] - -[float] -==== Intake API Changes -- `null` is no longer an acceptable value for `context.http.request.headers` and `context.http.response.headers` {pull}11386[11386] - -[float] -==== Added -- Add a self-instrumentation transaction to the source map periodic refresh action. {pull}11116[11116] -- Add a self-instrumentation transaction to the agent config periodic refresh action. {pull}11129[11129] -- Stop dropping metadata fields from span documents. {pull}11089[11089] -- Add permissions to reroute events in the integration package. {pull}11168[11168] - -[float] -==== Aggregation changes and improvements -- Replace aggregation with LSM-based aggregator which has a lower memory footprint {pull}11117[11117] -- Add `service.language.name` to service destination metrics {pull}11117[11117] -- Modify per-service transaction groups limit to consider more than service.name; Add per-service service destination groups limit and per-service service transaction groups limit {pull}11117[11117] -- All aggregations share the MaxServices limit {pull}11117[11117] diff --git a/changelogs/8.11.asciidoc b/changelogs/8.11.asciidoc deleted file mode 100644 index e7263cb388a..00000000000 --- a/changelogs/8.11.asciidoc +++ /dev/null @@ -1,65 +0,0 @@ -[[apm-release-notes-8.11]] -== APM version 8.11 - -* <> -* <> -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.11.4]] -=== APM version 8.11.4 - -https://github.com/elastic/apm-server/compare/v8.11.3\...v8.11.4[View commits] - -[float] -==== Bug fixes -- Fix source maps not being applied when an event contains both a span and an error {pull}12221[12221] - -[float] -[[apm-release-notes-8.11.3]] -=== APM version 8.11.3 - -https://github.com/elastic/apm-server/compare/v8.11.2\...v8.11.3[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.11.2]] -=== APM version 8.11.2 - -https://github.com/elastic/apm-server/compare/v8.11.1\...v8.11.2[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.11.1]] -=== APM version 8.11.1 - -https://github.com/elastic/apm-server/compare/v8.11.0\...v8.11.1[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.11.0]] -=== APM version 8.11.0 - -https://github.com/elastic/apm-server/compare/v8.10.4\...v8.11.0[View commits] - -[float] -==== Breaking Changes -- The `ecs.version` field has been removed from APM data streams {pull}11632[11632] - -[float] -==== Bug fixes -- Add back gzip support for grpc otlp endpoint {pull}11434[11434] -- Correctly mark jvm.memory.non_heap.pool.* and jvm.fd.* metrics as internal {pull}11303[11303] -- Fix tail-based sampling discarding low throughput and low sample rate traces {pull}11642[11642] -- Add memory based autoscaling for service destination aggregation groups {pull}11739[11739] - -[float] -==== Added -- Support and define DLM data retention period in the apmpackage {pull}11539[11539] -- Expose new metrics into the local batch processor {pull}11582[11582] -- Add geoip processing to app_logs ingest pipeline on `client.ip` {pull}11699[11699] diff --git a/changelogs/8.12.asciidoc b/changelogs/8.12.asciidoc deleted file mode 100644 index 6626701d5fa..00000000000 --- a/changelogs/8.12.asciidoc +++ /dev/null @@ -1,63 +0,0 @@ -[[apm-release-notes-8.12]] -== APM version 8.12 - -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.12.2]] -=== APM version 8.12.2 - -https://github.com/elastic/apm-server/compare/v8.12.1\...v8.12.2[View commits] - -[float] -==== Bug fixes -- Tail-based sampling: do not stop sampling processor when failing to delete trace events {pull}12509[12509] -- Define value for all constant_keyword fields in apmpackage to fix integration upgrade issues in rare cases {pull}12219[12219] - -[float] -[[apm-release-notes-8.12.1]] -=== APM version 8.12.1 - -https://github.com/elastic/apm-server/compare/v8.12.0\...v8.12.1[View commits] - -[float] -==== Bug fixes -- Tail-based sampling: Fix missing entry TTL in badger.ErrTxnTooBig handling {pull}12453[12453] -- Tail-based sampling: Compute entry size before writing and flush to avoid losing events silently due to storage limit {pull}12120[12120] -- APM instrumentation: Use UpDownCounter for docsActive and availableBulkIndexer {pull}12179[12179] -- Remove field preview in error reason returned by Elasticsearch from logs. https://discuss.elastic.co/t/apm-server-8-12-1-security-update-esa-2024-03/352688[Please see our security advisory for more details]. {pull}12179[12179] - -[float] -==== Added -- Disable default instrumentation metrics sending to batch processor by removing local exporter {pull}12228[12228] -- Log a single consolidated line per unique error instead of per each failed document {pull}12179[12179] - -[float] -[[apm-release-notes-8.12.0]] -=== APM version 8.12.0 - -https://github.com/elastic/apm-server/compare/v8.11.4\...v8.12.0[View commits] - -[float] -==== Breaking Changes -- The unsupported apm_data_stream_migration ingest pipeline has been removed {pull}12102[12102]. -- "publish_ready" is always false in the "GET /" response until events are received by apm-server {pull}12150[12150] -- Reverts a breaking change that ignored the beat name. This is visible in Stack Monitoring {pull}12176[12176] -- A bug has been introduced, so that `traces-apm@custom` ingest pipeline is now additionally applied to data streams `traces-apm.sampled-*` and `traces-apm.rum-*` and applied twice for `traces-apm-*`. See more details and information around a fix in the Known Issues section. - -[float] -==== Bug fixes -- Switch built-in ILM rollover policies from max_size to max_primary_shard_size {pull}11729[11729]. -- Handle empty request bodies gracefully {pull}12242[12242]. -- Wrap processor errors to provide more details {pull}12242[12242]. -- Require only one of exception.{type,message} for log exceptions {pull}12242[12242]. - -[float] -==== Added -- Update container base image to Ubuntu 22.04 {pull}11778[11778] -- Add support for returning partial success response in OTLP input {pull}11883[11883] -- Setting event timestamp from OTel observed timestamp when needed {pull}11935[11935] -- Field mappings have been added for various formerly unindexed fields {pull}12102[12102] -- We now assert that index templates are installed by attempting to create data streams {pull}12150[12150] diff --git a/changelogs/8.13.asciidoc b/changelogs/8.13.asciidoc deleted file mode 100644 index 00e3c38da6d..00000000000 --- a/changelogs/8.13.asciidoc +++ /dev/null @@ -1,56 +0,0 @@ -[[apm-release-notes-8.13]] -== APM version 8.13 - -* <> -* <> -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.13.4]] -=== APM version 8.13.4 - -https://github.com/elastic/apm-server/compare/v8.13.3\...v8.13.4[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.13.3]] -=== APM version 8.13.3 - -https://github.com/elastic/apm-server/compare/v8.13.2\...v8.13.3[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.13.2]] -=== APM version 8.13.2 - -https://github.com/elastic/apm-server/compare/v8.13.1\...v8.13.2[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.13.1]] -=== APM version 8.13.1 - -https://github.com/elastic/apm-server/compare/v8.13.0\...v8.13.1[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.13.0]] -=== APM version 8.13.0 - -https://github.com/elastic/apm-server/compare/v8.12.2\...v8.13.0[View commits] - -[float] -==== Added -- map OTel's `span.Status: Unset` to `event.outcome: success` instead of `event.outcome: unknown` {pull}12199[12199] -- Add support for Otel code.stacktrace {pull}12096[12096] -- `http.request.body.bytes` now reports the bytes read from request body even if Content-Length is -1 {pull}12451[12451] -- Use `messaging.system` and `messaging.operation` to detect OTel messaging span for transactions {pull}12506[12506] -- Add support for OTel data stream routing by parsing `data_stream.dataset` and `data_stream.namespace` from: (from lowest to highest precedence) resource attributes, instrumentation scope attributes, and signal-level attributes. This is a breaking change only for users relying on the existing `data_stream` attributes being stored as labels. {pull}12578[12578] -- Map OTel transaction `elastic.profiler_stack_trace_ids` attribute {pull}12493[12493] -- Reduce go-docappender error logging verbosity. Groups all errors by groups and reports a new "document" field {pull}12604[12604] diff --git a/changelogs/8.14.asciidoc b/changelogs/8.14.asciidoc deleted file mode 100644 index 80414471854..00000000000 --- a/changelogs/8.14.asciidoc +++ /dev/null @@ -1,51 +0,0 @@ -[[apm-release-notes-8.14]] -== APM version 8.14 - -* <> -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.14.3]] -=== APM version 8.14.3 - -https://github.com/elastic/apm-server/compare/v8.14.2\...v8.14.3[View commits] - -[float] -==== Bug fixes -- Fix a performance regression if `output.elasticsearch.flush_bytes` is not specified {pull}13576[13576] - -[float] -[[apm-release-notes-8.14.2]] -=== APM version 8.14.2 - -https://github.com/elastic/apm-server/compare/v8.14.1\...v8.14.2[View commits] - -[float] -==== Added -- Optimize memory usage and disk read IO for Tail Based Sampling {pull}13464[13464] - -[float] -[[apm-release-notes-8.14.1]] -=== APM version 8.14.1 - -https://github.com/elastic/apm-server/compare/v8.14.0\...v8.14.1[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.14.0]] -=== APM version 8.14.0 - -https://github.com/elastic/apm-server/compare/v8.13.2\...v8.14.0[View commits] - -[float] -==== Bug fixes -- Remove error reason from logs when Elasticsearch returns unavailable_shards_exception {pull}13287[13287] - -[float] -==== Added -- OpenTelemetry Distro Name will now be used for `agent.name` and `agent.version` {pull}12940[12940] -- Add support for setting the `host.id` via IntakeV2 {pull}12940[12940] -- Improved error message when tail sampling processor fails to read from subscriber position file {pull}12759[12759] diff --git a/changelogs/8.15.asciidoc b/changelogs/8.15.asciidoc deleted file mode 100644 index 029e3b57d79..00000000000 --- a/changelogs/8.15.asciidoc +++ /dev/null @@ -1,111 +0,0 @@ -[[apm-release-notes-8.15]] -== APM version 8.15 - -* <> -* <> -* <> -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.15.5]] -=== APM version 8.15.5 - -https://github.com/elastic/apm-server/compare/v8.15.4\...v8.15.5[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.15.4]] -=== APM version 8.15.4 - -https://github.com/elastic/apm-server/compare/v8.15.3\...v8.15.4[View commits] - -[float] -==== Bug fixes - -- Rollover for all APM data streams is now executing correctly in Elasticsearch 8.15.4, fixing a https://www.elastic.co/guide/en/observability/current/apm-known-issues.html#_upgrading_to_v8_15_x_may_cause_ingestion_to_fail[known issue] present in 8.15.0, 8.15.1, 8.15.2 and 8.15.3. - The fix is applied through https://github.com/elastic/elasticsearch/pull/116219[elasticsearch#116219]. - -[float] -[[apm-release-notes-8.15.3]] -=== APM version 8.15.3 - -https://github.com/elastic/apm-server/compare/v8.15.2\...v8.15.3[View commits] - -[float] -==== Bug fixes - -- Fix a panic in OTLP label setting when receiving on non-compliant attribute array values {pull}13950[13950] - -[float] -==== Added - -- Map OpenTelemetry instrumentation scope to `Service.Framework.*` for all signal types. {pull}13903[13903] - -[float] -[[apm-release-notes-8.15.2]] -=== APM version 8.15.2 - -https://github.com/elastic/apm-server/compare/v8.15.1\...v8.15.2[View commits] - -[float] -==== Bug fixes - -- Fix broken APM Agents configuration cache when there are more than 100 agent config entries {pull}13958[13958] - -[float] -[[apm-release-notes-8.15.1]] -=== APM version 8.15.1 - -https://github.com/elastic/apm-server/compare/v8.15.0\...v8.15.1[View commits] - -[float] -==== Bug fixes - -- Fix fallback memory limit check conversion from Bytes to Gigabytes {pull}13838[13838] -- Fix Elasticsearch apm-data plugin to fallback to ILM policy for data streams using default APM integration and not explicitly migrated to data stream lifecycle. More details are available in the https://www.elastic.co/guide/en/observability/current/apm-known-issues.html[APM known issues page] {pull}13918[13918] -- Remove from logs the error reason returned by Elasticsearch for `x_content_parse_exception` error {pull}13853[13853] -- Fix ingestion failure when `ip` resource attribute has value `0.0.0.0` in OpenTelemetry events from Jaeger {pull}13852[13852] -- Fix possible nil pointer dereference when parsing stacktraces in OpenTelemetry events {pull}13852[13852] -- Fix missing tracking in instrumentation metrics for certain request-level status codes from Elasticsearch bulk responses {pull}13853[13853] - -[float] -==== Added - -- Support OpenTelemetry Java agent inferred span links {pull}13852[13852] - -[float] -[[apm-release-notes-8.15.0]] -=== APM version 8.15.0 - -https://github.com/elastic/apm-server/compare/v8.14.3\...v8.15.0[View commits] - -[float] -==== Bug fixes - -- Avoid data race due to reuse of `bytes.Buffer` in ES bulk requests {pull}13155[13155] -- APM Server now relies on the Elasticsearch apm-data plugin's index templates, which reverts some unsafe uses of `flattened` field types {pull}12066[12066] -- Add `error.id` to jaeger errors {pull}13196[13196] -- Process `host.ip` resource attribute for OTel {pull}13614[13614] -- Fix a bug where indexed OpenTelemetry events and their aggregated metrics may contain incorrect label values from other events when the affected OpenTelemetry event has resource attribute values that are slices. This bug may also cause a panic with a message like "panic: runtime error: slice bounds out of range [-4:]" from apm-aggregation library. {pull}13822[13822] -- Fix unmapped or dropped APM Server monitoring metrics in APM Server self-monitoring, Stack monitoring, Metricbeat, and Elastic Agent integration {issue}13475[13475] - -[float] -==== Breaking Changes - -- Integration custom ingest pipelines `logs-apm.integration@custom`, `metrics-apm.integration@custom`, and `traces-apm.integration@custom` are no longer supported. Any existing pipelines above will need to be moved to the more fine-grained `\*-apm*@custom` ingest pipelines {pull}12066[12066] - -[float] -==== Added - -- Add `elasticsearch.flushed.uncompressed.bytes` metric {pull}13155[13155] -- APM Server now relies on the Elasticsearch apm-data plugin's index templates, removing the requirement to install the APM integration package {pull}12066[12066] -- Switch the default lifecycle management to leverage DSL instead of ILM, the change is executed as a part of Elasticsearch apm-data plugin migration {pull}12066[12066] -- Upgraded bundled APM Java agent attacher CLI to version 1.50.0 {pull}13326[13326] -- Enable Kibana curated UIs to work with hostmetrics from OpenTelemetry's https://pkg.go.dev/go.opentelemetry.io/collector/receiver/hostmetricsreceiver[hostmetricsreceiver] {pull}13196[13196] -- Add require data stream to bulk index requests {pull}13398[13398] -- Support self-instrumentation when in managed mode by getting tracing configs via reloader {pull}13514[13514] {pull}13653[13653] {pull}13691[13691] {pull}13790[13790] -- Add mapping for OpenTelemetry attribute `messaging.destination.name` to derive `service.target` correctly {pull}13472[13472] -- APM Server now automatically retries document-level 429s from Elasticsearch to avoid dropping data. `output.elasticsearch.max_retries` now controls both request-level and document-level retries, and defaults to `3`. {pull}13620[13620] \ No newline at end of file diff --git a/changelogs/8.16.asciidoc b/changelogs/8.16.asciidoc deleted file mode 100644 index 1fdfa79c4ad..00000000000 --- a/changelogs/8.16.asciidoc +++ /dev/null @@ -1,135 +0,0 @@ -[[apm-release-notes-8.16]] -== APM version 8.16 - -* <> -* <> -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.16.4]] -=== APM version 8.16.4 - -https://github.com/elastic/apm-server/compare/v8.16.3\...v8.16.4[View commits] - -[float] -==== Bug fixes - -- Fix unmapped or dropped APM Server tail sampling monitoring metrics in APM Server self-monitoring, Stack monitoring, Metricbeat, and Elastic Agent integration {issue}14247[14247] - -[float] -==== Breaking Changes - -[float] -==== Deprecations - -[float] -==== Intake API Changes - -[float] -==== Added - -[float] -[[apm-release-notes-8.16.3]] -=== APM version 8.16.3 - -https://github.com/elastic/apm-server/compare/v8.16.2\...v8.16.3[View commits] - -[float] -==== Bug fixes - -- Install APM Server in Program Files directory on Windows {pull}14905[14905] -- Fix self instrumentation events inconsistency when dealing with request timeout {pull}15123[15123] -- Drop and recreate tail-based sampling badger db after exceeding storage limit for configured TTL time {pull}15106[15106] - -[float] -==== Breaking Changes - -[float] -==== Deprecations - -[float] -==== Intake API Changes - -[float] -==== Added - -- Add sampling.tail.discard_on_write_failure config (default=false) to opt in to data loss when tail-based sampling storage limit is reached {pull}15159[15159] - -[float] -[[apm-release-notes-8.16.2]] -=== APM version 8.16.2 - -https://github.com/elastic/apm-server/compare/v8.16.1\...v8.16.2[View commits] - -[float] -==== Bug fixes - -- Surface config parsing error under EA managed mode by logging and marking EA input unit as failed {pull}14574[14574] -- Remove unnecessary hot reload under EA managed mode when apm tracing config is nil {pull}14865[14865] - -[float] -==== Breaking Changes - -[float] -==== Deprecations - -[float] -==== Intake API Changes - -[float] -==== Added - -- In this release we've introduced an image based on the hardened https://wolfi.dev/[Wolfi] image to provide additional security to our self-managed customers, and improve our supply chain security posture. - -[float] -[[apm-release-notes-8.16.1]] -=== APM version 8.16.1 - -https://github.com/elastic/apm-server/compare/v8.16.0\...v8.16.1[View commits] - -[float] -==== Bug fixes - -[float] -==== Breaking Changes - -[float] -==== Deprecations - -[float] -==== Intake API Changes - -[float] -==== Added - -[float] -[[apm-release-notes-8.16.0]] -=== APM version 8.16.0 - -https://github.com/elastic/apm-server/compare/v8.15.2\...v8.16.0[View commits] - -[float] -==== Bug fixes - -- Track all bulk request response status codes {pull}13574[13574] -- Fix a concurrent map write panic in monitoring middleware {pull}14335[14335] -- Apply shutdown timeout to http server {pull}14339[14339] -- Tail-based sampling: Fix rare gc thread failure after EA hot reload causing storage not reclaimed and stuck with "storage limit reached" {pull}14340[14340] - -[float] -==== Breaking Changes - -[float] -==== Deprecations -- Support for Jaeger is now deprecated, and will be removed in a future release {pull}13809[13809] - -[float] -==== Intake API Changes - -[float] -==== Added - -- APM Server will no longer retry an HTTP request that returned 502s, 503s, 504s. It will only retry 429s. {pull}13523[13523] -- APM Server now supports emitting distributed tracing for its own operation when running under Elastic Agent, and adds support for configuring a sampling rate {pull}14231[14231] diff --git a/changelogs/8.17.asciidoc b/changelogs/8.17.asciidoc deleted file mode 100644 index 0924e5be4f1..00000000000 --- a/changelogs/8.17.asciidoc +++ /dev/null @@ -1,88 +0,0 @@ -[[apm-release-notes-8.17]] -== APM version 8.17 - -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.17.2]] -=== APM version 8.17.2 - -https://github.com/elastic/apm-server/compare/v8.17.1\...v8.17.2[View commits] - -[float] -==== Bug fixes - -- Fix unmapped or dropped APM Server tail sampling monitoring metrics in APM Server self-monitoring, Stack monitoring, Metricbeat, and Elastic Agent integration {issue}14247[14247] - -[float] -==== Breaking Changes - -[float] -==== Deprecations - -[float] -==== Intake API Changes - -[float] -==== Added - -[float] -[[apm-release-notes-8.17.1]] -=== APM version 8.17.1 - -https://github.com/elastic/apm-server/compare/v8.17.0\...v8.17.1[View commits] - -[float] -==== Bug fixes - -- Install APM Server in Program Files directory on Windows {pull}14905[14905] -- Fix self instrumentation events inconsistency when dealing with request timeout {pull}15123[15123] -- Drop and recreate tail-based sampling badger db after exceeding storage limit for configured TTL time {pull}15106[15106] - -[float] -==== Breaking Changes - -[float] -==== Deprecations - -[float] -==== Intake API Changes - -[float] -==== Added - -- Add sampling.tail.discard_on_write_failure config (default=false) to opt in to data loss when tail-based sampling storage limit is reached {pull}15159[15159] - -[float] -[[apm-release-notes-8.17.0]] -=== APM version 8.17.0 - -https://github.com/elastic/apm-server/compare/v8.16.0\...v8.17.0[View commits] - -[float] -==== Bug fixes - -- Clear scroll after completing scroll requests {pull}14551[14551] -- Surface config parsing error under EA managed mode by logging and marking EA input unit as failed {pull}14574[14574] -- Remove unnecessary hot reload under EA managed mode when apm tracing config is nil {pull}14865[14865] -- The mappings are updated to disable date_detection for all APM data streams. - The change is applied through https://github.com/elastic/elasticsearch/pull/116995[elasticsearch#116995] - -[float] -==== Breaking Changes - -[float] -==== Deprecations - -[float] -==== Intake API Changes - -[float] -==== Added - -- The default data lifecycle management mechanism is getting reverted from Data Stream Lifecycle (DSL) to Index Lifecycle Management (ILM), as originally used prior to the introduction of the APM data plugin in release 8.15.0. - No action is required from users for this change. - However, any custom DSL settings will not be preserved during the migration. - The change is applied through https://github.com/elastic/elasticsearch/pull/115687[elasticsearch#115687] \ No newline at end of file diff --git a/changelogs/8.18.asciidoc b/changelogs/8.18.asciidoc deleted file mode 100644 index 95666599863..00000000000 --- a/changelogs/8.18.asciidoc +++ /dev/null @@ -1,26 +0,0 @@ -[[apm-release-notes-8.18]] -== APM version 8.18 -* <> - -[float] -[[apm-release-notes-8.18.0]] -=== APM version 8.18.0 - -https://github.com/elastic/apm-server/compare/v8.17.1\...v8.18.0[View commits] - -[float] -==== Bug fixes -- Fix overflow in validation of `apm-server.agent.config.cache.expiration` on 32-bit architectures {pull}15216[15216] -- Change permissions of `apm-server.yml` in `tar.gz` artifacts to `0600` {pull}15627[15627] - -[float] -==== Breaking Changes - -[float] -==== Deprecations - -[float] -==== Intake API Changes - -[float] -==== Added diff --git a/changelogs/8.2.asciidoc b/changelogs/8.2.asciidoc deleted file mode 100644 index 8880e090361..00000000000 --- a/changelogs/8.2.asciidoc +++ /dev/null @@ -1,73 +0,0 @@ -[[apm-release-notes-8.2]] -== APM version 8.2 - -* <> -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.2.3]] -=== APM version 8.2.3 - -https://github.com/elastic/apm-server/compare/v8.2.2\...v8.2.3[View commits] - -[float] -==== Bug fixes -- Added `tags` field mapping to `internal_metrics` data stream {pull}8292[8292] - -[float] -[[apm-release-notes-8.2.2]] -=== APM version 8.2.2 - -https://github.com/elastic/apm-server/compare/v8.2.1\...v8.2.2[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.2.1]] -=== APM version 8.2.1 - -https://github.com/elastic/apm-server/compare/v8.2.0\...v8.2.1[View commits] - -[float] -==== Bug fixes -- Fixes a bug that caused events within batches with `metadata.labels` set to contain labels from other events in the same batch {pull}8081[8081] - -[float] -[[apm-release-notes-8.2.0]] -=== APM version 8.2.0 - -https://github.com/elastic/apm-server/compare/v8.1.3\...v8.2.0[View commits] - -[float] -==== Breaking Changes -- APM Server now emits events with `event.duration` and renames the field to `.duration.us` in an ingest pipeline {pull}7261[7261] -- Removed `observer.version_major` {pull}7399[7399] -- APM Server no longer ships with System V init scripts or the go-daemon wrapper; use systemd {pull}7576[7576] - -[float] -==== Deprecations -- APM Server support for 32-bit architectures has been deprecated and will be removed in a future release {pull}7678[7678] - -[float] -==== Bug fixes -- Do not overwrite `service version` if no transaction/error/... specific `service.name` is given {pull}7281[7281] -- Set transaction name to `" unknown route"` for unknown HTTP routes in APM Server instrumentation {pull}7679[7679] - -[float] -==== Intake API Changes -- Support for `faas.name` and `faas.version` added to intake and transaction metrics {pull}7427[7427] -- If proxy headers are present: `source.ip` and `client.ip` set to header values, and `source.nat.ip` set to incoming request IP {pull}7444[7444] -- Updated intake v2 with support for `links` in `transaction` and `span` events {pull}7553[7553] -- If an agent sends a transaction or span with type unspecified, the server now sets a default value of "unknown" {pull}7688[7688] -- Content-Type and Content-Encoding are no longer required for intake {pull}7686[7686] - -[float] -==== Added -- Implemented translation of OpenTelemetry host system metrics (CPU utilization / Memory usage) {pull}7090[7090] -- Added support for storing OpenTelemetry span links as `span.links` {pull}7291[7291] -- seccomp is disabled by default {pull}7308[7308] -- Added data stream namespace configuration for standalone with `apm-server.data_streams.namespace` {pull}7314[7314] -- `apm-server` artifacts now have the apm java-attacher.jar packaged alongside them {pull}6593[6593] -- Run the java attacher jar when configured and not in a cloud environment {pull}6617[6617] diff --git a/changelogs/8.3.asciidoc b/changelogs/8.3.asciidoc deleted file mode 100644 index 2f07f3da27c..00000000000 --- a/changelogs/8.3.asciidoc +++ /dev/null @@ -1,72 +0,0 @@ -[[apm-release-notes-8.3]] -== APM version 8.3 - -* <> -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.3.3]] -=== APM version 8.3.3 - -https://github.com/elastic/apm-server/compare/v8.3.2\...v8.3.3[View commits] - -[float] -==== Bug fixes -- Update APM integration description {pull}8592[8592] - -[float] -[[apm-release-notes-8.3.2]] -=== APM version 8.3.2 - -https://github.com/elastic/apm-server/compare/v8.3.1\...v8.3.2[View commits] - -[float] -==== Bug fixes -- When tail-based sampling is enabled, limit the local disk space for the feature to 3GB {pull}8407[8407] - -[float] -[[apm-release-notes-8.3.1]] -=== APM version 8.3.1 - -https://github.com/elastic/apm-server/compare/v8.3.0\...v8.3.1[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.3.0]] -=== APM version 8.3.0 - -https://github.com/elastic/apm-server/compare/v8.2.2\...v8.3.0[View commits] - -[float] -==== Breaking Changes -- [experimental] Removed support for experimental firehose endpoint for CloudWatch metric streams {pull}8109[8109] - -[float] -==== Deprecations -- `span.context.destination.service.resource` is deprecated {pull}7925[7925] - -[float] -==== Bug fixes -- Propagate datastream namespace changes from apm-integration into server {pull}8176[8176] -- Correct the `libbeat.output.write.bytes` metric to count the written bytes after the compressed writer has been flushed {pull}8221[8221] -- Allow 100% tail-based sampling {pull}8233[8233] - -[float] -==== Intake API Changes -- For OpenTelemetry exception span events, stack traces that cannot be parsed will now be stored in `event.stack_trace` {pull}7706[7706] -- Support for ingesting `service.target.type` and `service.target.name` added to intake API for spans {pull}7870[7870] -- Derive `service.target.{type, name}` fields for older agents from `span.context.destination.service.resource` {pull}7925[7925] -- Support `service.target.*` in metrics aggregation {pull}7924[7924] - -[float] -==== Added -- System, process, and well-defined runtime metrics are now sent to the shared `metrics-apm.internal-` data stream {pull}7882[7882] -- Number of parallel bulk requests are now configurable via `output.elasticsearch.max_requests` {pull}8055[8055] -- OTLP/HTTP protocol is now supported {pull}8156[8156] - -[float] -==== Performance improvements -- Limit the number of gomaxprocs when CPU limits have been set within a cgroup, yielding significant performance improvements, particularly when the APM Server experiences high traffic from a high number of APM agents {pull}8175[8175] {pull}8278[8278] diff --git a/changelogs/8.4.asciidoc b/changelogs/8.4.asciidoc deleted file mode 100644 index 8cabcf81871..00000000000 --- a/changelogs/8.4.asciidoc +++ /dev/null @@ -1,66 +0,0 @@ -[[apm-release-notes-8.4]] -== APM version 8.4 - -* <> -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.4.3]] -=== APM version 8.4.3 - -https://github.com/elastic/apm-server/compare/v8.4.2\...v8.4.3[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.4.2]] -=== APM version 8.4.2 - -https://github.com/elastic/apm-server/compare/v8.4.1\...v8.4.2[View commits] - -[float] -==== Bug fixes -- The data stream migration ingest pipeline now handles `observer.version_major` and `process.ppid` translation {pull}9095[9095] - -[float] -[[apm-release-notes-8.4.1]] -=== APM version 8.4.1 - -https://github.com/elastic/apm-server/compare/v8.4.0\...v8.4.1[View commits] - -[float] -==== Bug fixes -- Fix event loss during reload of TBS processor {pull}8809[8809] -- Fix sporadically missing custom libbeat metrics {pull}8900[8900] - -[float] -[[apm-release-notes-8.4.0]] -=== APM version 8.4.0 - -https://github.com/elastic/apm-server/compare/v8.3.3\...v8.4.0[View commits] - -[float] -==== Breaking Changes -- APM Server no longer crashes on an invalid tail-based sampling config; it - continues running with TBS disabled {pull}8375[8375] - -// [float] -// ==== Deprecations - -[float] -==== Bug fixes -- Fix race for deducing destination service fields for OTel bridge {pull}8363[8363] -- Fix processors receiving events even after the server has stopped {pull}8388[8388] -- Fix a bug where an event's `transaction_id` is ignored if no transaction object is set {pull}8820[8820] - -// [float] -// ==== Intake API Changes - -[float] -==== Added -- Added support for `service.target.{type,name}` to be inferred from OpenTelemetry events {pull}8334[8334] -- Added support for OpenTelemetry summary metrics {pull}7772[7772] -- Upgraded bundled APM Java agent attacher CLI to version 1.32.0, which supports the `latest` version tag {pull}8374[8374] -- Added `span.name` to `service_destination` metrics {pull}8391[8391] diff --git a/changelogs/8.5.asciidoc b/changelogs/8.5.asciidoc deleted file mode 100644 index b23d6dac379..00000000000 --- a/changelogs/8.5.asciidoc +++ /dev/null @@ -1,93 +0,0 @@ -[[apm-release-notes-8.5]] -== APM version 8.5 - -* <> -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.5.3]] -=== APM version 8.5.3 - -https://github.com/elastic/apm-server/compare/v8.5.2\...v8.5.3[View commits] - -[float] -==== Bug fixes -- OpenTelemetry GRPC Spans from the Javascript API/SDK/Instrumentations are now correctly transformed into transactions with type=`request` {pull}9308[9308] - -[float] -[[apm-release-notes-8.5.2]] -=== APM version 8.5.2 - -This release includes an important APM Server bug fix. -Users running APM Server with Tail Sampling enabled in version >=8.3.0 and above should upgrade immediately. - -https://github.com/elastic/apm-server/compare/v8.5.1\...v8.5.2[View commits] - -[float] -==== Bug fixes -- Fix Tail Sampling OOM issues when storage limit is reached {pull}9583[9583] -- Null APM agent configuration entries are now treated as empty, and will not cause the server to exit with an error {pull}9546[9546] - -[float] -[[apm-release-notes-8.5.1]] -=== APM version 8.5.1 - -https://github.com/elastic/apm-server/compare/v8.5.0\...v8.5.1[View commits] - -[float] -==== Bug fixes -- Set `error.id` for OpenTelemetry exception span events {pull}9327[9327] -- Add an `apm-server` user to /etc/passwd in the Docker images {pull}9496[9496] - -[float] -[[apm-release-notes-8.5.0]] -=== APM version 8.5.0 - -https://github.com/elastic/apm-server/compare/v8.4.3\...v8.5.0[View commits] - -[float] -==== Known issue -Due to a recent change in the Red Hat scan verification process, -this version of APM Server is not available in the Red Hat Ecosystem Catalog. -This bug will be fixed in the next release. -Please use the https://www.docker.elastic.co/r/apm[Elastic docker registry] to download the 8.5.0 APM Server image. - -[float] -==== Breaking Changes -- `event.action` is no longer recorded for OTLP logs, due to breaking OTLP changes {pull}8765[8765] -- Experimental support for ingesting profile data has been removed {pull}8911[8911] -- `process.ppid` has been renamed to `process.parent.pid` for alignment with ECS {pull}8783[8783] - -[float] -==== Deprecations - -[float] -==== Bug fixes -- Set `message` instead of `labels.event` for Jaeger span events {pull}8765[8765] -- Reach full support (still technical preview) for Java agent auto attachment on Linux by allowing attachment to a JVM of any user {pull}8803[8803] -- The OTLP/HTTP handlers now support gzip and deflate compression {pull}9067[9067] -- The Fleet integration now applies source maps correctly when they have been uploaded with a relative bundle_filepath {pull}9082[9082] -- Dynamically map all simple numerical metrics as `double`, to avoid mapping conflicts {pull}8868[8868] -- Fix data stream migration ingest pipeline, upgrading old `observer.*` and `process.ppid` fields {pull}9095[9095] -- Fix ordering of processors to ensure `host.hostname` is set consistently in aggregated metrics {pull}8983[8983] - -[float] -==== Intake API Changes -- Add a new `async` boolean query parameter (`intake/v2/events?async=`). - When set to `true`, the batch will be processed asynchronously if the APM Server can - service the incoming request immediately, otherwise a "503 queue is full" error will - be returned {pull}8979[8979] -- experimental:[] Add logs support to v2 intake API {pull}9068[9068] - -[float] -==== Added -- Set a default User-Agent field value when making HTTP requests {pull}8758[8758] -- OTLP support updated to opentelemetry-collector v0.56.0 {pull}8765[8765] -- Map additional fields from mobile agents {pull}8784[8784] -- Include global labels to the transaction metric dimensions {pull}8839[8839] -- Add an experimental integration of the Profiling collection agent gRPC service {pull}9005[9005] -- Clarify tail-based sampling storage limit reached errors {pull}9085[9085] -- Added support for new OTel JVM metric names, as changed in OTel Java SDK v1.13.0 {pull}8777[8777] -- experimental:[] Added technical preview of aggregated service metrics {pull}8607[8607] diff --git a/changelogs/8.6.asciidoc b/changelogs/8.6.asciidoc deleted file mode 100644 index 14c8f665a11..00000000000 --- a/changelogs/8.6.asciidoc +++ /dev/null @@ -1,64 +0,0 @@ -[[apm-release-notes-8.6]] -== APM version 8.6 - -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.6.2]] -=== APM version 8.6.2 - -https://github.com/elastic/apm-server/compare/v8.6.1\...v8.6.2[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.6.1]] -=== APM version 8.6.1 - -https://github.com/elastic/apm-server/compare/v8.6.0\...v8.6.1[View commits] - -[float] -==== Bug fixes -- Fix panic when memory limits are missing in cgroupV1 {pull}10098[10098] -- Fix internal traffic filter handling on Elastic Cloud when managed by Elastic Agent (Integrations Server) - -[float] -[[apm-release-notes-8.6.0]] -=== APM version 8.6.0 - -https://github.com/elastic/apm-server/compare/v8.5.3\...v8.6.0[View commits] - -[float] -==== Breaking Changes -- `apm-server.decoder.*` stack monitoring metrics are no longer recorded {pull}9210[9210] -- `ecs.version` is no longer added to document `_source`; it is added as a `constant_keyword` field {pull}9208[9208] -- `context.http.response.*_size` fields now enforce integer values {pull}9429[9429] -- `observer.id` and `observer.ephemeral_id` are no longer added to APM documents {pull}9412[9412] -- `timeseries.instance` has been removed from transaction metrics docs; it was never used {pull}9565[9565] - -[float] -==== Deprecations -- `apm-server apikey` commands have been deprecated. API Keys should be managed through Kibana or the Elasticsearch REST API {pull}9446[9446] - -[float] -==== Bug fixes -- Change ownership of apm-server.yml and data/ to apm-server user in Docker image {pull}9604[9604] - -[float] -==== Intake API Changes -- experimental:[] Extend logs v2 intake API to support ECS logging fields {pull}9349[9349] -- experimental:[] Add support for string timestamp format(`2006-01-02T15:04:05.999-0700`) {pull}9376[9376] -- `context.http.response.*_size` fields have been changed from floating-point to integer types {pull}9429[9429] - -[float] -==== Added -- Service metrics now support global labels {pull}9248[9248] -- OpenTelemetry GRPC Spans from the Javascript API/SDK/Instrumentations are now correctly transformed into transactions with type=`request` {pull}9308[9308] -- Improve Elasticsearch output performance, particularly when compression is enabled (default) {pull}9318[9318] -- Java attacher support for macOS {pull}9413[9413] -- Improve Elasticsearch output performance in instances with more than 6 cores {pull}9393[9393] -- Tune internal server configuration based on available cgroup or machine RAM, improving resource utilization and performance {pull}9358[9358] -- Disallow auto-scaling of active indexers when Elasticsearch 429 response rate exceeds 1% of total requests issued {pull}9463[9463] -- We now record `transaction.representative_count` and `span.representative_count` -- the inverse sample rate {pull}9458[9458] diff --git a/changelogs/8.7.asciidoc b/changelogs/8.7.asciidoc deleted file mode 100644 index 90f765d5ef7..00000000000 --- a/changelogs/8.7.asciidoc +++ /dev/null @@ -1,103 +0,0 @@ -[[apm-release-notes-8.7]] -== APM version 8.7 - -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.7.2]] -=== APM version 8.7.2 - -https://github.com/elastic/apm-server/compare/v8.7.1\...v8.7.2[View commits] - -[float] -==== Bug fixes - -[float] -[[apm-release-notes-8.7.1]] -=== APM version 8.7.1 - -https://github.com/elastic/apm-server/compare/v8.7.0\...v8.7.1[View commits] - -[float] -==== Bug fixes -- Fix indexing failures for metric, error and log documents when `agent.activation_method` is set {pull}10552[10552] -- Use droppedspan outcome in service destination aggregation {pull}10592[10592] -- metrics: Count context.DeadlineExceeded as timeout {pull}10594[10594] -- metrics: Count GRPC codes.Canceled as timeout {pull}10605[10605] -- Remove global labels from aggregations for RUM services {pull}10624[10624] -- Remove redundant aggregation groups on `faas.coldstart` in transaction metrics {pull}10635[10635] - -[float] -[[apm-release-notes-8.7.0]] -=== APM version 8.7.0 - -https://github.com/elastic/apm-server/compare/v8.6.2\...v8.7.0[View commits] - -[float] -==== Breaking Changes -- `transaction.failure_count` has been removed. `transaction.success_count` type has changed to `aggregated_metric_double` {pull}9791[9791] -- `transaction.success_count` has been moved to `event.success_count` {pull}9819[9819] -- Stop indexing transaction metrics to `metrics-apm.internal` {pull}9846[9846] -- Stop indexing span destination metrics to `metrics-apm.internal` {pull}9926[9926] -- `apmserver.aggregation.txmetrics.overflowed` metric has been renamed to `apmserver.aggregation.txmetrics.overflowed.total` {pull}10330[10330] -- Elasticsearch sourcemapping credentials require access to the `.apm-source-map` index {pull}9722[9722] -- Change APM Server default host to 127.0.0.1 {pull}9877[9877] - -[float] -==== Bug fixes -- We no longer unconditionally block shutdown for 5 seconds when tail-based sampling is enabled {pull}9838[9838] -- Fix a panic caused by accepting new grpc connections during shutdown {pull}10013[10013] -- Fix goroutine leak in libbeat final processor {pull}10247[10247] -- Fix servicemetrics aggregator name typo {pull}10022[10022] - -[float] -==== Intake API Changes -- Add `request.id` to `span.context.http` {pull}9673[9673] -- Add `agent.activation_method` metadata field {pull}9850[9850] - -[float] -==== Added -- Metrics data streams now use synthetic source {pull}9756[9756] -- Translate otel log events to error events {pull}10066[10066] {pull}10128[10128] -- Use Elasticsearch fetcher for agent remote configuration where possible {pull}9720[9720] {pull}10088[10088] {pull}10115[10115] -- Fetch sourcemaps from Elasticsearch {pull}9722[9722] {pull}10367[10367] {pull}10360[10360] {pull}10106[10106] -- Add support for RHEL 9 {pull}10317[10317] - -[float] -==== Transaction metric improvements -- Add `event.success_count` to transaction metrics {pull}9819[9819] {pull}10165[10165] -- Add `transaction.duration.summary` to transaction metrics {pull}9973[9973] {pull}10214[10214] -- Introduce overflow buckets to limit cardinality and scale the max groups based on available memory {pull}9856[9856] {pull}10157[10157] {pull}10362[10362] {pull}9911[9911] {pull}10012[10012] {pull}10190[10190] -- Add overflow metrics collection {pull}10330[10330] -- Improve APM UI query performance by producing `1m`, `10m` and `60m` aggregation intervals for transaction metrics. Store them into hidden data streams `metrics-apm.transaction.${interval}` {pull}9846[9846] {pull}10070[10070] -- Reduce memory footprint of transaction aggregations {pull}10178[10178] - -[float] -==== Service transaction metric improvements -- Introduce overflow buckets to limit cardinality and scale the max groups based on available memory {pull}9856[9856] {pull}10157[10157] {pull}9911[9911] {pull}10012[10012] -- Add overflow metrics collection {pull}10330[10330] -- Rename service metrics to service transaction metrics {pull}10095[10095] {pull}10110[10110] -- Improve APM UI query performance by producing `1m`, `10m` and `60m` aggregation intervals for service metrics. Store them into hidden data streams `metrics-apm.service.${interval}` {pull}9960[9960] {pull}10070[10070] -- Add `service.language.name` {pull}10111[10111] -- Add histogram support {pull}9864[9864] {pull}10214[10214] {pull}10127[10127] {pull}10216[10216] -- Always enable metrics aggregaton and remove config option {pull}10060[10060] {pull}10109[10109] -- Reduce memory footprint of service transaction aggregations {pull}10178[10178] - -[float] -==== Service destination metric improvements -- Introduce overflow buckets to limit cardinality {pull}10069[10069] -- Add overflow metrics collection {pull}10330[10330] -- Set `_doc_count` for service destination metrics {pull}9931[9931] -- Add global labels to service destination metrics {pull}10056[10056] {pull}10297[10297] -- Improve APM UI query performance by producing `1m`, `10m` and `60m` aggregation intervals for service destination metrics. Store them into data streams `metrics-apm.service_destination.${interval}` and make them hidden for non-default intervals {pull}9926[9926] {pull}10070[10070] - -[float] -==== Introducing Service summary metric improvements -- Introduce service summary metrics {pull}10111[10111] -- Introduce overflow buckets to limit cardinality {pull}10061[10061] {pull}10302[10302] -- Add overflow metrics collection {pull}10330[10330] -- Improve APM UI query performance by adding an always enabled service summary metrics aggregator which produces `1m`, `10m` and `60m` aggregation intervals. Store them into data streams `metrics-apm.service_summary.${interval}` and make them hidden for -non-default intervals {pull}10029[10029] {pull}10060[10060] {pull}10070[10070] -- Add `service.language.name` {pull}10111[10111] diff --git a/changelogs/8.8.asciidoc b/changelogs/8.8.asciidoc deleted file mode 100644 index 717c8dda039..00000000000 --- a/changelogs/8.8.asciidoc +++ /dev/null @@ -1,49 +0,0 @@ -[[apm-release-notes-8.8]] -== APM version 8.8 - -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.8.2]] -=== APM Server version 8.8.2 - -https://github.com/elastic/apm-server/compare/v8.8.1\...v8.8.2[View commits] - -[float] -==== Bug fixes -- Added CA certificates bundle to the Docker images {pull}11015[11015] - -[float] -[[apm-release-notes-8.8.1]] -=== APM version 8.8.1 - -https://github.com/elastic/apm-server/compare/v8.8.0\...v8.8.1[View commits] - -[float] -==== Bug fixes -- Fix indexing failures for 10m and 60m aggregation rollup data streams after upgrading from 8.7.x to 8.8.0. See Fleet changelog for details. - -[float] -[[apm-release-notes-8.8.0]] -=== APM version 8.8.0 - -https://github.com/elastic/apm-server/compare/v8.7.2\...v8.8.0[View commits] - -[float] -==== Breaking Changes -- Store app logs into service-specific data streams {pull}10456[10456] - -[float] -==== Deprecations - -[float] -==== Bug fixes -- Fix ILM policy name mismatch in rollup interval index templates {pull}10824[10824] - -[float] -==== Intake API Changes - -[float] -==== Added diff --git a/changelogs/8.9.asciidoc b/changelogs/8.9.asciidoc deleted file mode 100644 index abc2a27df54..00000000000 --- a/changelogs/8.9.asciidoc +++ /dev/null @@ -1,51 +0,0 @@ -[[apm-release-notes-8.9]] -== APM version 8.9 - -* <> -* <> -* <> - -[float] -[[apm-release-notes-8.9.2]] -=== APM version 8.9.2 - -https://github.com/elastic/apm-server/compare/v8.9.1\...v8.9.2[View commits] - -[float] -==== Bug fixes -- Add back handling of `queue.*` config for libbeat outputs, such as logstash and kafka {pull}11534[11534] - -[float] -[[apm-release-notes-8.9.1]] -=== APM version 8.9.1 - -https://github.com/elastic/apm-server/compare/v8.9.0\...v8.9.1[View commits] - -No significant changes. - -[float] -[[apm-release-notes-8.9.0]] -=== APM version 8.9.0 - -https://github.com/elastic/apm-server/compare/v8.8.2\...v8.9.0[View commits] - -[float] -==== Bug fixes -- Limit the amount of concurrent OTLP requests being processed in parallel {pull}10987[10987]. -- Added CA certificates bundle to the Docker images {pull}11015[11015] -- Derivation of transaction and span type from OTLP spans is now deterministic {pull}11036[11036] -- Populate `span.id` and `transaction.id` for logs derived from OTLP spans {pull}11038[11038] - -[float] -==== Intake API Changes -- Span events now default to having a representative count of 1, if no `sample_rate` field is sent by the agent {pull}10792[10792] - -[float] -==== Added -- Span events now carry `host` and `service.version` attributes. {pull}10697[10697] -- Accept more options in agentcfg ES config; Reliably use `agent.config.elasticsearch` and `rum.source_mapping.elasticsearch` credentials when merging with `output.elasticsearch` credentials {pull}10783[10783] -- Emit service destination metrics when only `service.target.*` fields are set. {pull}10922[10922] -- apmpackage: Remove `timeseries.instance` in ingest pipeline for pre-8.6 compatibility {pull}10973[10973] -- apmpackage: Use "dynamic: runtime" instead of strict mapping for internal, TBS, and aggregation indices {pull}10968[10968] -- Corrected as of 5 July 2023 to align with the correct license text for Elastic License 2.0 {pull}11120[11120] -- Tail-based sampling: Migrate to protobuf codec for storage efficiency and performance {pull}10994[10994] diff --git a/changelogs/9.0.asciidoc b/changelogs/9.0.asciidoc deleted file mode 100644 index d890048ab25..00000000000 --- a/changelogs/9.0.asciidoc +++ /dev/null @@ -1,28 +0,0 @@ -[[apm-release-notes-9.0]] -== APM version 9.0 -* <> - -[float] -[[apm-release-notes-9.0.0]] -=== APM version 9.0.0 - -https://github.com/elastic/apm-server/compare/v\...v9.0.0[View commits] - -[float] -==== Bug fixes -- Fix overflow in validation of `apm-server.agent.config.cache.expiration` on 32-bit architectures {pull}15216[15216] -- Change permissions of `apm-server.yml` in `tar.gz` artifacts to `0600` {pull}15627[15627] - -[float] -==== Breaking Changes -- Change `sampling.tail.storage_limit` default to `0`. While `0` means unlimited local tail-sampling database size, it now enforces a max 80% disk usage on the disk where the data directory is located. Any tail sampling writes after this threshold will be rejected, similar to what happens when tail-sampling database size exceeds a non-0 storage limit. Setting `sampling.tail.storage_limit` to non-0 maintains the existing behavior which limits the tail-sampling database size to `sampling.tail.storage_limit` and does not have the new disk usage threshold check. {pull}15467[15467] {pull}15524[15524] - -[float] -==== Deprecations - -[float] -==== Intake API Changes - -[float] -==== Added -- Tail-based sampling: Storage layer is rewritten to use Pebble database instead of BadgerDB. The new implementation offers a substantial throughput increase while consuming significantly less memory. Disk usage is lower and more stable. See PR for benchmark details. {pull}15235[15235] diff --git a/changelogs/all-breaking-changes.asciidoc b/changelogs/all-breaking-changes.asciidoc deleted file mode 100644 index dbbce5cbc46..00000000000 --- a/changelogs/all-breaking-changes.asciidoc +++ /dev/null @@ -1,308 +0,0 @@ -: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. - -// tag::90-bc[] -[float] -[[breaking-changes-9.0]] -=== 9.0 - -The following breaking changes are introduced in APM version 9.0.0: - -- Change `sampling.tail.storage_limit` default to `0`. -While `0` means unlimited local tail-sampling database size, -it now enforces a max 80% disk usage on the disk where the data directory is located. -Any tail sampling writes after this threshold will be rejected, -similar to what happens when tail-sampling database size exceeds a non-0 storage limit. -Setting `sampling.tail.storage_limit` to non-0 maintains the existing behavior -which limits the tail-sampling database size to `sampling.tail.storage_limit` -and does not have the new disk usage threshold check. -For more details, see https://github.com/elastic/apm-server/pull/15467[PR #15467] and -https://github.com/elastic/apm-server/pull/15524[PR #15524] -// end::90-bc[] - -// tag::811-bc[] -[float] -[[breaking-changes-8.11]] -=== 8.11 - -The following breaking changes are introduced in APM version 8.11.0: - -- The `ecs.version` field has been removed from APM data streams. -This change should not impact most users as this field is not used by the APM UI. -For more details, see https://github.com/elastic/apm-server/pull/11632[PR #11632] -// end::811-bc[] - -// tag::810-bc[] -[float] -[[breaking-changes-8.10]] -=== 8.10 - -The following breaking changes are introduced in APM version 8.10.0: - -- Aggregated metrics now consider global labels to be part of a service's identity, and high cardinality global labels may cause services to be obscured. -For more details, see https://github.com/elastic/apm-server/pull/11386[PR #11386]. - -- Event protobuf encoding for tail-based sampling changed to a more efficient encoding for event timestamp and duration -For more details, see https://github.com/elastic/apm-server/pull/11386[PR #11386]. -// end::810-bc[] - -// tag::87-bc[] -[float] -[[breaking-changes-8.7]] -=== 8.7 - -The following breaking changes and deprecations are introduced in APM version 8.7.0: - -- `transaction.failure_count` has been removed. `transaction.success_count` type has changed to `aggregated_metric_double`. -For more details, see https://github.com/elastic/apm-server/pull/9791[PR #9791]. - -- `transaction.success_count` has been moved to `event.success_count`. -For more details, see https://github.com/elastic/apm-server/pull/9819[PR #9819]. - -- Stopped indexing transaction metrics to `metrics-apm.internal`. -For more details, see https://github.com/elastic/apm-server/pull/9846[PR #9846]. - -- Stopped indexing span destination metrics to `metrics-apm.internal`. -For more details, see https://github.com/elastic/apm-server/pull/9926[PR #9926]. - -- `apmserver.aggregation.txmetrics.overflowed` metric has been renamed to `apmserver.aggregation.txmetrics.overflowed.total`. -For more details, see https://github.com/elastic/apm-server/pull/10330[PR #10330]. - -- Elasticsearch source mapping credentials now require access to the `.apm-source-map` index. -For more details, see https://github.com/elastic/apm-server/pull/9722[PR #9722]. - -- Changed APM Server default host to `127.0.0.1`. -For more details, see https://github.com/elastic/apm-server/pull/9877[PR #9877]. -// end::87-bc[] - -// tag::86-bc[] -[float] -[[breaking-changes-8.6]] -=== 8.6 - -The following breaking changes and deprecations are introduced in APM version 8.6.0: - -[float] -==== `apm-server.decoder.*` no longer recorded -The stack monitoring metrics, `apm-server.decoder.*`, are no longer recorded. -These metrics were not used by stack monitoring, so there should be no noticeable change. - -For more details, see https://github.com/elastic/apm-server/pull/9210[PR #9210]. - -[float] -==== `context.http.response.*_size` fields now enforce integer values -New field mappings enforce integer values for `context.http.response.*_size`. -The fields are mapped with `index: false` to minimize storage overhead. - -For more details, see https://github.com/elastic/apm-server/pull/9429[PR #9429]. - -[float] -==== `observer.id` and `observer.ephemeral_id` removed - -`observer.id` and `observer.ephemeral_id` are no longer added to APM documents. -The APM UI does not currently rely on these field, so there should be no noticeable change. - -For more details, see https://github.com/elastic/apm-server/pull/9412[PR #9412]. - -[float] -==== `timeseries.instance` removed -`timeseries.instance` has been removed from transaction metrics docs. -The APM UI did not use this field, so there should be no noticeable change. - -For more details, see https://github.com/elastic/apm-server/pull/9565[PR #9565]. - -// end::86-bc[] - -[float] -[[breaking-changes-8.2]] -=== 8.2 - -// tag::82-bc[] -The following breaking changes are introduced in APM version 8.2.0: - -[float] -==== APM Server now emits events with `event.duration` - -APM Server no longer emits events with a `transaction.duration.us` or `span.duration.us`. -Instead, events are emitted with an `event.duration`. -An ingest pipeline sets the legacy `.duration.us` field and removes the `event.duration`. - -This change will impact users who are not using APM Server's {es} output or the packaged ingest pipeline. -For details, see https://github.com/elastic/apm-server/pull/7261[PR #7261]. - -[float] -==== Removed `observer.version_major` - -The field `observer.version_major` is non-standard and existed only for the APM UI to filter out legacy docs (versions <7.0). -This check is no longer performed, so the field has been removed. - -For details, see https://github.com/elastic/apm-server/pull/7399[PR #7399]. - -[float] -==== APM Server no longer ships with System V init scripts or the go-daemon wrapper - -As of version 8.1.0, all Linux distributions supported by APM Server support systemd. -As a result, APM Server no longer ships with System V init scripts or the go-daemon wrapper; use systemd instead. - -For details, see https://github.com/elastic/apm-server/pull/7576[PR #7576]. - -[float] -==== Deprecated 32-bit architectures - -APM Server support for 32-bit architectures has been deprecated and will be removed in a future release. -// end::82-bc[] - -[float] -[[breaking-changes-8.1]] -=== 8.1 - -// tag::81-bc[] -There are no breaking changes in APM. -// end::81-bc[] - -[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[] diff --git a/changelogs/head.asciidoc b/changelogs/head.asciidoc deleted file mode 100644 index f87f8ea69f9..00000000000 --- a/changelogs/head.asciidoc +++ /dev/null @@ -1,21 +0,0 @@ -[[release-notes-head]] -== APM version HEAD - -https://github.com/elastic/apm-server/compare/9.0\...main[View commits] - -[float] -==== Breaking Changes -- Elasticsearch `apm_user` role has been removed. After this change if you are relying on `apm_user` you will need to specify its permissions manually. -For more details, see https://github.com/elastic/apm-server/pull/14876[PR #14876] - -[float] -==== Bug fixes - -[float] -==== Deprecations - -[float] -==== Intake API Changes - -[float] -==== Added diff --git a/docs/docset.yml b/docs/docset.yml new file mode 100644 index 00000000000..d92ebf9c801 --- /dev/null +++ b/docs/docset.yml @@ -0,0 +1,487 @@ +project: 'APM Server documentation' +exclude: + - README.md +cross_links: + - docs-content +toc: + - toc: release-notes +subs: + ref: "https://www.elastic.co/guide/en/elasticsearch/reference/current" + ref-bare: "https://www.elastic.co/guide/en/elasticsearch/reference" + ref-8x: "https://www.elastic.co/guide/en/elasticsearch/reference/8.1" + ref-80: "https://www.elastic.co/guide/en/elasticsearch/reference/8.0" + ref-7x: "https://www.elastic.co/guide/en/elasticsearch/reference/7.17" + ref-70: "https://www.elastic.co/guide/en/elasticsearch/reference/7.0" + ref-60: "https://www.elastic.co/guide/en/elasticsearch/reference/6.0" + ref-64: "https://www.elastic.co/guide/en/elasticsearch/reference/6.4" + xpack-ref: "https://www.elastic.co/guide/en/x-pack/6.2" + logstash-ref: "https://www.elastic.co/guide/en/logstash/current" + kibana-ref: "https://www.elastic.co/guide/en/kibana/current" + kibana-ref-all: "https://www.elastic.co/guide/en/kibana" + beats-ref-root: "https://www.elastic.co/guide/en/beats" + beats-ref: "https://www.elastic.co/guide/en/beats/libbeat/current" + beats-ref-60: "https://www.elastic.co/guide/en/beats/libbeat/6.0" + beats-ref-63: "https://www.elastic.co/guide/en/beats/libbeat/6.3" + beats-devguide: "https://www.elastic.co/guide/en/beats/devguide/current" + auditbeat-ref: "https://www.elastic.co/guide/en/beats/auditbeat/current" + packetbeat-ref: "https://www.elastic.co/guide/en/beats/packetbeat/current" + metricbeat-ref: "https://www.elastic.co/guide/en/beats/metricbeat/current" + filebeat-ref: "https://www.elastic.co/guide/en/beats/filebeat/current" + functionbeat-ref: "https://www.elastic.co/guide/en/beats/functionbeat/current" + winlogbeat-ref: "https://www.elastic.co/guide/en/beats/winlogbeat/current" + heartbeat-ref: "https://www.elastic.co/guide/en/beats/heartbeat/current" + journalbeat-ref: "https://www.elastic.co/guide/en/beats/journalbeat/current" + ingest-guide: "https://www.elastic.co/guide/en/ingest/current" + fleet-guide: "https://www.elastic.co/guide/en/fleet/current" + apm-guide-ref: "https://www.elastic.co/guide/en/apm/guide/current" + apm-guide-7x: "https://www.elastic.co/guide/en/apm/guide/7.17" + apm-app-ref: "https://www.elastic.co/guide/en/kibana/current" + apm-agents-ref: "https://www.elastic.co/guide/en/apm/agent" + apm-android-ref: "https://www.elastic.co/guide/en/apm/agent/android/current" + apm-py-ref: "https://www.elastic.co/guide/en/apm/agent/python/current" + apm-py-ref-3x: "https://www.elastic.co/guide/en/apm/agent/python/3.x" + apm-node-ref-index: "https://www.elastic.co/guide/en/apm/agent/nodejs" + apm-node-ref: "https://www.elastic.co/guide/en/apm/agent/nodejs/current" + apm-node-ref-1x: "https://www.elastic.co/guide/en/apm/agent/nodejs/1.x" + apm-rum-ref: "https://www.elastic.co/guide/en/apm/agent/rum-js/current" + apm-ruby-ref: "https://www.elastic.co/guide/en/apm/agent/ruby/current" + apm-java-ref: "https://www.elastic.co/guide/en/apm/agent/java/current" + apm-go-ref: "https://www.elastic.co/guide/en/apm/agent/go/current" + apm-dotnet-ref: "https://www.elastic.co/guide/en/apm/agent/dotnet/current" + apm-php-ref: "https://www.elastic.co/guide/en/apm/agent/php/current" + apm-ios-ref: "https://www.elastic.co/guide/en/apm/agent/swift/current" + apm-lambda-ref: "https://www.elastic.co/guide/en/apm/lambda/current" + apm-attacher-ref: "https://www.elastic.co/guide/en/apm/attacher/current" + docker-logging-ref: "https://www.elastic.co/guide/en/beats/loggingplugin/current" + esf-ref: "https://www.elastic.co/guide/en/esf/current" + kinesis-firehose-ref: "https://www.elastic.co/guide/en/kinesis/{{kinesis_version}}" + estc-welcome-current: "https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current" + estc-welcome: "https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current" + estc-welcome-all: "https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions" + hadoop-ref: "https://www.elastic.co/guide/en/elasticsearch/hadoop/current" + stack-ref: "https://www.elastic.co/guide/en/elastic-stack/current" + stack-ref-67: "https://www.elastic.co/guide/en/elastic-stack/6.7" + stack-ref-68: "https://www.elastic.co/guide/en/elastic-stack/6.8" + stack-ref-70: "https://www.elastic.co/guide/en/elastic-stack/7.0" + stack-ref-80: "https://www.elastic.co/guide/en/elastic-stack/8.0" + stack-ov: "https://www.elastic.co/guide/en/elastic-stack-overview/current" + stack-gs: "https://www.elastic.co/guide/en/elastic-stack-get-started/current" + stack-gs-current: "https://www.elastic.co/guide/en/elastic-stack-get-started/current" + javaclient: "https://www.elastic.co/guide/en/elasticsearch/client/java-api/current" + java-api-client: "https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current" + java-rest: "https://www.elastic.co/guide/en/elasticsearch/client/java-rest/current" + jsclient: "https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current" + jsclient-current: "https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current" + es-ruby-client: "https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current" + es-dotnet-client: "https://www.elastic.co/guide/en/elasticsearch/client/net-api/current" + es-php-client: "https://www.elastic.co/guide/en/elasticsearch/client/php-api/current" + es-python-client: "https://www.elastic.co/guide/en/elasticsearch/client/python-api/current" + defguide: "https://www.elastic.co/guide/en/elasticsearch/guide/2.x" + painless: "https://www.elastic.co/guide/en/elasticsearch/painless/current" + plugins: "https://www.elastic.co/guide/en/elasticsearch/plugins/current" + plugins-8x: "https://www.elastic.co/guide/en/elasticsearch/plugins/8.1" + plugins-7x: "https://www.elastic.co/guide/en/elasticsearch/plugins/7.17" + plugins-6x: "https://www.elastic.co/guide/en/elasticsearch/plugins/6.8" + glossary: "https://www.elastic.co/guide/en/elastic-stack-glossary/current" + upgrade_guide: "https://www.elastic.co/products/upgrade_guide" + blog-ref: "https://www.elastic.co/blog/" + curator-ref: "https://www.elastic.co/guide/en/elasticsearch/client/curator/current" + curator-ref-current: "https://www.elastic.co/guide/en/elasticsearch/client/curator/current" + metrics-ref: "https://www.elastic.co/guide/en/metrics/current" + metrics-guide: "https://www.elastic.co/guide/en/metrics/guide/current" + logs-ref: "https://www.elastic.co/guide/en/logs/current" + logs-guide: "https://www.elastic.co/guide/en/logs/guide/current" + uptime-guide: "https://www.elastic.co/guide/en/uptime/current" + observability-guide: "https://www.elastic.co/guide/en/observability/current" + observability-guide-all: "https://www.elastic.co/guide/en/observability" + siem-guide: "https://www.elastic.co/guide/en/siem/guide/current" + security-guide: "https://www.elastic.co/guide/en/security/current" + security-guide-all: "https://www.elastic.co/guide/en/security" + endpoint-guide: "https://www.elastic.co/guide/en/endpoint/current" + sql-odbc: "https://www.elastic.co/guide/en/elasticsearch/sql-odbc/current" + ecs-ref: "https://www.elastic.co/guide/en/ecs/current" + ecs-logging-ref: "https://www.elastic.co/guide/en/ecs-logging/overview/current" + ecs-logging-go-logrus-ref: "https://www.elastic.co/guide/en/ecs-logging/go-logrus/current" + ecs-logging-go-zap-ref: "https://www.elastic.co/guide/en/ecs-logging/go-zap/current" + ecs-logging-go-zerolog-ref: "https://www.elastic.co/guide/en/ecs-logging/go-zap/current" + ecs-logging-java-ref: "https://www.elastic.co/guide/en/ecs-logging/java/current" + ecs-logging-dotnet-ref: "https://www.elastic.co/guide/en/ecs-logging/dotnet/current" + ecs-logging-nodejs-ref: "https://www.elastic.co/guide/en/ecs-logging/nodejs/current" + ecs-logging-php-ref: "https://www.elastic.co/guide/en/ecs-logging/php/current" + ecs-logging-python-ref: "https://www.elastic.co/guide/en/ecs-logging/python/current" + ecs-logging-ruby-ref: "https://www.elastic.co/guide/en/ecs-logging/ruby/current" + ml-docs: "https://www.elastic.co/guide/en/machine-learning/current" + eland-docs: "https://www.elastic.co/guide/en/elasticsearch/client/eland/current" + eql-ref: "https://eql.readthedocs.io/en/latest/query-guide" + extendtrial: "https://www.elastic.co/trialextension" + wikipedia: "https://en.wikipedia.org/wiki" + forum: "https://discuss.elastic.co/" + xpack-forum: "https://discuss.elastic.co/c/50-x-pack" + security-forum: "https://discuss.elastic.co/c/x-pack/shield" + watcher-forum: "https://discuss.elastic.co/c/x-pack/watcher" + monitoring-forum: "https://discuss.elastic.co/c/x-pack/marvel" + graph-forum: "https://discuss.elastic.co/c/x-pack/graph" + apm-forum: "https://discuss.elastic.co/c/apm" + enterprise-search-ref: "https://www.elastic.co/guide/en/enterprise-search/current" + app-search-ref: "https://www.elastic.co/guide/en/app-search/current" + workplace-search-ref: "https://www.elastic.co/guide/en/workplace-search/current" + enterprise-search-node-ref: "https://www.elastic.co/guide/en/enterprise-search-clients/enterprise-search-node/current" + enterprise-search-php-ref: "https://www.elastic.co/guide/en/enterprise-search-clients/php/current" + enterprise-search-python-ref: "https://www.elastic.co/guide/en/enterprise-search-clients/python/current" + enterprise-search-ruby-ref: "https://www.elastic.co/guide/en/enterprise-search-clients/ruby/current" + elastic-maps-service: "https://maps.elastic.co" + integrations-docs: "https://docs.elastic.co/en/integrations" + integrations-devguide: "https://www.elastic.co/guide/en/integrations-developer/current" + time-units: "https://www.elastic.co/guide/en/elasticsearch/reference/current/api-conventions.html#time-units" + byte-units: "https://www.elastic.co/guide/en/elasticsearch/reference/current/api-conventions.html#byte-units" + apm-py-ref-v: "https://www.elastic.co/guide/en/apm/agent/python/current" + apm-node-ref-v: "https://www.elastic.co/guide/en/apm/agent/nodejs/current" + apm-rum-ref-v: "https://www.elastic.co/guide/en/apm/agent/rum-js/current" + apm-ruby-ref-v: "https://www.elastic.co/guide/en/apm/agent/ruby/current" + apm-java-ref-v: "https://www.elastic.co/guide/en/apm/agent/java/current" + apm-go-ref-v: "https://www.elastic.co/guide/en/apm/agent/go/current" + apm-ios-ref-v: "https://www.elastic.co/guide/en/apm/agent/swift/current" + apm-dotnet-ref-v: "https://www.elastic.co/guide/en/apm/agent/dotnet/current" + apm-php-ref-v: "https://www.elastic.co/guide/en/apm/agent/php/current" + ecloud: "Elastic Cloud" + esf: "Elastic Serverless Forwarder" + ess: "Elasticsearch Service" + ece: "Elastic Cloud Enterprise" + eck: "Elastic Cloud on Kubernetes" + serverless-full: "Elastic Cloud Serverless" + serverless-short: "Serverless" + es-serverless: "Elasticsearch Serverless" + es3: "Elasticsearch Serverless" + obs-serverless: "Elastic Observability Serverless" + sec-serverless: "Elastic Security Serverless" + serverless-docs: "https://docs.elastic.co/serverless" + cloud: "https://www.elastic.co/guide/en/cloud/current" + ess-utm-params: "?page=docs&placement=docs-body" + ess-baymax: "?page=docs&placement=docs-body" + ess-trial: "https://cloud.elastic.co/registration?page=docs&placement=docs-body" + ess-product: "https://www.elastic.co/cloud/elasticsearch-service?page=docs&placement=docs-body" + ess-console: "https://cloud.elastic.co?page=docs&placement=docs-body" + ess-console-name: "Elasticsearch Service Console" + ess-deployments: "https://cloud.elastic.co/deployments?page=docs&placement=docs-body" + ece-ref: "https://www.elastic.co/guide/en/cloud-enterprise/current" + eck-ref: "https://www.elastic.co/guide/en/cloud-on-k8s/current" + ess-leadin: "You can run Elasticsearch on your own hardware or use our hosted Elasticsearch Service that is available on AWS, GCP, and Azure. https://cloud.elastic.co/registration{ess-utm-params}[Try the Elasticsearch Service for free]." + ess-leadin-short: "Our hosted Elasticsearch Service is available on AWS, GCP, and Azure, and you can https://cloud.elastic.co/registration{ess-utm-params}[try it for free]." + ess-icon: "image:https://doc-icons.s3.us-east-2.amazonaws.com/logo_cloud.svg[link=\"https://cloud.elastic.co/registration{ess-utm-params}\", title=\"Supported on Elasticsearch Service\"]" + ece-icon: "image:https://doc-icons.s3.us-east-2.amazonaws.com/logo_cloud_ece.svg[link=\"https://cloud.elastic.co/registration{ess-utm-params}\", title=\"Supported on Elastic Cloud Enterprise\"]" + cloud-only: "This feature is designed for indirect use by https://cloud.elastic.co/registration{ess-utm-params}[Elasticsearch Service], https://www.elastic.co/guide/en/cloud-enterprise/{ece-version-link}[Elastic Cloud Enterprise], and https://www.elastic.co/guide/en/cloud-on-k8s/current[Elastic Cloud on Kubernetes]. Direct use is not supported." + ess-setting-change: "image:https://doc-icons.s3.us-east-2.amazonaws.com/logo_cloud.svg[link=\"{ess-trial}\", title=\"Supported on {ess}\"] indicates a change to a supported https://www.elastic.co/guide/en/cloud/current/ec-add-user-settings.html[user setting] for Elasticsearch Service." + ess-skip-section: "If you use Elasticsearch Service, skip this section. Elasticsearch Service handles these changes for you." + api-cloud: "https://www.elastic.co/docs/api/doc/cloud" + api-ece: "https://www.elastic.co/docs/api/doc/cloud-enterprise" + api-kibana-serverless: "https://www.elastic.co/docs/api/doc/serverless" + es-feature-flag: "This feature is in development and not yet available for use. This documentation is provided for informational purposes only." + es-ref-dir: "'{{elasticsearch-root}}/docs/reference'" + apm-app: "APM app" + uptime-app: "Uptime app" + synthetics-app: "Synthetics app" + logs-app: "Logs app" + metrics-app: "Metrics app" + infrastructure-app: "Infrastructure app" + siem-app: "SIEM app" + security-app: "Elastic Security app" + ml-app: "Machine Learning" + dev-tools-app: "Dev Tools" + ingest-manager-app: "Ingest Manager" + stack-manage-app: "Stack Management" + stack-monitor-app: "Stack Monitoring" + alerts-ui: "Alerts and Actions" + rules-ui: "Rules" + rac-ui: "Rules and Connectors" + connectors-ui: "Connectors" + connectors-feature: "Actions and Connectors" + stack-rules-feature: "Stack Rules" + user-experience: "User Experience" + ems: "Elastic Maps Service" + ems-init: "EMS" + hosted-ems: "Elastic Maps Server" + ipm-app: "Index Pattern Management" + ingest-pipelines: "ingest pipelines" + ingest-pipelines-app: "Ingest Pipelines" + ingest-pipelines-cap: "Ingest pipelines" + ls-pipelines: "Logstash pipelines" + ls-pipelines-app: "Logstash Pipelines" + maint-windows: "maintenance windows" + maint-windows-app: "Maintenance Windows" + maint-windows-cap: "Maintenance windows" + custom-roles-app: "Custom Roles" + data-source: "data view" + data-sources: "data views" + data-source-caps: "Data View" + data-sources-caps: "Data Views" + data-source-cap: "Data view" + data-sources-cap: "Data views" + project-settings: "Project settings" + manage-app: "Management" + index-manage-app: "Index Management" + data-views-app: "Data Views" + rules-app: "Rules" + saved-objects-app: "Saved Objects" + tags-app: "Tags" + api-keys-app: "API keys" + transforms-app: "Transforms" + connectors-app: "Connectors" + files-app: "Files" + reports-app: "Reports" + maps-app: "Maps" + alerts-app: "Alerts" + crawler: "Enterprise Search web crawler" + ents: "Enterprise Search" + app-search-crawler: "App Search web crawler" + agent: "Elastic Agent" + agents: "Elastic Agents" + fleet: "Fleet" + fleet-server: "Fleet Server" + integrations-server: "Integrations Server" + ingest-manager: "Ingest Manager" + ingest-management: "ingest management" + package-manager: "Elastic Package Manager" + integrations: "Integrations" + package-registry: "Elastic Package Registry" + artifact-registry: "Elastic Artifact Registry" + aws: "AWS" + stack: "Elastic Stack" + xpack: "X-Pack" + es: "Elasticsearch" + kib: "Kibana" + esms: "Elastic Stack Monitoring Service" + esms-init: "ESMS" + ls: "Logstash" + beats: "Beats" + auditbeat: "Auditbeat" + filebeat: "Filebeat" + heartbeat: "Heartbeat" + metricbeat: "Metricbeat" + packetbeat: "Packetbeat" + winlogbeat: "Winlogbeat" + functionbeat: "Functionbeat" + journalbeat: "Journalbeat" + es-sql: "Elasticsearch SQL" + esql: "ES|QL" + elastic-agent: "Elastic Agent" + k8s: "Kubernetes" + log-driver-long: "Elastic Logging Plugin for Docker" + security: "X-Pack security" + security-features: "security features" + operator-feature: "operator privileges feature" + es-security-features: "Elasticsearch security features" + stack-security-features: "Elastic Stack security features" + endpoint-sec: "Endpoint Security" + endpoint-cloud-sec: "Endpoint and Cloud Security" + elastic-defend: "Elastic Defend" + elastic-sec: "Elastic Security" + elastic-endpoint: "Elastic Endpoint" + swimlane: "Swimlane" + sn: "ServiceNow" + sn-itsm: "ServiceNow ITSM" + sn-itom: "ServiceNow ITOM" + sn-sir: "ServiceNow SecOps" + jira: "Jira" + ibm-r: "IBM Resilient" + webhook: "Webhook" + webhook-cm: "Webhook - Case Management" + opsgenie: "Opsgenie" + bedrock: "Amazon Bedrock" + gemini: "Google Gemini" + hive: "TheHive" + monitoring: "X-Pack monitoring" + monitor-features: "monitoring features" + stack-monitor-features: "Elastic Stack monitoring features" + watcher: "Watcher" + alert-features: "alerting features" + reporting: "X-Pack reporting" + report-features: "reporting features" + graph: "X-Pack graph" + graph-features: "graph analytics features" + searchprofiler: "Search Profiler" + xpackml: "X-Pack machine learning" + ml: "machine learning" + ml-cap: "Machine learning" + ml-init: "ML" + ml-features: "machine learning features" + stack-ml-features: "Elastic Stack machine learning features" + ccr: "cross-cluster replication" + ccr-cap: "Cross-cluster replication" + ccr-init: "CCR" + ccs: "cross-cluster search" + ccs-cap: "Cross-cluster search" + ccs-init: "CCS" + ilm: "index lifecycle management" + ilm-cap: "Index lifecycle management" + ilm-init: "ILM" + dlm: "data lifecycle management" + dlm-cap: "Data lifecycle management" + dlm-init: "DLM" + search-snap: "searchable snapshot" + search-snaps: "searchable snapshots" + search-snaps-cap: "Searchable snapshots" + slm: "snapshot lifecycle management" + slm-cap: "Snapshot lifecycle management" + slm-init: "SLM" + rollup-features: "data rollup features" + ipm: "index pattern management" + ipm-cap: "Index pattern" + rollup: "rollup" + rollup-cap: "Rollup" + rollups: "rollups" + rollups-cap: "Rollups" + rollup-job: "rollup job" + rollup-jobs: "rollup jobs" + rollup-jobs-cap: "Rollup jobs" + dfeed: "datafeed" + dfeeds: "datafeeds" + dfeed-cap: "Datafeed" + dfeeds-cap: "Datafeeds" + ml-jobs: "machine learning jobs" + ml-jobs-cap: "Machine learning jobs" + anomaly-detect: "anomaly detection" + anomaly-detect-cap: "Anomaly detection" + anomaly-job: "anomaly detection job" + anomaly-jobs: "anomaly detection jobs" + anomaly-jobs-cap: "Anomaly detection jobs" + dataframe: "data frame" + dataframes: "data frames" + dataframe-cap: "Data frame" + dataframes-cap: "Data frames" + watcher-transform: "payload transform" + watcher-transforms: "payload transforms" + watcher-transform-cap: "Payload transform" + watcher-transforms-cap: "Payload transforms" + transform: "transform" + transforms: "transforms" + transform-cap: "Transform" + transforms-cap: "Transforms" + dataframe-transform: "transform" + dataframe-transform-cap: "Transform" + dataframe-transforms: "transforms" + dataframe-transforms-cap: "Transforms" + dfanalytics-cap: "Data frame analytics" + dfanalytics: "data frame analytics" + dataframe-analytics-config: "'{dataframe} analytics config'" + dfanalytics-job: "'{dataframe} analytics job'" + dfanalytics-jobs: "'{dataframe} analytics jobs'" + dfanalytics-jobs-cap: "'{dataframe-cap} analytics jobs'" + cdataframe: "continuous data frame" + cdataframes: "continuous data frames" + cdataframe-cap: "Continuous data frame" + cdataframes-cap: "Continuous data frames" + cdataframe-transform: "continuous transform" + cdataframe-transforms: "continuous transforms" + cdataframe-transforms-cap: "Continuous transforms" + ctransform: "continuous transform" + ctransform-cap: "Continuous transform" + ctransforms: "continuous transforms" + ctransforms-cap: "Continuous transforms" + oldetection: "outlier detection" + oldetection-cap: "Outlier detection" + olscore: "outlier score" + olscores: "outlier scores" + fiscore: "feature influence score" + evaluatedf-api: "evaluate {dataframe} analytics API" + evaluatedf-api-cap: "Evaluate {dataframe} analytics API" + binarysc: "binary soft classification" + binarysc-cap: "Binary soft classification" + regression: "regression" + regression-cap: "Regression" + reganalysis: "regression analysis" + reganalysis-cap: "Regression analysis" + depvar: "dependent variable" + feature-var: "feature variable" + feature-vars: "feature variables" + feature-vars-cap: "Feature variables" + classification: "classification" + classification-cap: "Classification" + classanalysis: "classification analysis" + classanalysis-cap: "Classification analysis" + infer-cap: "Inference" + infer: "inference" + lang-ident-cap: "Language identification" + lang-ident: "language identification" + data-viz: "Data Visualizer" + file-data-viz: "File Data Visualizer" + feat-imp: "feature importance" + feat-imp-cap: "Feature importance" + nlp: "natural language processing" + nlp-cap: "Natural language processing" + apm-agent: "APM agent" + apm-go-agent: "Elastic APM Go agent" + apm-go-agents: "Elastic APM Go agents" + apm-ios-agent: "Elastic APM iOS agent" + apm-ios-agents: "Elastic APM iOS agents" + apm-java-agent: "Elastic APM Java agent" + apm-java-agents: "Elastic APM Java agents" + apm-dotnet-agent: "Elastic APM .NET agent" + apm-dotnet-agents: "Elastic APM .NET agents" + apm-node-agent: "Elastic APM Node.js agent" + apm-node-agents: "Elastic APM Node.js agents" + apm-php-agent: "Elastic APM PHP agent" + apm-php-agents: "Elastic APM PHP agents" + apm-py-agent: "Elastic APM Python agent" + apm-py-agents: "Elastic APM Python agents" + apm-ruby-agent: "Elastic APM Ruby agent" + apm-ruby-agents: "Elastic APM Ruby agents" + apm-rum-agent: "Elastic APM Real User Monitoring (RUM) JavaScript agent" + apm-rum-agents: "Elastic APM RUM JavaScript agents" + apm-lambda-ext: "Elastic APM AWS Lambda extension" + project-monitors: "project monitors" + project-monitors-cap: "Project monitors" + private-location: "Private Location" + private-locations: "Private Locations" + pwd: "YOUR_PASSWORD" + esh: "ES-Hadoop" + default-dist: "default distribution" + oss-dist: "OSS-only distribution" + observability: "Observability" + api-request-title: "Request" + api-prereq-title: "Prerequisites" + api-description-title: "Description" + api-path-parms-title: "Path parameters" + api-query-parms-title: "Query parameters" + api-request-body-title: "Request body" + api-response-codes-title: "Response codes" + api-response-body-title: "Response body" + api-example-title: "Example" + api-examples-title: "Examples" + api-definitions-title: "Properties" + multi-arg: "†footnoteref:[multi-arg,This parameter accepts multiple arguments.]" + multi-arg-ref: "†footnoteref:[multi-arg]" + yes-icon: "image:https://doc-icons.s3.us-east-2.amazonaws.com/icon-yes.png[Yes,20,15]" + no-icon: "image:https://doc-icons.s3.us-east-2.amazonaws.com/icon-no.png[No,20,15]" + es-repo: "https://github.com/elastic/elasticsearch/" + es-issue: "https://github.com/elastic/elasticsearch/issues/" + es-pull: "https://github.com/elastic/elasticsearch/pull/" + es-commit: "https://github.com/elastic/elasticsearch/commit/" + kib-repo: "https://github.com/elastic/kibana/" + kib-issue: "https://github.com/elastic/kibana/issues/" + kibana-issue: "'{kib-repo}issues/'" + kib-pull: "https://github.com/elastic/kibana/pull/" + kibana-pull: "'{kib-repo}pull/'" + kib-commit: "https://github.com/elastic/kibana/commit/" + ml-repo: "https://github.com/elastic/ml-cpp/" + ml-issue: "https://github.com/elastic/ml-cpp/issues/" + ml-pull: "https://github.com/elastic/ml-cpp/pull/" + ml-commit: "https://github.com/elastic/ml-cpp/commit/" + apm-repo: "https://github.com/elastic/apm-server/" + apm-issue: "https://github.com/elastic/apm-server/issues/" + apm-pull: "https://github.com/elastic/apm-server/pull/" + kibana-blob: "https://github.com/elastic/kibana/blob/current/" + apm-get-started-ref: "https://www.elastic.co/guide/en/apm/get-started/current" + apm-server-ref: "https://www.elastic.co/guide/en/apm/server/current" + apm-server-ref-v: "https://www.elastic.co/guide/en/apm/server/current" + apm-server-ref-m: "https://www.elastic.co/guide/en/apm/server/master" + apm-server-ref-62: "https://www.elastic.co/guide/en/apm/server/6.2" + apm-server-ref-64: "https://www.elastic.co/guide/en/apm/server/6.4" + apm-server-ref-70: "https://www.elastic.co/guide/en/apm/server/7.0" + apm-overview-ref-v: "https://www.elastic.co/guide/en/apm/get-started/current" + apm-overview-ref-70: "https://www.elastic.co/guide/en/apm/get-started/7.0" + apm-overview-ref-m: "https://www.elastic.co/guide/en/apm/get-started/master" + infra-guide: "https://www.elastic.co/guide/en/infrastructure/guide/current" + a-data-source: "a data view" + icon-bug: "pass:[]" + icon-checkInCircleFilled: "pass:[]" + icon-warningFilled: "pass:[]" diff --git a/docs/release-notes/breaking-changes.md b/docs/release-notes/breaking-changes.md new file mode 100644 index 00000000000..607ea6b495c --- /dev/null +++ b/docs/release-notes/breaking-changes.md @@ -0,0 +1,53 @@ +--- +navigation_title: "Elastic APM" +--- + +# Elastic APM breaking changes + +Before you upgrade, carefully review the Elastic APM breaking changes and take the necessary steps to mitigate any issues. + +% To learn how to upgrade, check out . + +% ## Next version + +% **Release date:** Month day, year + +% ::::{dropdown} Title of breaking change +% Description of the breaking change. +% For more information, check [PR #](PR link). +% **Impact**
Impact of the breaking change. +% **Action**
Steps for mitigating deprecation impact. +% :::: + +## 9.0.0 [9-0-0] + +**Release date:** March 25, 2025 + +::::{dropdown} Change server information endpoint "/" to only accept GET and HEAD requests +This will surface any agent misconfiguration causing data to be sent to `/` instead of the correct endpoint (for example, `/v1/traces` for OTLP/HTTP). +For more information, check [PR #15976](https://github.com/elastic/apm-server/pull/15976). + +**Impact**
Any methods other than `GET` and `HEAD` to `/` will return HTTP 405 Method Not Allowed. + +**Action**
Update any existing usage, for example, update `POST /` to `GET /`. +:::: + +::::{dropdown} The Elasticsearch apm_user role has been removed +The Elasticsearch `apm_user` role has been removed. +For more information, check [PR #14876](https://github.com/elastic/apm-server/pull/14876). + +**Impact**
If you are relying on the `apm_user` to provide access, users may lose access when upgrading to the next version. + +**Action**
After this change if you are relying on `apm_user` you will need to specify its permissions manually. +:::: + +::::{dropdown} The sampling.tail.storage_limit default value changed to 0 +The `sampling.tail.storage_limit` default value changed to `0`. While `0` means unlimited local tail-sampling database size, it now enforces a max 80% disk usage on the disk where the data directory is located. Any tail sampling writes that occur after this threshold will be rejected, similar to what happens when tail-sampling database size exceeds a non-0 storage limit. Setting `sampling.tail.storage_limit` to non-0 maintains the existing behavior, which limits the tail-sampling database size to `sampling.tail.storage_limit` and does not have the new disk usage threshold check. +For more information, check [PR #15467](https://github.com/elastic/apm-server/pull/15467) and [PR #15524](https://github.com/elastic/apm-server/pull/15524). + +**Impact**
If `sampling.tail.storage_limit` is already set to a non-`0` value, tail sampling will maintain the existing behavior. +If you're using the new default, it will automatically scale with a larger disk. + +**Action**
To continue using the existing behavior, set the `sampling.tail.storage_limit` to a non-`0` value. +To use the new disk usage threshold check, set the `sampling.tail.storage_limit` to `0` (the default value). +:::: diff --git a/docs/release-notes/deprecations.md b/docs/release-notes/deprecations.md new file mode 100644 index 00000000000..3adc48a0080 --- /dev/null +++ b/docs/release-notes/deprecations.md @@ -0,0 +1,29 @@ +--- +navigation_title: "Elastic APM" +--- + +# Elastic APM deprecations + +Review the deprecated functionality for your Elastic APM version. While deprecations have no immediate impact, we strongly encourage you update your implementation after you upgrade. + +% To learn how to upgrade, check out . + +% ## Next version +% **Release date:** Month day, year + +% ::::{dropdown} Deprecation title +% Description of the deprecation. +% For more information, check [PR #](PR link). +% **Impact**
Impact of deprecation. +% **Action**
Steps for mitigating deprecation impact. +% :::: + +% ## 9.0.0 [9-0-0] +% **Release date:** March 25, 2025 + +% ::::{dropdown} Deprecation title +% Description of the deprecation. +% For more information, check [PR #](PR link). +% **Impact**
Impact of deprecation. +% **Action**
Steps for mitigating deprecation impact. +% :::: \ No newline at end of file diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md new file mode 100644 index 00000000000..cc49be6db54 --- /dev/null +++ b/docs/release-notes/index.md @@ -0,0 +1,35 @@ +--- +navigation_title: "Elastic APM" +mapped_pages: + - https://www.elastic.co/guide/en/observability/current/apm-release-notes.html + - https://www.elastic.co/guide/en/observability/master/release-notes-head.html +--- + +# Elastic APM release notes + +Review the changes, fixes, and more in each version of Elastic APM. + +To check for security updates, go to [Security announcements for the Elastic stack](https://discuss.elastic.co/c/announcements/security-announcements/31). + +% Release notes include only features, enhancements, and fixes. Add breaking changes, deprecations, and known issues to the applicable release notes sections. +% For each new version section, include the Elastic APM and Kibana changes. + +% ## version.next [elastic-apm-next-release-notes] +% **Release date:** Month day, year + +% ### Features and enhancements [elastic-apm-next-features-enhancements] + +% ### Fixes [elastic-apm-next-fixes] + +## 9.0.0 [9-0-0] + +**Release date:** March 25, 2025 + +### Features and enhancements [9-0-0-features-enhancements] + +* **Tail-based sampling**: Storage layer is rewritten to use Pebble database instead of BadgerDB. The new implementation offers a substantial throughput increase while consuming significantly less memory. Disk usage is lower and more stable. See PR for benchmark details. ([#15235](https://github.com/elastic/apm-server/pull/15235)) + +### Fixes [9-0-0-fixes] + +* Fix overflow in validation of `apm-server.agent.config.cache.expiration` on 32-bit architectures. ([#15216](https://github.com/elastic/apm-server/pull/15216)) +* Change permissions of `apm-server.yml` in `tar.gz` artifacts to `0600`. ([#15627](https://github.com/elastic/apm-server/pull/15627)) diff --git a/docs/release-notes/known-issues.md b/docs/release-notes/known-issues.md new file mode 100644 index 00000000000..5d5e105fd67 --- /dev/null +++ b/docs/release-notes/known-issues.md @@ -0,0 +1,327 @@ +--- +mapped_pages: + - https://www.elastic.co/guide/en/observability/current/apm-known-issues.html + +navigation_title: "Elastic APM" +--- + +# Elastic APM known issues + +% Use the following template to add entries to this page. + +% :::{dropdown} Title of known issue +% **Details** +% On [Month/Day/Year], a known issue was discovered that [description of known issue]. + +% **Workaround** +% Workaround description. + +% **Resolved** +% On [Month/Day/Year], this issue was resolved. + +::: + +APM has the following known issues: + +:::{dropdown} prefer_ilm required in component templates to create custom lifecycle policies + +*Elastic Stack versions: 8.15.1+* + +The issue occurs when creating a *new* cluster using version 8.15.1+. The issue occurs for any APM data streams created in 8.15.1+. The issue does *not* occur if custom component template has been created in or before version 8.15.0. + +In 8.15.0, APM Server began using the [apm-data plugin](https://github.com/elastic/elasticsearch/tree/main/x-pack/plugin/apm-data) to manage data streams, ingest pipelines, lifecycle policies, and more. In 8.15.1, a fix was introduced to address unmanaged indices in older clusters using default ILM policies. This fix added a fallback to the default ILM policy (if it exists) and set the `prefer_ilm` configuration to `false`. This setting impacts clusters where both ILM and data stream lifecycles (DSL) are in effect—such as when configuring custom ILM policies using `@custom` component templates, under the conditions mentioned above. + +To override ILM policies for these new clusters using component template, set the `prefer_ilm` configuration to `true` by following the [updated guide to customize ILM](docs-content://solutions/observability/apps/index-lifecycle-management.md). + +::: + +:::{dropdown} Upgrading to v8.15.x may cause ingestion to fail + +*Elastic Stack versions: 8.15.0, 8.15.1, 8.15.2, 8.15.3*
*Fixed in Elastic Stack version 8.15.4* + +The issue only occurs when *upgrading* the {{stack}} from 8.12.2 or lower directly to any 8.15.x version prior to 8.15.4. The issue does *not* occur when creating a *new* cluster using any 8.15.x version, or when upgrading from 8.12.2 to 8.13.x or 8.14.x and then to 8.15.x. + +In APM Servers versions prior to 8.13.0, an ingestion pipeline exists to perform a check on the version. The version check would fail any APM document produced with a different version of APM server compared to the version of the installed APM’s ingest pipeline. In 8.13.0 the version check in the ingest pipeline was removed. Due to the combination of an internal change in how apm data management assets are set up from 8.15 onwards and a bug in Elasticsearch, related to [lazy rollover of data streams](https://github.com/elastic/elasticsearch/issues/112781), the ingestion pipeline conducting the version check is not removed on upgrade and prevents the ingestion of data. + +If the deployment is running 8.15.0, upgrade the deployment to 8.15.1 or above. A manual rollover of all APM data streams is required to pick up the new index templates and remove the faulty ingest pipeline version check. Perform the following requests to Elasticsearch (they are assuming the `default` namespace is used, adjust if necessary): + +```txt +POST /traces-apm-default/_rollover +POST /traces-apm.rum-default/_rollover +POST /logs-apm.error-default/_rollover +POST /logs-apm.app-default/_rollover +POST /metrics-apm.app-default/_rollover +POST /metrics-apm.internal-default/_rollover +POST /metrics-apm.service_destination.1m-default/_rollover +POST /metrics-apm.service_destination.10m-default/_rollover +POST /metrics-apm.service_destination.60m-default/_rollover +POST /metrics-apm.service_summary.1m-default/_rollover +POST /metrics-apm.service_summary.10m-default/_rollover +POST /metrics-apm.service_summary.60m-default/_rollover +POST /metrics-apm.service_transaction.1m-default/_rollover +POST /metrics-apm.service_transaction.10m-default/_rollover +POST /metrics-apm.service_transaction.60m-default/_rollover +POST /metrics-apm.transaction.1m-default/_rollover +POST /metrics-apm.transaction.10m-default/_rollover +POST /metrics-apm.transaction.60m-default/_rollover +``` +::: + +:::{dropdown} Upgrading to v8.15.0 may cause APM indices to lose their lifecycle policy + +*Elastic Stack versions: 8.15.0*
*Fixed in Elastic Stack version 8.15.1* + +The issue only occurs when *upgrading* the {{stack}} to 8.15.0. The issue does *not* occur when creating a *new* cluster using 8.15.0. The issue also does not occur if a custom ILM policy is configured using a custom component template. + +In 8.15.0, APM Server switched to use data stream lifecycle to manage data retention for APM indices for new deployments as well as for upgraded deployments with default lifecycle configurations. Unfortunately, since any data stream created before 8.15.0 does not have a data stream lifecycle configuration, such existing data streams become unmanaged for default lifecycle configurations. + +Upgrading to 8.15.1 resolves the lifecycle issue for any new indices created for APM data streams. However, indices created in version 8.15.0 will remain unmanaged if the default ILM policy is in place. To fix these unmanaged indices, consider one of the following approaches: + +1. Manually delete the unmanaged indices when they are no longer needed. +2. Explicitly configure APM data streams to use the default data stream lifecycle configuration. This approach migrates all affected data streams to use data stream lifecycles, maintaining behavior equivalent to the default ILM policies. Apply this fix only to data streams that have unmanaged indices due to missing default ILM policies. + + ```txt + PUT _data_stream/{{data_stream_name}}-{{data_stream_namespace}}/_lifecycle + { + "data_retention": + } + ``` + + +Default `` for each data stream is available in [this guide](docs-content://solutions/observability/apps/index-lifecycle-management.md). + +This issue is fixed in 8.15.1 ([elastic/elasticsearch#112432](https://github.com/elastic/elasticsearch/pull/112432)). +::: + +:::{dropdown} Upgrading to v8.13.0 to v8.13.2 breaks APM anomaly rules [broken-apm-anomaly-rule] + +*Elastic Stack versions: 8.13.0, 8.13.1, 8.13.2*
*Fixed in Elastic Stack version 8.13.3* + +This issue occurs when upgrading the Elastic Stack to version 8.13.0, 8.13.1, or 8.13.2. This issue may go unnoticed unless you actively monitor your {{kib}} logs. The following log indicates the presence of this issue: + +```shell +"params invalid: [anomalyDetectorTypes]: expected value of type [array] but got [undefined]" +``` + +This issue occurs because a non-optional parameter, `anomalyDetectorTypes` was added in 8.13.0 without the presence of an automation migration script. This breaks pre-existing rules as they do not have this parameter and will fail validation. This issue is fixed in v8.13.3. + +There are three ways to fix this error: + +* Upgrade to version 8.13.3 +* Fix broken anomaly rules in the APM UI (no upgrade required) +* Fix broken anomaly rules with Kibana APIs (no upgrade required) + +**Fix broken anomaly rules in the APM UI** + +1. From any APM page in Kibana, select **Alerts and rules** → **Manage rules**. +2. Filter your rules by setting **Type** to **APM Anomaly**. +3. For each anomaly rule in the list, select the pencil icon to edit the rule. +4. Add one or more **DETECTOR TYPES** to the rule. + + The detector type determines when the anomaly rule triggers. For example, a latency anomaly rule will trigger when the latency of the service being monitored is abnormal. Supported detector types are `latency`, `throughput`, and `failed transaction rate`. + +5. Click **Save**. + +**Fix broken anomaly rules with Kibana APIs** + +1. Find broken rules + + :::::{note} + To identify rules in this exact state, you can use the [find rules endpoint](https://www.elastic.co/docs/api/doc/kibana/v8/group/endpoint-alerting) and search for the APM anomaly rule type as well as this exact error message indicating that the rule is in the broken state. We will also use the `fields` parameter to specify only the fields required when making the update request later. + + * `search_fields=alertTypeId` + * `search=apm.anomaly` + * `filter=alert.attributes.executionStatus.error.message:"params invalid: [anomalyDetectorTypes]: expected value of type [array] but got [undefined]"` + * `fields=[id, name, actions, tags, schedule, notify_when, throttle, params]` + + The encoded request might look something like this: + + ```shell + curl -u "$KIBANA_USER":"$KIBANA_PASSWORD" "$KIBANA_URL/api/alerting/rules/_find?search_fields=alertTypeId&search=apm.anomaly&filter=alert.attributes.executionStatus.error.message%3A%22params%20invalid%3A%20%5BanomalyDetectorTypes%5D%3A%20expected%20value%20of%20type%20%5Barray%5D%20but%20got%20%5Bundefined%5D%22&fields=id&fields=name&fields=actions&fields=tags&fields=schedule&fields=notify_when&fields=throttle&fields=params" + ``` + + ::::{dropdown} Example result: + ```json + { + "page": 1, + "total": 1, + "per_page": 10, + "data": [ + { + "id": "d85e54de-f96a-49b5-99d4-63956f90a6eb", + "name": "APM Anomaly Jason Test FAILING [2]", + "tags": [ + "test", + "jasonrhodes" + ], + "throttle": null, + "schedule": { + "interval": "1m" + }, + "params": { + "windowSize": 30, + "windowUnit": "m", + "anomalySeverityType": "warning", + "environment": "ENVIRONMENT_ALL" + }, + "notify_when": null, + "actions": [] + } + ] + } + ``` + + :::: + + + ::::: + +2. Prepare the update JSON doc(s) + + ::::{note} + For each broken rule found, create a JSON rule document with what was returned from the API in the previous step. You will need to make two changes to each document: + + 1. Remove the `id` key but keep the value connected to this document (e.g. rename the file to `{{id}}.json`). **The `id` cannot be sent as part of the request body for the PUT request, but you will need it for the URL path.** + 2. Add the `"anomalyDetectorTypes"` to the `"params"` block, using the default value as seen below to mimic the pre-8.13 behavior: + + ```json + { + "params": { + // ... other existing params should stay here, + // with the required one added to this object + "anomalyDetectorTypes": [ + "txLatency", + "txThroughput", + "txFailureRate" + ] + } + } + ``` + + + :::: + +3. Update each rule using the `PUT /api/alerting/rule/{{id}}` API + + ::::{note} + For each rule, submit a PUT request to the [update rule endpoint](https://www.elastic.co/docs/api/doc/kibana/v8/group/endpoint-alerting) using that rule’s ID and its stored update document from the previous step. For example, assuming the first broken rule’s ID is `046c0d4f`: + + ```shell + curl -u "$KIBANA_USER":"$KIBANA_PASSWORD" -XPUT "$KIBANA_URL/api/alerting/rule/046c0d4f" -H 'Content-Type: application/json' -H 'kbn-xsrf: rule-update' -d @046c0d4f.json + ``` + + Once the PUT request executes successfully, the rule will no longer be broken. + + :::: + +::: + +:::{dropdown} Upgrading APM Server to 8.11+ might break event intake from older APM Java agents + +*APM Server versions: >=8.11.0*
*Elastic APM Java agent versions: < 1.43.0* + +If you are using APM Server (> v8.11.0) and the Elastic APM Java agent (< v1.43.0), the agent may be sending empty histogram metricsets. + +In previous APM Server versions some data validation was not properly applied, leading the APM Server to accept empty histogram metricsets where it shouldn’t. This bug was fixed in the APM Server in 8.11.0. + +The APM Java agent (< v1.43.0) was sending this kind of invalid data under certain circumstances. If you upgrade the APM Server to v8.11.0+ *without* upgrading the APM Java agent version, metricsets can be rejected by the APM Server and can result in additional error logs in the Java agent. + +The fix is to upgrade the Elastic APM Java agent to a version >= 1.43.0. Find details in [elastic/apm-data#157](https://github.com/elastic/apm-data/pull/157). + +::: + +:::{dropdown} traces-apm@custom ingest pipeline applied to certain data streams unintentionally + +*APM Server versions: 8.12.0*
+ +If you’re using the Elastic APM Server v8.12.0, the `traces-apm@custom` ingest pipeline is now additionally applied to data streams `traces-apm.sampled-*` and `traces-apm.rum-*`, and applied twice for `traces-apm-*`. This bug impacts users with a non-empty `traces-apm@custom` ingest pipeline. + +If you rely on this unintended behavior in 8.12.0, please rename your pipeline to `traces-apm.integration@custom` to preserve this behavior in later versions. + +A fix was released in 8.12.1: [elastic/kibana#175448](https://github.com/elastic/kibana/pull/175448). + +::: + +:::{dropdown} Ingesting new JVM metrics in 8.9 and 8.10 breaks upgrade to 8.11 and stops ingestion + +*APM Server versions: 8.11.0, 8.11.1*
*Elastic APM Java agent versions: 1.39.0+* + +If you’re using the Elastic APM Java agent v1.39.0+ to send new JVM metrics to APM Server v8.9.x and v8.10.x, upgrading to 8.11.0 or 8.11.1 will silently fail and stop ingesting APM metrics. + +After upgrading, you will see the following errors: + +* APM Server error logs: + + ```txt + failed to index document in 'metrics-apm.internal-default' (fail_processor_exception): Document produced by APM Server v8.11.1, which is newer than the installed APM integration (v8.10.3-preview-1695284222). The APM integration must be upgraded. + ``` + +* Fleet error on integration package upgrade: + + ```txt + Failed installing package [apm] due to error: [ResponseError: mapper_parsing_exception + Root causes: + mapper_parsing_exception: Field [jvm.memory.non_heap.pool.committed] attempted to shadow a time_series_metric] + ``` + + +A fix was released in 8.11.2: [elastic/kibana#171712](https://github.com/elastic/kibana/pull/171712). + +::: + +:::{dropdown} APM integration package upgrade through Fleet causes excessive data stream rollovers + +*APM Server versions: <= 8.12.1 +* + +If you’re upgrading APM integration package to any versions <= 8.12.1, in some rare cases, the upgrade fails with a mapping conflict error. The upgrade process keeps rolling over the data stream in an unsuccessful attempt to work around the error. As a result, many empty backing indices for APM data streams are created. + +During upgrade, you will see errors similar to the one below: + +* Fleet error on integration package upgrade: + + ```txt + Mappings update for metrics-apm.service_destination.10m-default failed due to ResponseError: illegal_argument_exception + Root causes: + illegal_argument_exception: Mapper for [metricset.interval] conflicts with existing mapper: + Cannot update parameter [value] from [10m] to [null] + ``` + + +A fix was released in 8.12.2: [elastic/apm-server#12219](https://github.com/elastic/apm-server/pull/12219). + +::: + +:::{dropdown} Performance regression: APM issues too many small bulk requests for Elasticsearch output + +*APM Server versions: >=8.13.0, <= 8.14.2* + +If you’re on APM server version >=8.13.0, <= 8.14.2_, using Elasticsearch output, do not specify any `output.elasticsearch.flush_bytes`, and do not disable compression explicitly by setting `output.elasticsearch.compression_level` to `0`, APM server will issue smaller bulk requests of 24KB size, and more bulk requests will need to be made to maintain the original throughput. This causes Elasticsearch to experience higher load, and APM server may exhibit Elasticsearch backpressure symptoms. + +This happens because a performance regression was introduced, such that the default value of bulk indexer flush bytes was reduced from 1MB to 24KB. + +Affected APM servers will emit the following log: + +```txt +flush_bytes config value is too small (0) and might be ignored by the indexer, increasing value to 24576 +``` + +To workaround the issue, modify the Elasticsearch output configuration in APM. + +* For APM Server binary + + * In `apm-server.yml`, set `output.elasticsearch.flush_bytes: 1mib` + +* For Fleet-managed APM (non-Elastic Cloud) + + * In Fleet, open the Settings tab. + * Under Outputs, identify the Elasticsearch output that receives from APM, select the edit icon. + * In the Edit output flyout, in "Advanced YAML configuration" field, add line `flush_bytes: 1mib`. + +* For Elastic Cloud + + * It is not possible to edit the Fleet "Elastic Cloud internal output". + + +A fix will be released in 8.14.3: [elastic/apm-server#13576](https://github.com/elastic/apm-server/pull/13576). + +::: \ No newline at end of file diff --git a/docs/release-notes/toc.yml b/docs/release-notes/toc.yml new file mode 100644 index 00000000000..a4100679473 --- /dev/null +++ b/docs/release-notes/toc.yml @@ -0,0 +1,5 @@ +toc: + - file: index.md + - file: known-issues.md + - file: breaking-changes.md + - file: deprecations.md \ No newline at end of file