升级到 v3.x
编辑升级到 v3.x
编辑以下是将您的 Node.js 代理从 2.x 版本升级到 3.x 版本的指南。
概述
编辑3.0.0 版本的 Node.js 代理支持 Node.js v8（从 v8.6.0 及更高版本）、v10 和 v12。
配置选项
编辑如果给定值 http 和/或 https，则 disableInstrumentations 配置选项的行为现在有所不同。以前，这将禁用对传入和传出请求的跟踪。现在，此配置选项仅处理传出请求。要禁用对传入 http(s) 请求的跟踪，请使用新的 instrumentIncomingHTTPRequests 配置选项。
现在，即使将 instrument 配置选项设置为 false，也可以使用手动检测。这意味着即使 instrument 设置为 false，对例如 apm.startTransaction() 或 apm.startSpan() 的调用也将生成事务和跨度。
API 更改
编辑与事务和跨度关联的 type 不再是点分隔的。而是将 type 属性拆分为三个不同的属性：type、subtype 和 action。这导致以下 API 发生更改
-
apm.startTransaction()：函数参数已更改 -
apm.startSpan()：函数参数已更改 -
transaction.startSpan()：函数参数已更改 -
transaction.type：字符串格式已更改 -
span.type：字符串格式已更改
已删除以下已弃用的 API：
-
apm.setTag()：已替换为apm.setLabel() -
apm.addTags()：已替换为apm.addLabels() -
transaction.setTag()：已替换为transaction.setLabel() -
transaction.addTags()：已替换为transaction.addLabels() -
span.setTag()：已替换为span.setLabel() -
span.addTags()：已替换为span.addLabels()
收集数据的更改
编辑在检测由 apollo-server-express 运行的 GraphQL 服务器时，事务类型现在为 graphql，而不是 request。
以前类型为 ext 的所有跨度现在为 external。