Metriki

Metriki 是从 Dropwizard Metrics 源码移植的 Rust 库。

与 Dropwizard Metrics 类似，Metriki 在客户端聚合指标，并输出有限的数据。

快速开始

// create a timer to track the execution rate and latency of this function
// to use macros you will need to turn on `macros` feature of metriki_core
#[timed]
fn your_function() {
  // a function metered by a timer for its rate and latency
}

use metriki_core::global::global_registry;
use metriki_influxdb_reporter::InfluxDbReporterBuilder;

// by default, the timer is registered in this global_registry()
let registry = global_registry();

// start a reporter to send data into influxdb
InfluxDbReporterBuilder::default()
    .url("localhost:8086")
    .username(String::from("influxdbuser"))
    .password(String::from("yourpassword"))
    .database("db")
    .registry(registry.clone())
    .build()
    .unwrap()
    .start();

组件

• Metrics (文档) (crate)
• 报告器/导出器
  • logger (文档) (crate)
  • influxdb (文档) (crate)
  • riemann (文档) (crate)
  • prometheus (文档) (crate)
  • statsd (文档) (crate)
• 仪器
  • jemalloc: 跟踪 jemalloc 统计 (文档) (crate).
  • tracing: 跟踪订阅层 (文档) (crate).
  • tower + hyper: metriki 集成用 tower 层 (文档) (crate).
  • warp: warp 中间件注入 metriki MetricsRegistry (文档) (crate).
  • r2d2: 监控数据库连接使用情况 (文档) (crate).
  • tokio: 使用 tokio_metrics 监控 tokio 内部 (文档) (crate).

概念

指标

• 计数器: 可增加和减少的值。
• 度量器: 测量事件速率。
• 直方图: 记录数据随时间分布。
• 计时器: 度量器和直方图的组合。
• 仪表: 当被查询时提供值的函数。

MetricsRegistry

所有指标的人口和持有者。

MetricsSet

实现一个特性，以便将动态指标添加到注册表中。每次报告器和导出器从注册表中拉取值时，都会从集合中拉取指标。

报告器

一个组件，用于定期报告指标数据。通常用于具有推送模式的数据库。

导出器

一个组件，用于将指标数据暴露给外部查询器。通常用于基于拉取的数据数据库。

许可证

MIT/Apache-2.0