Breaking Changes
editBreaking Changes
edit7.17
editThere are no breaking changes in APM Server.
7.16
editThe following breaking changes were introduced in 7.16:
- Removed unused stacktrace/frame monitoring counters 5984
- Removed unused support for top-level metricsets and metricset tags for RUMv3 6065
-
Removed
apm-server.mode
configuration, and "experimental" fields 6086 -
transaction.sampled
is now only set for sampled transactions 6066 -
Unknown metrics are dropped when
transaction.*
orspan.*
are present in a metricset 6111 -
Removed
metricset.period
from service_destination metrics 6111 -
Removed
http.request.socket
fields 6152 -
Removed unused
transaction.duration.{count,sum.us}
metric fields 6180 -
Removed
ProcessPending
self-instrumentation events 6243 - Removed warm phase from default ILM policy 6322
-
Removed unused
transaction.breakdown.count
metric field 6366 -
[preview]
This breaking change applies to the experimental tail-based sampling feature.
Changed
apm-server.sampling.tail.events.*
metrics semantics 6273 -
[preview]
This breaking change applies to the experimental tail-based sampling feature.
Removed
apm-server.sampling.tail.storage_dir
config 6236
7.15
editThe following breaking changes were introduced in 7.15:
-
network.connection_type
is nownetwork.connection.type
5671 -
transaction.page
anderror.page
no longer recorded 5872 -
[preview]
This breaking change applies to the experimental tail-based sampling feature.
apm-server.sampling.tail
now requiresapm-server.data_streams.enabled
5952 -
[beta]
This breaking change applies to the beta APM integration.
The
traces-sampled-*
data stream is nowtraces-apm.sampled-*
5952
7.14
editThere are no breaking changes in APM Server.
7.13
editThere are no breaking changes in APM Server.
7.12
editThere are three breaking changes to be aware of; these changes only impact users ingesting data with Jaeger clients.
-
Leading 0s are no longer removed from Jaeger client trace/span ids.
This change ensures distributed tracing continues to work across platforms by creating consistent, full trace/span IDs from Jaeger clients, Elastic APM agents, and OpenTelemetry SDKs.
-
Jaeger spans will now have a type of "app" where they previously were "custom".
If the Jaeger span type is not inferred, it will now be "app". This aligns with the OpenTelemetry Collector exporter and improves the functionality of the time spent by span type charts in the APM app.
-
Jaeger spans may now have a more accurate outcome of "unknown".
Previously, a "success" outcome was assumed when a span didn’t fail. The new default assigns "unknown", and only sets an outcome of "success" or "failure" when the outcome is explicitly known. This change aligns with Elastic APM agents and the OpenTelemetry Collector exporter.
7.11
editThere are no breaking changes in APM Server.
7.10
editThere are no breaking changes in APM Server.
7.9
editThere are no breaking changes in APM Server.
7.8
editThere are no breaking changes in APM Server.
7.7
editThere are no breaking changes in APM Server. However, a previously hardcoded feature is now configurable. Failing to follow these upgrade steps will result in increased span metadata ingestion when upgrading to version 7.7.
7.6
editThere are no breaking changes in APM Server.
7.5
editThe following breaking changes have been introduced in 7.5:
-
Introduced dedicated
apm-server.ilm.setup.*
flags. This means you can now customize ILM behavior from within the APM Server configuration. As a side effect,setup.template.*
settings will be ignored for ILM related templates per event type. See set up ILM for more information. - By default, ILM policies will not longer be versioned. All event types will switch to the new default policy: rollover after 30 days or when reaching a size 50gb. See default policy for more information.
- To make use of all the new features introduced in 7.5, you must ensure you are using version 7.5+ of APM Server and version 7.5+ of Kibana.
7.0
editThe following breaking changes have been introduced in 7.0:
- Removed deprecated Intake v1 API endpoints. Upgrade agents to a version that supports APM Server ≥ 6.5. More information.
- Moved fields in Elasticsearch to be compliant with the Elastic Common Schema (ECS). More information and changed fields.
- Breaking changes in libbeat
6.5
editThere are no breaking changes in APM Server. Advanced users may find the upgrading to 6.5 guide useful.
6.4
editThe following breaking changes have been introduced in 6.4:
-
Indexing the
onboarding
document in it’s own index by default.
6.3
editThe following breaking changes have been introduced in 6.3:
- Indexing events in separate indices by default.
6.2
editAPM Server is now GA (generally available).