重大变更
编辑重大变更编辑
本节介绍此版本和之前的次要版本中引入的重大变更和弃用。
8.11编辑
APM 8.11.0 版本引入了以下重大变更
- 已从 APM 数据流中删除
ecs.version
字段。此变更不会影响大多数用户,因为 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。 - 已停止将跨度目标指标索引到
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 位架构编辑
已弃用对 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