›

升级到 v1.x

升级到 v1.x编辑

以下是从版本 0.x 升级 Node.js 代理到版本 1.x 的指南。

Node.js 代理版本 1.x 需要 APM 服务器版本 6.2 或更高版本。

术语“跟踪”以前用于描述代理在事务期间检测到的一小部分工作。为了与现代 APM 供应商保持一致，我们现在将其称为“跨度”。

术语“应用”以前用于描述与 Elastic APM 相关的 Node.js 应用程序。为了更加具体，我们现在将其称为“服务”。

以下配置选项已在版本 1.0.0 中移除

名称	备注
`logBody`	请改用 `captureBody`。请注意，此选项不是布尔值

以下配置选项已在版本 0.x 和 1.x 之间重命名。

每个重命名的配置选项的相关联环境变量也已相应地重命名。

旧名称	新名称	备注
`appName`	`serviceName`	重命名以与新的命名约定保持一致
`appVersion`	`serviceVersion`	重命名以与新的命名约定保持一致
`captureTraceStackTrace`	`captureSpanStackTraces`	重命名以与新的命名约定保持一致
`sourceContextErrorAppFrames`	`sourceLinesErrorAppFrames`	重命名以与其他代理保持一致
`sourceContextSpanAppFrames`	`sourceLinesSpanAppFrames`	重命名以与其他代理保持一致
`sourceContextErrorLibraryFrames`	`sourceLinesErrorLibraryFrames`	重命名以与其他代理保持一致
`sourceContextSpanLibraryFrames`	`sourceLinesSpanLibraryFrames`	重命名以与其他代理保持一致
`validateServerCert`	`verifyServerCert`	重命名以与其他代理保持一致

以下函数已在版本 0.x 和 1.x 之间重命名

旧名称	新名称	备注
`buildTrace()`	`buildSpan()`	重命名以与新的命名约定保持一致