简介
ibmapm-embed 是一个用于 IBM Cloud Application Performance Management (APM) 的 npm 包,可以在前端应用中集成 APM 监控功能。通过该包,我们可以方便地在前端应用程序中收集性能统计数据,并将其发送到 IBM APM 服务进行分析和监控。
安装
要安装 ibmapm-embed,首先需要安装 Node.js 和 npm。然后,在项目的根目录下运行以下命令来安装 ibmapm-embed:
npm install ibmapm-embed --save
配置
为了使用 ibmapm-embed,我们需要提供一些配置信息。具体来说,我们需要提供以下信息:
- APM 代理地址(如:https://apm.example.com/mum)
- 应用程序名称
- 身份验证令牌
这些信息通常可以在 IBM Cloud 控制台上找到。一旦您拥有这些信息,请按照以下方式创建一个新的 ApmEmbed 对象:
import { ApmEmbed } from 'ibmapm-embed'; const apm = new ApmEmbed({ collectorUrl: 'https://apm.example.com/mum', appName: 'my-app', token: '<your-token>', });
监控
在完成配置后,我们就可以开始收集性能统计数据了。以下是一些主要的 API:
startTransaction(name: string): void
此函数用于启动一个新的事务。在一个事务中,您可以记录多个跟踪点,并将它们一起提交到 APM 代理进行处理。
apm.startTransaction('my-transaction');
startSpan(name: string): void
此函数用于启动一个新的跟踪点。跟踪点是一个与事务相关联的时间范围,在该时间范围内记录的数据将被发送到 APM 代理。
apm.startSpan('my-span');
end(): void
此函数用于结束当前的跟踪点或事务。
apm.end();
示例代码
以下是一个基本示例,演示如何使用 ibmapm-embed 进行性能监控。
-- -------------------- ---- ------- ------ - -------- - ---- --------------- ----- --- - --- ---------- ------------- ------------------------------ -------- --------- ------ --------------- --- -- ----- - --- ----------- --------------------------------------- -- ----- - --- ---- ---------------------------- -- -- ---- ---- ------- -------------- -------------- -- ---------------- ---------- -- - -- --- --- ------------ ---- ---------- -- -- ---- ---- ---- ------- --- -- --- --- ----------- ----------展开代码
总结
通过了解 ibmapm-embed 的使用方法,我们可以方便地在前端应用程序中实现 APM 监控功能。这对于诊断应用程序性能问题、查找性能瓶颈以及优化应用程序性能非常有帮助。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/53396