重大变更编辑

本节介绍此版本和之前的次要版本中引入的重大变更和弃用。

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 Server 默认主机更改为 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.idobserver.ephemeral_id 已删除编辑

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

有关更多详细信息,请参阅 PR #9412

timeseries.instance 已删除编辑

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

有关更多详细信息,请参阅 PR #9565

8.2编辑

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

APM Server 现在使用 event.duration 发出事件编辑

APM Server 不再使用 transaction.duration.usspan.duration.us 发出事件。相反,事件使用 event.duration 发出。摄取管道设置旧版 <event>.duration.us 字段并删除 event.duration

此变更将影响未使用 APM Server 的 Elasticsearch 输出或打包摄取管道的用户。有关详细信息,请参阅 PR #7261

已删除 observer.version_major编辑

字段 observer.version_major 是非标准的,并且仅存在于 APM UI 中以过滤掉旧版文档(版本 <7.0)。不再执行此检查,因此该字段已被删除。

有关详细信息,请参阅 PR #7399

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

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

有关详细信息,请参阅 PR #7576

已弃用 32 位架构编辑

已弃用对 32 位架构的 APM Server 支持,并将在未来版本中删除。

8.1编辑

APM 中没有重大变更。

8.0编辑

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

索引现在由 Fleet 管理编辑

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

作为此变更的一部分,已删除以下设置

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

APM Server 现在仅写入定义良好的数据流;不再支持写入经典索引。

作为此变更的一部分,已删除以下设置

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

APM Server 有一个新的 Elasticsearch 输出实现;不再需要手动调整 APM Server 的输出。

作为此变更的一部分,已删除以下设置

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

源映射上传端点已从 APM Server 中删除。源映射现在应该直接上传到 Kibana。

旧版 Jaeger 端点已被删除编辑

旧版 Jaeger gRPC 和 HTTP 端点已从 APM Server 中删除。

作为此变更的一部分,已删除以下设置

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

APM Server 不再支持通过 Homebrew 安装。

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

以下是将独立 APM Server 升级到 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 Server 升级到 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