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 には効果がありません。
ここだけのもの
- アプリ内のログ画面のための
LogBufferとLogQuery。 logging.buffer.*とlogging.threshold.buffer。- Flutter アプリの書き込み可能なディレクトリのための
LoggingSystem.fileDirectory。