« APM 代理兼容性 升级到 8.16.0 版本 »
Elastic 文档 ›Elastic 可观测性 [8.16] ›应用和服务监控 ›应用性能监控 (APM) ›升级

重大变更

编辑

重大变更

编辑

本节描述了在此版本和之前的次要版本中引入的重大变更和弃用功能。

8.11
编辑

APM 8.11.0 版本引入了以下重大变更：

  • 已从 APM 数据流中删除 ecs.version 字段。此更改不会影响大多数用户，因为 APM UI 不使用此字段。更多详情，请参见 PR #11632
8.10
编辑

APM 8.10.0 版本引入了以下重大变更：

  • 聚合指标现在将全局标签视为服务标识的一部分，高基数全局标签可能会导致服务被隐藏。更多详情，请参见 PR #11386。
  • 基于尾部采样的事件protobuf编码已更改为更有效的事件时间戳和持续时间编码。更多详情，请参见 PR #11386。
8.7
编辑

APM 8.7.0 版本引入了以下重大变更和弃用功能：

  • transaction.failure_count 已删除。transaction.success_count 类型已更改为 aggregated_metric_double。更多详情，请参见 PR #9791。
  • transaction.success_count 已移动到 event.success_count。更多详情，请参见 PR #9819。
  • 停止将事务指标索引到 metrics-apm.internal。更多详情，请参见 PR #9846。
  • 停止将跨度目标指标索引到 metrics-apm.internal。更多详情，请参见 PR #9926。
  • apmserver.aggregation.txmetrics.overflowed 指标已重命名为 apmserver.aggregation.txmetrics.overflowed.total。更多详情，请参见 PR #10330。
  • Elasticsearch 源映射凭据现在需要访问 .apm-source-map 索引。更多详情，请参见 PR #9722。
  • 将 APM 服务器默认主机更改为 127.0.0.1。更多详情，请参见 PR #9877。
8.6
编辑

APM 8.6.0 版本引入了以下重大变更和弃用功能：

apm-server.decoder.* 停止记录
编辑

不再记录堆栈监控指标 apm-server.decoder.*。这些指标未被堆栈监控使用，因此不应该有明显的变化。

更多详情，请参见 PR #9210。

context.http.response.*_size 字段现在强制使用整数值
编辑

新的字段映射强制 context.http.response.*_size 使用整数值。这些字段使用 index: false 映射以最大限度地减少存储开销。

更多详情，请参见 PR #9429。

observer.id 和 observer.ephemeral_id 已删除
编辑

不再将 observer.id 和 observer.ephemeral_id 添加到 APM 文档中。APM UI 目前不依赖于这些字段，因此不应该有明显的变化。

更多详情，请参见 PR #9412。

timeseries.instance 已删除
编辑

已从事务指标文档中删除 timeseries.instance。APM UI 未使用此字段，因此不应该有明显的变化。

更多详情，请参见 PR #9565。

8.2
编辑

APM 8.2.0 版本引入了以下重大变更：

APM 服务器现在使用 event.duration 发出事件
编辑

APM 服务器不再使用 transaction.duration.us 或 span.duration.us 发出事件。现在，事件将使用 event.duration 发出。摄取管道设置旧的 <event>.duration.us 字段并删除 event.duration。

此更改将影响未使用 APM 服务器的 Elasticsearch 输出或打包的摄取管道的用户。详情请参见 PR #7261。

已删除 observer.version_major
编辑

observer.version_major 字段是非标准的，仅用于 APM UI 过滤旧文档（版本 <7.0）。此检查不再执行，因此已删除该字段。

详情请参见 PR #7399。

APM 服务器不再附带 System V init 脚本或 go-daemon 包装器
编辑

从 8.1.0 版本开始，APM 服务器支持的所有 Linux 发行版都支持 systemd。因此，APM 服务器不再附带 System V init 脚本或 go-daemon 包装器；请改用 systemd。

详情请参见 PR #7576。

已弃用 32 位架构
编辑

已弃用 APM 服务器对 32 位架构的支持，并将在未来的版本中删除。

8.1
编辑

APM 中没有重大更改。

8.0
编辑

APM 8.0 版本引入了以下重大变更：

索引现在由 Fleet 管理
编辑

所有索引管理都已从 APM 服务器中移除；Fleet 现在完全负责设置索引模板、索引生命周期策略和索引管道。

作为此更改的一部分，以下设置已被删除：

  • apm-server.ilm.*
  • apm-server.register.ingest.pipeline.*
  • setup.*
默认使用数据流
编辑

APM 服务器现在仅写入定义明确的数据流；不再支持写入经典索引。

作为此更改的一部分，以下设置已被删除：

  • apm-server.data_streams.enabled
  • output.elasticsearch.index
  • output.elasticsearch.indices
  • output.elasticsearch.pipeline
  • output.elasticsearch.pipelines
新的 Elasticsearch 输出
编辑

APM 服务器具有新的 Elasticsearch 输出实现；不再需要手动调整 APM 服务器的输出。

作为此更改的一部分，以下设置已被删除：

  • output.elasticsearch.bulk_max_size
  • output.elasticsearch.worker
  • queue.*
新的源映射上传端点
编辑

已从 APM 服务器中删除源映射上传端点。现在应直接将源映射上传到 Kibana。

已删除旧的 Jaeger 端点
编辑

已从 APM 服务器中删除旧的 Jaeger gRPC 和 HTTP 端点。

作为此更改的一部分，以下设置已被删除：

  • apm-server.jaeger
不再支持 Homebrew
编辑

APM 服务器不再支持通过 Homebrew 安装。

所有已删除和更改的设置
编辑

以下是将独立 APM 服务器升级到 Elastic Stack 8.0 版本时所有已删除的设置（按字母顺序排列）的列表。

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.*

以下是将独立 APM 服务器升级到 Elastic Stack 8.0 版本时已重命名的设置（按字母顺序排列）的列表。

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
支持的 Elastic Cloud 设置
编辑

以下是将 Elastic Cloud 独立集群升级到 Elastic Stack 8.0 版本时所有支持的设置（按字母顺序排列）的列表。升级时将删除下面未列出的任何先前支持的设置。

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
« APM 代理兼容性 升级到 8.16.0 版本 »