« 升级 发行说明 »
Elastic 文档 › ›升级

升级到 5.x 版本

编辑

升级到 5.x 版本

编辑

从 4.x 版本升级到 RUM Agent 的 5.x 版本会引入一些重大更改。本指南概述了这些更改以及升级所需的步骤。

5.0 重大更改

编辑

代理名称更改为 rum-js

代理名称已更改为 rum-js。由于 Kibana 中旧版本的 APM 应用程序无法识别此新名称，因此您可能需要升级 Elastic Stack 版本。

官方 W3C tracecontext 支持

RUM Agent 支持官方 W3C tracecontext traceparent 标头，而不是以前使用的 elastic-apm-traceparent 标头。如果您使用 Elastic 后端代理，则必须将其升级到也支持官方 W3C tracecontext 标头的版本。

addTags 被 `addLabels 替换

addTags（在 4.1 版本中已弃用）已被移除，并替换为 addLabels，后者支持字符串、布尔值和数字

单队列处理

现在使用单个队列来处理所有事件（事务、错误等）。此更改允许将四个配置选项合并为一个。

已移除的选项

  • errorThrottleLimit
  • errorThrottleInterval
  • transactionThrottleLimit
  • transactionThrottleInterval

已添加的选项

  • eventsLimit — 配置每分钟发送到 APM Server 的事件数。默认为 80。

升级步骤

编辑

升级 APM Server

编辑

5.x 版本的 RUM Agent 需要 APM Server 版本 >= 7.0。APM Server 7.0 升级指南 可以帮助您完成升级过程。

APM Server 版本 >= 7.0 也需要 Elasticsearch 和 Kibana 版本 >= 7.0。

升级后端代理

编辑

所有 Elastic APM 代理都已升级以支持 RUM Agent 中的更改。您必须将后端代理升级到下面列出的最低版本，才能使所有功能正常工作。

代理名称 代理版本

Go 代理

>= 1.6

Java 代理

>= 1.14

.NET 代理

>= 1.3

Node.js 代理

>= 3.4

Python 代理

>= 5.4

Ruby 代理

>= 3.5

升级 RUM 代理

编辑

使用您 首选的安装方法 更新或下载最新版本的 RUM 代理。

如果您的旧配置使用了其中一个已移除的配置选项（如下所示），请更新您的配置以改用新的配置选项。

已移除的配置

« 升级 发行说明 »