コンソール
コンソールはロギングシステムの最初の出力です。Dart VM ではその行は標準出力に、Flutter と Web では print に送られ、デバイスのログ (logcat、システムログ、flutter run) に届きます。
使う理由
開発中、ログを読むのはコンソールです。Spring Boot の行の形式は、どの行でも同じ列を同じ位置に置くため、長いログでも読みやすく保たれ、色によってレベルとロガーが目立ちます。本番では、ログコレクターが同じ行を色なしで読みます。
例
# lib/resources/application.yml
spring:
application:
name: shop
group: neon
output:
ansi:
enabled: detect # ターミナルでだけ色を付ける
logging:
threshold:
console: info # コンソールは info 以上を表示し、ファイルはすべてを受け取る
console:
target: stdout
2026-10-23T21:08:01.580Z INFO 4711 --- [shop] [neon] [ main] neon.checkout : paid 12.5 {order=1}
デフォルトの行
logging.pattern.console がなければ、行は Spring Boot のものです。
| 列 | 由来 |
|---|---|
2026-10-23T21:08:01.580Z |
logging.pattern.dateformat を使う %d (yyyy-MM-dd'T'HH:mm:ss.SSSXXX、UTC) |
INFO |
logging.pattern.level (%5p) |
4711 |
プロセス ID (${PID})。ない場所 (Web) では空 |
--- [shop] [neon] |
spring.application.name と spring.application.group。それぞれ、設定されていて logging.include-application-name / -group が true の場合のみ |
[ main] |
Isolate の名前。15 文字に埋める: main、または Web サーバーの プール の Isolate では isolate-2 |
logging.pattern.correlation |
デフォルトでは空 |
neon.checkout |
ロガー名。39 文字に短縮し、40 文字に埋める |
paid 12.5 {order=1} |
メッセージと、その後にレコードのフィールド (%X) |
| エラー | 次の行以降に (logging.exception-conversion-word、%wEx) |
参考までに、デフォルトのパターン:
%clr(%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd'T'HH:mm:ss.SSSXXX}}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:-}){magenta} %clr(--- %esb(){APPLICATION_NAME}%esb{APPLICATION_GROUP}[%15.15t] ${LOG_CORRELATION_PATTERN:-}){faint}%clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%X%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}
独自のものは logging.pattern.console で書きます。パターン を参照してください。空の logging.pattern.console= はコンソールを無効にします。
色
spring.output.ansi.enabled |
色 |
|---|---|
always (デフォルト) |
常に。ただし、コンソールがコードをテキストとして表示する場所 (iOS の Flutter アプリ) ではデフォルトは never |
detect |
標準出力がコードを理解するターミナルである場合、または Flutter の debug・profile ビルドの場合のみ (Spring Boot のデフォルト) |
never |
素のテキスト。プログラムが読むログ向け: ログコレクター、Xcode のコンソール、adb logcat、ファイルにリダイレクトした出力 |
色はパターンの %clr(...) から来ます。自分では何も色付けしないパターン (%clr も Logback の色もない) にも、Spring Boot の色が付きます。時刻は薄く、レベルはレベルに応じて、ロガーはシアンです。Logback の色のワード (%red(...)、%highlight(...)) は、Logback と同じく常に ANSI コードを書きます。ファイルには決して色が付きません。
行の出力先
| 設定 | 効果 |
|---|---|
logging.console.target |
stdout (デフォルト) または stderr。system-out と system-err は Logback での同じものの名前。Dart VM のみ |
logging.console.enabled=false |
コンソールに出力しない |
logging.threshold.console |
コンソールが表示する最も低いレベル (デフォルトは trace: レベルが許すもの) |
LoggingSystem.instance.console.out |
各行を受け取る関数。コードで設定する |
Dart VM では標準出力はすぐに書かれるため、exit の直前に書かれた行も失われません。Flutter では、長い行がデバイスのログで切られないよう、起動前にコンソールを debugPrint に送ってください。
Future<void> main() async {
LoggingSystem.instance.console.out = debugPrint;
await runApplicationAsync(const []);
}
logging.console.target を設定しなければ、debugPrint のようにアプリケーションが自分で設定した出力はそのまま残ります。
レベルとしきい値
レベル (logging.level.*) は、レコードをそもそも作るかどうかを決めます。ロガーのレベルより低いレコードは決して作られません。しきい値を使うと、一つの出力がレベルの許すものより少ないレコードを保持できます。ファイルはすべてを受け取りつつ、コンソールには警告だけ、といった具合です。
logging.level.root=debug # debug 以上のレコードが作られる
logging.threshold.console=warn # コンソールは警告とエラーを表示する
logging.threshold.file=debug # ファイルはそのすべてを保持する
Spring (Java) との対応
デフォルトの行、プロパティ、色は、Logback を使う Spring Boot と同じです。違い: spring.output.ansi.enabled のデフォルトは detect ではなく always。時刻は UTC。%thread は Isolate の名前。フィールドはメッセージの後に {k=v} として来ます。