在现代 web 应用程序里,性能和错误追踪非常重要。为了达到这个目的,开发者经常使用工具来记录应用程序的行为。Microsoft 的 Application Insights 是一个流行的选择,它是由 Microsoft 提供的应用程序监视和追踪工具。本文将介绍 npm 包 @microsoft/applicationinsights-core-js,并给出使用教程,以帮助开发者在应用程序中使用 Application Insights。
什么是 @microsoft/applicationinsights-core-js?
@microsoft/applicationinsights-core-js 是一个纯 JavaScript 应用程序监视和追踪工具包。它是 Application Insights 的核心部分,可以记录 JavaScript 应用程序在客户端事件和跨域请求等方面的表现。这个包还可以通过插件机制来支持更多功能和平台。比如,它可以和 React、Angular、Vue 等框架集成,实现对框架应用程序的监控和追踪。
如何安装和使用?
首先,我们需要使用 npm 包管理器安装 @microsoft/applicationinsights-core-js。在终端里输入以下命令:
npm i @microsoft/applicationinsights-core-js
接着,在 JavaScript 文件里引入这个包:
-- -------------------- ---- ------- ------ - -------------------- ----------------- ---------------- ---------------- ------------- - ---- ----------------------------------------- -- --- ----------- -------- --- ----------- - --- --------------------- ------- ------------------- ----- --- ----------------- --- ------------------------------展开代码
在这个例子里,我们创建了一个 ApplicationInsights 的实例,然后调用了 loadAppInsights 方法来初始化它。这个实例会自动记录客户端事件和错误,以及其他一些基本信息。
不过,通常情况下,我们需要自定义这个实例来满足应用程序的特殊需求。比如,我们想为不同类型的事件定义不同的名称和属性集。针对这种情况,@microsoft/applicationinsights-core-js 提供了丰富的 API 和插件机制。下面的代码片段展示了如何满足这个需求:
-- -------------------- ---- ------- -- ------------------ ----- ----------------- - ---------------- ----- ----------- - -------- ----- ----------- - -------- -- --------------- ----- ----------------- - ------------- - --------------- - -------------------- - -------- - ----- ---------- - --------------------- ----------------- --------- -------- ------- - - -- -------------- --- ------------------ - -- --------- ---------------------- ----------------- - ------------ ------------- - - --------- - ----- ------------------ ----------- - -------------- --------- -------------- -------- -- ------------- -- - -- - -- ------- ------------------ ------ ------------------------------------ --------- - - -- - ----------- -------- ------- ------------------------------ --------------------- -- ------- ------------------------ ----- ----------------- ---展开代码
这个例子里,我们创建了一个叫 CustomEventPlugin 的插件,通过重写 processTelemetry 方法,实现了对 CustomEvent 的特殊处理。我们还通过 addPlugin 方法,把这个插件添加到 Application Insights 实例里。
最后,我们用 trackEvent 方法,发送了一个自定义事件。这个事件会被 CustomEventPlugin 插件拦截,打印出相应的日志,并加上自定义的属性集。
总结
@microsoft/applicationinsights-core-js 是一个很强大的 JavaScript 应用程序监视和追踪工具包。它可以让我们方便地记录应用程序的行为,并提供丰富的 API 和插件机制,以适应不同类型和规模的应用程序。本文介绍了这个包的基本使用方法和一个自定义事件处理的示例。希望读者通过这篇文章,可以更好地使用 Application Insights,优化应用程序性能和可靠性。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/5eedabf5b5cbfe1ea06108ea