これは開発版のドキュメントである. 内容は次のリリースまでに変更される可能性がある. 最新のリリース版は 0.14.x を参照.
ログ出力
ライブラリのログは tracing crate を用いて出力される.
Rust ではライブラリはログの初期化 API を持たないので, tracing-subscriber などで初期化する.
Python / C# にはログ初期化用の init_tracing が用意されている.
tracing_subscriber::fmt() .with_env_filter( EnvFilter::try_from_default_env().unwrap_or_else(|_| EnvFilter::new("info")), ) .init();log_guard = init_tracing( default_filter="info", writer=LogWriter.Stdout,)var option = new TracingOption{ DefaultFilter = "info", Writer = LogWriter.Stdout,};using var logGuard = Tracing.Init(option);Python / C# の init_tracing は guard を返す.
guard をプログラムの終わりまで保持すること.
TracingOption (Python / C#)
Section titled “TracingOption (Python / C#)”| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
default_filter |
&'static str |
"info" |
環境変数 RUST_LOG が無いときに使うフィルタ |
writer |
LogWriter |
Stdout |
出力先. LogWriter::Stdout / LogWriter::Stderr |
環境変数 RUST_LOG が設定されていれば, default_filter よりそちらが優先される.