
# コンソール

コンソールはロギングシステムの最初の出力です。Dart VM ではその行は標準出力に、Flutter と Web では `print` に送られ、デバイスのログ (logcat、システムログ、`flutter run`) に届きます。

## 使う理由

開発中、ログを読むのはコンソールです。Spring Boot の行の形式は、どの行でも同じ列を同じ位置に置くため、長いログでも読みやすく保たれ、色によってレベルとロガーが目立ちます。本番では、ログコレクターが同じ行を色なしで読みます。

## 例

```yaml
# lib/resources/application.yml
spring:
  application:
    name: shop
    group: neon
  output:
    ansi:
      enabled: detect      # ターミナルでだけ色を付ける
logging:
  threshold:
    console: info          # コンソールは info 以上を表示し、ファイルはすべてを受け取る
  console:
    target: stdout
```

```text
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 サーバーの [プール](../spring-boot-starter-web/server/isolates.md) の Isolate では `isolate-2` |
| `logging.pattern.correlation` | デフォルトでは空 |
| `neon.checkout` | ロガー名。39 文字に短縮し、40 文字に埋める |
| `paid 12.5 {order=1}` | メッセージと、その後にレコードのフィールド (`%X`) |
| エラー | 次の行以降に (`logging.exception-conversion-word`、`%wEx`) |

参考までに、デフォルトのパターン:

```text
%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` で書きます。[パターン](patterns.md) を参照してください。空の `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` に送ってください。

```dart
Future<void> main() async {
  LoggingSystem.instance.console.out = debugPrint;
  await runApplicationAsync(const []);
}
```

`logging.console.target` を設定しなければ、`debugPrint` のようにアプリケーションが自分で設定した出力はそのまま残ります。

## レベルとしきい値

レベル (`logging.level.*`) は、レコードをそもそも作るかどうかを決めます。ロガーのレベルより低いレコードは決して作られません。しきい値を使うと、一つの出力がレベルの許すものより少ないレコードを保持できます。ファイルはすべてを受け取りつつ、コンソールには警告だけ、といった具合です。

```properties
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}` として来ます。

## 関連項目

- [パターン](patterns.md)
- [すべてのプロパティ](properties.md)
- [ログレベル](../spring-boot-dart/logging-levels.md)
