升级到 v3.x
编辑升级到 v3.x编辑
以下是将 Node.js 代理从版本 2.x 升级到版本 3.x 的指南。
概述编辑
Node.js 代理 3.0.0 版本支持 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。