使用英语阅读

通过


你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

从旧版本的 Application Insights JavaScript SDK 升级

升级到新版本的 Application Insights JavaScript SDK 可以提供几个好处,例如:

  • 改进了性能和 bug 修复
  • 新特性和功能
  • 更好地与其他技术兼容
  • 增强了安全性和数据隐私

SDK V2 版本中的重大更改:

  • 为了让用户生成更好的 API 签名,某些 API 调用(例如 trackPageView 和 trackException)已更新。 不支持在 Internet Explorer 8 和早期版本的浏览器中运行。

  • 由于数据架构更新,遥测信封的字段名称和结构已更改。

  • 已将 context.operation 转移到 context.telemetryTrace。 此外还更改了一些字段 (operation.id -->telemetryTrace.traceID)。

    若要手动刷新当前页面视图 ID(例如,在单页应用程序中),请使用 appInsights.properties.context.telemetryTrace.traceID = Microsoft.ApplicationInsights.Telemetry.Util.generateW3CId()

    备注

    为了使跟踪 ID 独一无二,现在使用 Util.generateW3CId(),以前使用 Util.newId()。 二者最终都会成为操作 ID。

如果你正在使用最新的 Application Insights PRODUCTION SDK (1.0.20),并想要查看新 SDK 是否可在运行时中正常工作,请根据当前的 SDK 加载方案更新 URL。

  • “通过 CDN 下载”方案:更新当前用于指向下列 URL 的 JavaScript (Web) SDK 加载程序脚本:

    "https://js.monitor.azure.com/scripts/b/ai.3.gbl.min.js"
    
  • npm 方案:调用 downloadAndSetup 以从 CDN 下载完整的 ApplicationInsights 脚本,并使用连接字符串将其初始化:

    appInsights.downloadAndSetup({
       connectionString: "Copy connection string from Application Insights Resource Overview",
       url: "https://js.monitor.azure.com/scripts/b/ai.3.gbl.min.js"
       });
    

在内部环境中进行测试,以验证是否可按预期方式监视遥测。 如果一切正常,请相应地将 API 签名更新为 SDK v2,并部署到生产环境中。

后续步骤