SuperAPI AI 工具集

applicationinsights-web-ts

通用与其它

查看项目

更新于 10-16 05:51

技能介绍

用途:在浏览器/Web 代码(含 React Native)中接入 @microsoft/applicationinsights-web 实现真实用户监控(RUM),自动采集页面浏览、AJAX/fetch 依赖、未处理异常,配合点击分析插件可采集点击;支持自定义事件、指标及遵循 OpenTelemetry GenAI 语义约定的智能体追踪,通过 W3C Trace Context 与后端 span 关联。不适用于 Node.js 服务端(应使用 azure-monitor-opentelemetry-ts)。

主要能力:核心 SDK 负责页面浏览、AJAX、异常;可选插件涵盖点击分析、React、React Native、Angular、调试插件与 User Timing 集成。支持自动 SPA 路由追踪(enableAutoRouteTracking)、CORS 关联、分布式追踪模式 2、用户身份设置、遥测初始化器做富化与过滤、Web Vitals 自定义指标、GenAI 智能体的 invoke_agent/chat/execute_tool 等操作追踪。

使用方式:安装 npm i --save @microsoft/applicationinsights-web(按需安装插件,类型定义随包提供)。初始化需连接字符串,浏览器端以明文下发,不支持 Microsoft Entra ID 认证;可通过 VITE_/NEXT_PUBLIC_ 前缀注入。创建 ApplicationInsights 实例后调用 loadAppInsights()(仅一次且尽早),再 trackPageView()。也可使用 SDK Loader 脚本。常用 API 包括 trackEvent、trackException、trackTrace、trackMetric、trackDependencyData、setAuthenticatedUserContext、flush 等。

适用场景与限制:适用于需要浏览器端 RUM、前后端链路关联及客户端 GenAI 追踪的应用。限制:连接字符串对客户端可见,需隔离资源;敏感内容属性默认不采集,需运行时开关控制并评估数据处理合规;用户身份值为 PII,不应传邮箱。