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

升级到 5.x 版本

编辑

升级到 5.x 版本编辑

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

5.0 重大更改编辑

代理名称更改为 rum-js

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

官方 W3C tracecontext 支持

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

addTags 替换为 `addLabels

已弃用 4.1 版本中的 addTags，并将其替换为 addLabels，后者支持字符串、布尔值和数字

单队列处理

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

已移除的选项

  • errorThrottleLimit
  • errorThrottleInterval
  • transactionThrottleLimit
  • transactionThrottleInterval

新增选项

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

升级步骤编辑

升级 APM 服务器编辑

5.x 版本的 RUM 代理需要 APM 服务器版本 >= 7.0。APM 服务器 7.0 升级指南 可以帮助您完成升级过程。

APM 服务器版本 >= 7.0 还需要 Elasticsearch 和 Kibana 版本 >= 7.0。

升级后端代理编辑

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

代理名称 代理版本

Go 代理

>= 1.6

Java 代理

>= 1.14

.NET 代理

>= 1.3

Node.js 代理

>= 3.4

Python 代理

>= 5.4

Ruby 代理

>= 3.5

升级 RUM 代理编辑

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

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

已移除的配置

« 升级 发行说明 »