#metrics #cloud-watch #aws

metrics_cloudwatch

metrics crate的CloudWatch发射器

29个版本 (3个稳定版)

3.0.0 2024年6月10日
2.0.1 2023年8月24日
2.0.0 2023年2月3日
1.0.1 2023年1月9日
0.4.0 2020年3月18日

#710 in 网络编程

Download history 285/week @ 2024-04-23 166/week @ 2024-04-30 228/week @ 2024-05-07 320/week @ 2024-05-14 288/week @ 2024-05-21 340/week @ 2024-05-28 358/week @ 2024-06-04 172/week @ 2024-06-11 64/week @ 2024-06-18 196/week @ 2024-06-25 342/week @ 2024-07-02 79/week @ 2024-07-09 177/week @ 2024-07-16 204/week @ 2024-07-23 351/week @ 2024-07-30 181/week @ 2024-08-06

每月939次下载

MIT/Apache

48KB
1K SLoC

metrics_cloudwatch

Docs Build status

目的

metrics外观crate提供后端,将指标推送到CloudWatch。

如何使用

AWS凭证需要可在环境中使用,请参阅AWS文档中的AWS凭证设置

cargo add -s metrics metrics_cloudwatch
fn main() {
    // Initialize the backend
    metrics_cloudwatch::builder()
        .cloudwatch_namespace("my-namespace")
        .init_thread()
        .unwrap();

    metrics::counter!("requests", 1);
}

指定的任何标签将映射到Cloudwatch维度

metrics::histogram!("histogram", 100.0, "dimension_name" => "dimension_value");

对于值指定为空字符串,将删除具有相同名称的指标的默认维度。

metrics::histogram!("histogram", 100.0, "dimension_name" => "");

特殊的@unit标签接受一个metrics_cloudwatch::Unit,该标签指定指标的单元(在注册指标时也可以指定单元)。其他以@前缀的标签将被忽略。

metrics::histogram!("histogram", 100.0, "@unit" => metrics_cloudwatch::Unit::Seconds);

限制

CloudWatch指标API施加了一些限制。

  • 每个指标最多30个标签(维度)
  • 每个API调用最多150个唯一的直方图值(由timing!()value!()使用)。

依赖项

~24MB
~426K SLoC