1. 什么是 measured-core？
measured-core 是一个用来构建度量指标数据集的 JavaScript 库，它可以帮助前端开发者监控和分析自己的网站或应用程序的性能和稳定性。通过一个简单的 API，你可以收集任何你关心的度量指标数据。该库适用于大多数浏览器、Node.js 和 Electron 应用。Measured-core 许可证为 Apache 2.0。
2. measured-core 的特点
- 统计计数器、计时器、统计直方图和分位数等指标。
- 可以进行度量指标数据采样和归档等操作。
- 可以通过采样的数据生成图表，方便数据可视化。
- 可以将数据导出到其他系统，例如 StatsD、InfluxDB 和 Graphite 等。
- 可以自定义数据格式和采样策略，根据需要进行拓展或调整。
- 支持多种系统和框架，包括 Express、Koa、Hapi、KrakenJS 等。
3. 如何使用 measured-core？
你可以通过 npm 安装 measured-core。
npm install measured-core
3.1 创建指标数据集
要创建一个指标数据集，需要使用 measured-core 库提供的 MetricRegistry 类。每个数据集与一个注册表对象关联。在创建一个指标时，需要使用指标类型创建一个 Meter、Timer、Histogram 或一个 Reservoir，并使用该指标的名称将其添加到 MetricRegistry。
-- -------------------- ---- ------- ------ - --------------- ------- ------- ----------- ---------- - ---- ---------------- ----- -------- - --- ----------------- ----- ----- - --- --------------- ------------------------ ------- ----- ----- - --- --------------- ------------------------ ------- ----- --------- - --- ------------------------ ------------------------------- ---------------------------- -----------展开代码
3.2 记录指标数据
调用 Metric 类的相应方法可以记录数据，例如：
meter.mark(1); timer.record(50); histogram.update(20);
3.3 获取指标数据
你可以使用 registry.getMetrics() 获取注册表中的所有指标数据。此方法返回的对象包含按名称组织的指标数据。你还可以通过名称访问指定的指标，并使用该指标公开的方法获取数据。例如：
const metrics = registry.getMetrics(); const meter = registry.get("my_meter"); const count = meter.getCount();
3.4 生成度量指标数据采样和归档
你可以使用 MetricRegistry 对象提供的转储 API 定期将度量指标数据转储到其他系统中。该库支持的传输协议包括 StatsD、InfluxDB 和 Graphite 等。你还可以使用转储程序的 API 自定义数据格式和采样策略。
-- -------------------- ---- ------- ------ - --------------- ------------ ------------- - ---- --------------------- ----- -------- - --- ------------------------- ----- ----------- - --- -------------- ------------------------------ ----- ------------ - --- ------------------------------------- ------------------------------- --------------------- -- - - ----------- ------展开代码
3.5 示例代码
以下是一个完整的示例代码，它将您的应用程序的请求计数和请求处理时间记录在度量数据集中，并将数据转储到控制台和 Graphite。
-- -------------------- ---- ------- ------ - --------------- ------- ------- - ---- ---------------- ------ - --------------- ------------ ------------- - ---- --------------------- ----- -------- - --- ----------------- ----- ------------ - --- --------------- ------------------------ -------------- ----- ------------ - --- --------------- ----------------------------- -------------- ----- -------- - --- ------------------------- ----- ----------- - --- -------------- ------------------------------ ----- ------------ - --- ------------------------------------- ------------------------------- --------------------- -- - - ----------- ------ -- --------- ------ --------- ------------- ---- ----- -- - -------------------- -- ----- ----- ----- - ----------- ---------------- -- -- - ----- --- - ----------- ----- -------- - --- - ------ ------------------------------ -- -------- --- ------- ---展开代码
4. 总结
Measured-core 是一个功能强大且易于使用的库，使开发者可以轻松地收集、存储和传输度量指标数据，帮助前端开发者监控和分析网站或应用程序的性能和稳定性。无论您是在基于浏览器的前端应用程序、Node.js 应用程序还是 Electron 应用程序的开发方面，都可以从 measured-core 中获得益处。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/150149
