你当前正在访问 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，并部署到生产环境中。

后续步骤