从旧版本的 Application Insights JavaScript SDK 升级

升级到 Application Insights JavaScript SDK 的新版本可提供多种优势，例如：

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

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 生产环境 SDK（1.0.20），并希望查看新的 SDK 是否在运行时能够正常运作，请根据您当前的 SDK 加载方案来更新 URL。

• 通过 CDN 场景下载：请更新您当前使用的 JavaScript（Web）SDK 加载程序脚本，使其指向以下 URL：

  "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 并在生产环境中部署。

后续步骤

• 若要了解有关 JavaScript SDK 的详细信息，请参阅 Application Insights JavaScript SDK 文档。
• 若要了解 Log Analytics 中的 Kusto 查询语言和查询数据，请参阅 日志查询概述。