metrical

为Rust设计的Graphite和Statsd度量聚合客户端

metrical使得从Rust服务中添加和跟踪度量变得容易。

metrical支持以下三种协议

• Statsd（文本）
• Graphite（未压缩）
• Graphite压缩（pickle）

此外，metrical可以通过UDP或TCP发送度量。

入门

metrical启动起来相当简单。要配置metrical，您可以使用辅助函数 metrical::from_env，或者直接通过 ConfigurationBuilder 创建配置，并使用配置调用 metrical::from_config。

之后，您可以使用 metrical::counter、metrical::gauge 和 metrical::timer 分别轻松创建计数器、度量或计时器。

寻求帮助

请随时通过[email protected]给我发邮件。

许可证

本项目采用MIT开源许可证

环境变量

要使用环境变量配置库，以下环境变量被使用

• METRICAL_NETWORK_PROTOCOL - [UDP|TCP]
• METRICAL_NETWORK_DESTINATION - (ip_address:port) 或 (ip_address)
• METRICAL_SEND_METHOD - [StatsD|Graphite|Graphite_pickle]
• METRICAL_NAMESPACE - 一个路径，用于将所有创建的度量放在其下。形式为 foo.myBar.baz。
• METRICAL_FLUSH_INTERVAL - 在刷新度量缓冲区之前的时间间隔（以秒为单位）。
• METRICAL_FLUSH_AMOUNT - 任何一次存储在度量缓冲区中的最大记录数。

此外，可以使用前缀与环境变量一起使用。例如，如果使用前缀 MY_PROJ，则将在 MY_PROJ_METRICAL_NETWORK_PROTOCOL 下查找 METRICAL_NETWORK_PROTOCOL 环境变量。