Rust カスタムメトリクス
関連イベント
- Tue 10 Nov · 09:00 – 11:00 UTC · Online
- Tue 24 Nov · 15:00 – 16:00 UTC · Online
概要
AWS SDK for Rust を使用して、Rust アプリケーションからカスタム CloudWatch メトリクスを公開します。このソリューションでは、3 つのアプローチを紹介します:直接的な PutMetricData API 呼び出し、メトリクスフィルターを使用した PutLogEvents、および CloudWatch Embedded Metric Format(EMF)を使用した PutLogEvents です。各アプローチには、カーディナリティ、セットアップの複雑さ、およびコストに関する異なるトレードオフがあります。
前提条件
- Rust ツールチェーンがインストールされていること:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh - 認証情報が設定された AWS CLI(
aws configure) cloudwatch:PutMetricDataおよびlogs:PutLogEventsの IAM 権限- CloudWatch ロググループとログストリーム:
aws logs create-log-group --log-group-name rust_custom
aws logs create-log-stream --log-group-name rust_custom --log-stream-name diceroll_log_stream
アーキテクチャ
┌──────────────────┐ PutMetricData ┌──────────────────┐
│ Rust Application│────────────────────────▶│ CloudWatch │
│ │ PutLogEvents (EMF) │ Metrics │
│ │────────────────────────▶│ │
│ │ PutLogEvents │ CloudWatch Logs │
│ │────────────────────────▶│ + Metric Filter │
└──────────────────┘ └──────────────────┘
デプロイ
PutMetricData
最も直接的なアプローチ — 時系列値を CloudWatch Metrics に直接書き込みます。
async fn put_metric_data(roll_value: i32) -> Result<(), cloudwatch::Error> {
//Create a reusable aws config that we can pass to our clients
let config = aws_config::load_defaults(BehaviorVersion::v2023_11_09()).await;
//Create a cloudwatch client
let client = cloudwatch::Client::new(&config);
//Use fluent builders to build the required input for pmd call, starting with dimensions.
let dimensions = Dimension::builder()
.name("roll_value_pmd_dimension")
.value(roll_value.to_string())
.build();
let put_metric_data_input = MetricDatum::builder()
.metric_name("roll_value_pmd")
.dimensions(dimensions)
.value(f64::from(roll_value))
.build();
let response = client
.put_metric_data()
.namespace("rust_custom_metrics")
.metric_data(put_metric_data_input)
.send()
.await?;
println!("Metric Submitted: {:?}", response);
Ok(())
}