🪓

Cargo Lambda のログを JSON(Bunyan format) で出力する

2025/04/21に公開

内容

出力するログのフォーマットは JSON で出力すると便利なことが多い。
CloudWatchLogs なら Subscription filter を使って一定以上の Log Level のもののみを転送して通知するなどがやりやすいためである。

Bunyan format

{
  "v": 0,
  "name": "lambda",
  "msg": "information",
  "level": 30,
  "hostname": "Workstation",
  "pid": 4574,
  "time": "2025-04-20T17:21:57.31645104Z",
  "target": "lambda::handler",
  "line": 36,
  "file": "src/handler.rs"
}

ここでは Rust (Cargo Lambda) のログを Bunyan format で出力するように設定するやり方を記す。

使うのは tracing-bunyan-formatter というクレートである。

Cargo Lambda のデフォルトのログ出力

cargo lambda init で作成するとデフォルトのログが出力されるようになってはいる。
ログレベル次第だとは思うがログレベルをみたり他の情報をみるには少し見にくいし、ログの分析にも少し扱いずらそうである。

lambda_http::tracing::init_default_subscriber();
lambda_http::tracing::info!("information");

サンプルは lambda http なので watch して curl すれば実行できる。

cargo lambda watch

# 別タブから
curl http://localhost:9000/?log=info
curl http://localhost:9000/?log=warn
curl http://localhost:9000/?log=err
# curl http://localhost:9000/?log=panic

CWL などでも見たことがあるログが出ている。

INFO Lambda runtime invoke{requestId="d7f2cd28-5af6-49d5-92c8-1ad57b0a2357" xrayTraceId="Root=1-68053309-1dda0493af9111783fa5ffea;Parent=b46f7da2d955fd3e;Sampled=1"}: information

tracing-bunyan-formatter

設定

bunyan format を使うために以下のクレートを追加する。

cargo add \
  tracing \
  tracing-bunyan-formatter \
  tracing-subscriber

以下のように設定する。

ログが多い

上記の設定をすると lambda の Runtime のメッセージや hyper のログなどがすべて出るようになる。

それに JSON を確認してもらうとわかるが msg のキーに [LAMBDA RUNTIME INVOKE - EVENT] と細かいメッセージが出てくる。
これはわかりにくいので消したい。

{
  "v": 0,
  "name": "lambda",
  "msg": "[LAMBDA RUNTIME INVOKE - EVENT] information",
  "level": 30,
  "hostname": "Workstation",
  "pid": 4203,
  "time": "2025-04-20T15:19:32.133469183Z",
  "target": "lambda::handler",
  "line": 21,
  "file": "src/handler.rs",
  "requestId": "2f7a46dd-a83d-437f-ba4f-7872134f5d1b",
  "xrayTraceId": "Root=1-68051084-86a8c3c4beb90e7854b1ed7d;Parent=95c87aa30e621259;Sampled=1"
}

環境変数 RUST_LOG からログレベルを設定できるようにする。

[LAMBDA RUNTIME INVOKE - EVENT] は消したいので

.add_directive("lambda_runtime=warn".parse().unwrap());

としている。

これで info レベルのログは出力されなくなるため、[LAMBDA RUNTIME INVOKE - EVENT] などの冗長なメッセージを抑制できる。

ただ残念ながら [LAMBDA RUNTIME INVOKE - START] などのメッセージも出なくなるので自分で tracing::info! したほうがいいかもしれない。

また RUST_LOG から取らなくても

tracing_subscriber::filter::EnvFilter::try_from_default_env()

を使うこともできるのだが RUST_LOG が未定義だったりすると何も出力しなくなるのでサンプルでは明示的に

std::env::var("RUST_LOG")

をしたり、

.filter(|a| !a.is_empty())

で空文字ならデフォルトに流せるようにしている。

おまけ panic

panic したときも同じようなメッセージが流れるように hook しておく。

Runtime のエラーと被るのでそちらのほうは表示されないように無効化しておく。

まとめ

これですっきりとしたログ環境になったはずである。
出力されたログを上手く収集して、通知できるように設定できるといいのではなかろうか。

内容

Cargo Lambda のデフォルトのログ出力

tracing-bunyan-formatter

設定

ログが多い

おまけ panic

まとめ

Discussion