
# spring_boot_starter_logging

`spring_boot_starter_logging` は Spring for Dart のロギングのバックエンドで、`spring-boot-starter-logging` に当たる Dart のものです。追加すると、`SpringLog` の行が Spring Boot の形式で出力されます。設定には Spring Boot のアプリケーションと同じ `logging.*` プロパティと、Logback のパターン構文を使います。

コードは不要です。ジェネレーターがスターターを見つけ、アプリケーションの起動時に `SpringLog` の背後に `LoggingSystem` がインストールされます。他のスターター (Web、Feign、WebSocket、スケジューリング、キャッシュ) はこれを一緒に持ち込みます。

## 使う理由

`spring_core_dart` のロガーである `SpringLog` は、単独ではコンソールに素の行を出力するだけです。アプリケーションには、たいていもっと多くのものが必要です。

- 時刻、レベル、プロセス ID、アプリケーション名、ロガーを含み、ターミナルでは色付きになる Spring Boot の行の形式。
- Logback のパターンで書く独自の形式。
- サーバーでの、サイズでロールオーバーするログファイル。
- ユーザーが読めるターミナルを持たないモバイルアプリでの、ログ画面や「ログを送信」ボタン。
- プロパティや環境変数で、あるいはアプリケーションの実行中に変更するレベル。

スターターはこれらすべてを Spring Boot のプロパティ名で提供するため、Spring Boot の設定がそのまま動きます。

## セットアップ

```yaml
# pubspec.yaml
dependencies:
  spring_boot_starter_logging: ^0.9.0
```

生成される `springApplication` がその自動構成を列挙するよう、追加した後に `dart run build_runner build` を再実行してください。

## 例

```dart
// lib/checkout.dart
import 'package:spring_boot_dart/spring_boot_dart.dart';

import 'spring_gen/app.spring.dart'; // スキャンの生成ファイルが log ゲッターを持つ

@Service()
@Log(topic: 'neon.checkout') // ロガーの名前。topic がなければ <package>.<Class>
class Checkout {
  // 注文はフィールドとして渡す: 検索でき、メッセージの後に出力される。
  void pay(int order, double amount) =>
      log.info('paid $amount', fields: {'order': order});
}
```

```yaml
# lib/resources/application.yml
spring:
  application:
    name: shop
logging:
  level:
    root: info
    neon.checkout: debug
  file:
    name: logs/shop.log
```

Spring Boot の形式でのコンソールの行:

```text
2026-10-23T21:08:01.580Z  INFO 4711 --- [shop] [           main] neon.checkout                            : paid 12.5 {order=1}
```

同じ行が色なしで `logs/shop.log` に書かれます。生成ファイルが手元にない場所 (ライブラリ、スクリプト、トップレベルの関数) では、ロガーを自分で作ります: `const log = SpringLog('neon.checkout');`。

## 起動するもの

自動構成 (`springBootStarterLoggingAutoConfiguration`) は、`logging.enabled=false` でない限り、3 つの Bean を追加します。

| Bean | 内容 |
|---|---|
| `loggingSystemInitializer` | `logging.*` プロパティから `LoggingSystem.instance` を構成し、どのアプリケーションの Bean も生成される前にインストールする。コンテキストが閉じるとアンインストールする |
| `loggingSystem` | 実行時にレベルを変えたりアペンダーを追加したりするための `LoggingSystem.instance` |
| `logBuffer` | ログ画面のための、メモリ上の `LogBuffer` |

レベル (`logging.level.*`、`logging.group.*`) は、このスターターの有無にかかわらず、`spring_boot_dart` 自身が適用します。スターターは出力を追加します。[ログレベル](../spring-boot-dart/logging-levels.md) を参照してください。

起動中、システムが設定される前にログに出された行は、Spring Boot の `DeferredLogs` と同じく、ファイル、バッファー、追加したアペンダーに再生されます。起動が失敗した場合は、失敗レポートがログに出されるまでシステムはインストールされたままなので、レポートもファイルに届きます。

## 内容

- [コンソール](console.md): デフォルトの形式、色、出力先、しきい値。
- [パターン](patterns.md): `logging.pattern.console` と `logging.pattern.file` のすべての変換ワード。
- [ログファイル](log-files.md): `logging.file.*`、ロールオーバー、書き込みの失敗、Flutter のファイルディレクトリ。
- [ログ画面](log-buffer.md): `LogBuffer`、クエリ、ライブリスト、エクスポート。
- [実行時のレベルとアペンダー](appenders.md): `LoggingSystem.setLogLevel`、独自の `LogAppender`、Spring Boot なしでの使用。
- [すべてのプロパティ](properties.md): スターターのすべてのキー。
- [Spring との違い](differences.md): Logback と動作が異なる点。

## Spring (Java) との対応

```java
@Slf4j(topic = "neon.checkout")   // Lombok
@Service
class Checkout {
  void pay(int order, double amount) {
    log.info("paid {}", amount);
  }
}
```

```properties
logging.level.neon.checkout=debug
logging.file.name=logs/shop.log
logging.logback.rollingpolicy.max-file-size=10MB
```

重要な違い:

- Logback も `logback-spring.xml` もありません。すべてプロパティで設定し、アペンダーはコードで追加します。
- ロールオーバーポリシーのキーは `logging.file.rolling-policy.*` です。`logging.logback.rollingpolicy.*` の名前は起動を止めます。
- コンソールはデフォルトで色付きです (`always`。Spring Boot のデフォルトは `detect`)。
- ログの時刻は UTC です。Dart にはタイムゾーンデータベースがありません。
- すべての違いは [Spring との違い](differences.md) にあります。

## 関連項目

- [spring_boot_dart](../spring-boot-dart/index.md)
- [ログレベル](../spring-boot-dart/logging-levels.md)
- [spring_core_dart のロギング](../spring-core-dart/logging/index.md)
- [SpringLog](../spring-core-dart/logging/spring-log.md)
- [ビルドに含まれるもの](optimizations.md)
