重大更改

编辑

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

8.11
编辑

以下是在 APM 版本 8.11.0 中引入的重大更改

  • ecs.version 字段已从 APM 数据流中删除。此更改不应影响大多数用户,因为 APM UI 不使用此字段。有关更多详细信息,请参阅 PR #11632
8.10
编辑

以下是在 APM 版本 8.10.0 中引入的重大更改

  • 聚合指标现在将全局标签视为服务标识的一部分,高基数全局标签可能会导致服务被遮挡。有关更多详细信息,请参阅 PR #11386
  • 基于尾部的采样的事件 protobuf 编码更改为更高效的事件时间戳和持续时间编码。有关更多详细信息,请参阅 PR #11386

以下是在 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
  • 停止将 span 目标指标索引到 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

以下是在 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

以下是在 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 位架构
编辑

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

APM 中没有重大更改。

以下是在 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