重大更改
编辑重大更改
编辑本节介绍此版本和之前的次要版本中引入的重大更改和弃用。
8.11
编辑以下是在 APM 版本 8.11.0 中引入的重大更改
ecs.version
字段已从 APM 数据流中删除。此更改不应影响大多数用户,因为 APM UI 不使用此字段。有关更多详细信息,请参阅 PR #11632
8.10
编辑以下是在 APM 版本 8.10.0 中引入的重大更改
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。 - 停止将 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。
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 Server 现在发出带有 event.duration
的事件
编辑APM Server 不再发出带有 transaction.duration.us
或 span.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 位架构的支持已弃用,将在未来的版本中删除。
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