Spring との違い

spring_boot_starter_logging は、Logback を使う Spring Boot のロギングに従っています。同じ logging.* プロパティ、同じデフォルトの行、Logback のパターン構文です。このページでは、そうでない箇所とその理由を列挙します。

使う理由

Dart には Logback も SLF4J も、呼び出し元のデータも、タイムゾーンデータベースもありません。スターターはアプリケーションから見えるもの (行、プロパティ) を再現し、JVM に依存するものは除いています。

例

名前が変わった一つのキーを除いて、そのまま動く Spring Boot の設定:

logging.level.root=info
logging.level.neon.checkout=debug
logging.pattern.console=%d{HH:mm:ss.SSS} %clr(%5p) [%logger{20}] %m%n
logging.file.name=logs/shop.log
# Spring Boot: logging.logback.rollingpolicy.max-file-size=10MB
logging.file.rolling-policy.max-file-size=10MB

設定

Spring Boot ここでは 理由
logging.logback.rollingpolicy.* logging.file.rolling-policy.*。古い名前は起動を止め、新しい名前を示す Logback がない
logback.xml、logback-spring.xml、logging.config 対応しない。アペンダーはコードで追加する XML の設定がない
logging.structured.* 対応しない
spring.output.ansi.enabled のデフォルトは detect デフォルトは always (iOS では never。そのログはコードをテキストとして表示する) Flutter のツールは色を表示する
ロギングシステムの開始前にログに出された行は、失われるか素のまま出力される ファイル、バッファー、追加したアペンダーに再生される (Spring Boot の DeferredLogs)。コンソールはすでに表示している

パターン

Spring Boot ここでは 理由
パターンの最後の %n が行を終える レコードごとに 1 行: コンソールとファイルが改行を追加するため、最後の %n は取り除かれる print が改行を追加する
%thread はスレッド Isolate の名前 (main、isolate-2) Dart にはスレッドではなく Isolate がある
%X は k=v, k=v を出力する 先頭に空白を付けた {k=v, ...}。フィールドがなければ何も出さない メッセージの後で読みやすい
%C、%M、%L、%F、%caller 不明なワードとして起動を止める Dart のレコードは、どこでログに出されたかを知らない
%marker、%contextName 対応しない
任意のタイムゾーンの %d UTC のみ タイムゾーンデータベースがない
%kvp は SLF4J のキーと値のペアを出力する レコードのフィールドを出力する Dart には SLF4J がない
%prefix、%property %prefix は変換を Logback の長い名前で示す。%property はパターン変数を読み、次に Environment を読む
色のないパターンは素のまま 何も色付けしないコンソールのパターンには Spring Boot の色が付く (時刻は薄く、レベルはレベルに応じて、ロガーはシアン)

ファイル

Spring Boot ここでは
日付とサイズで file-name-pattern (日付、%i、.gz) にロールオーバーする サイズだけで、番号付きのファイル (shop.log.1、.2) に。file-name-pattern は警告とともに無視される
max-history は日数を数える ファイルの数を数える
アーカイブは圧縮できる 圧縮されない
logging.charset.file に任意の Java の文字セット UTF-8、ISO-8859-1、US-ASCII。エンコードできない文字は、Java と同じく ? になる
logging.charset.console はコンソールの文字セットを設定する チェックされるだけ: コンソールはテキストを書く print
空のパターン: Logback はステータスエラーを報告する 空の logging.pattern.console= や logging.pattern.file= はその出力を無効にする
どの JVM でもファイル Web では使えない: logging.file.* は警告とともに無視される

グループとレベル

定義済みの web と sql のグループがあります (spring.web、spring.websocket。spring.jdbc.core.JdbcTemplate、spring.jdbc.core.StatementCreatorUtils)。ロガー名は Dart の名前なので、logging.level.org.springframework には効果がありません。

ここだけのもの

関連項目