29个版本 (3个稳定版)
3.0.0 | 2024年6月10日 |
---|---|
2.0.1 | 2023年8月24日 |
2.0.0 | 2023年2月3日 |
1.0.1 |
|
0.4.0 | 2020年3月18日 |
#710 in 网络编程
每月939次下载
48KB
1K SLoC
metrics_cloudwatch
目的
为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