›

升级到 v1.x

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

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

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

术语“应用”以前用于描述您与 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()`	重命名以符合新的命名约定