你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
从旧版本的 Application Insights JavaScript SDK 升级
升级到新版本的 Application Insights JavaScript SDK 可以提供几个好处,例如:
- 改进了性能和 bug 修复
- 新特性和功能
- 更好地与其他技术兼容
- 增强了安全性和数据隐私
为了让用户生成更好的 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,并部署到生产环境中。
- 若要详细了解 JavaScript SDK,请参阅 Application Insights JavaScript SDK 文档。
- 若要了解 Kusto 查询语言和 Log Analytics 中的查询数据,请参阅日志查询概述。