介绍
@newrelic/superagent
是 Node.js 和浏览器中的 HTTP 客户端库 superagent 的扩展版,它与 New Relic 的监控软件集成,以便帮助开发人员进行应用性能监控和故障排查。
本文将介绍如何使用 @newrelic/superagent
执行 HTTP 请求,同时介绍如何将其与 New Relic 集成。
安装
首先,您需要安装 @newrelic/superagent
包,可以使用以下命令进行安装:
npm install @newrelic/superagent
使用
一旦安装成功,您可以在项目中引入依赖:
const superagent = require('superagent'); const newrelic = require('newrelic'); require('@newrelic/superagent');
现在,在 HTTP 请求中添加 newrelic
-Headers 即可将请求关联到 New Relic 的事务中:
superagent.get('https://api.example.com') .set('newrelic', true) .end((err, res) => { if (err) { console.log(err); } console.log(res.body); });
在这个示例中,我们创建了一个 GET 请求,并将 newrelic
设置为 Header。这会将请求关联到 New Relic 的事务中。
集成
在默认情况下,New Relic 会自动捕捉 superagent 的事务。但是,如果您希望更自定义地控制集成,则可以使用自定义 instrumentation。
例如,在一个表单提交之前,我们可能想捕捉表单的数据并将其纪录在事务中。
以下是使用 newrelic
包的实例代码:
-- -------------------- ---- ------- -- ------- ---- --- ------- --- -------- ----- ------- - --------------------- -- -- ---- -------- -- ------ ------------- -- - ------ ------ ---- --------- ---- ---- ----- --------------- - - ----- ----------------- -------- -- ----- ----------- - -------------------------- -- --- --- ------- -- --- ------------- ------ ----- ------------------------------------------------ ----------------- -- ------ --- ---- ----- ----------- ------------------------------ -------------- ---------------- ----- ---------- ---- -- - -- ----- - ----------------- - ---------------------- ---
在这个示例中,我们创建一个名为 FormSubmission
的自定义事务,并将表单数据作为 payload 发送给 New Relic。我们还收取当前 newrelic
事务,并添加表单数据到 custom attributes 中。
总结
@newrelic/superagent
提供了与 New Relic 集成的功能,让开发人员能够将 HTTP 请求与 New Relic 的监控平台进行整合,从而更好地进行性能监控和故障排查。
在本文中,我们介绍了如何安装、使用和集成 @newrelic/superagent
包,希望这对于您的前端项目有所帮助。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/5eedb90fb5cbfe1ea0611874