コンソール

コンソールはロギングシステムの最初の出力です。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} として来ます。

関連項目