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 の設定がそのまま動きます。
セットアップ
# pubspec.yaml
dependencies:
spring_boot_starter_logging: ^0.9.0
生成される springApplication がその自動構成を列挙するよう、追加した後に dart run build_runner build を再実行してください。
例
// 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});
}
# lib/resources/application.yml
spring:
application:
name: shop
logging:
level:
root: info
neon.checkout: debug
file:
name: logs/shop.log
Spring Boot の形式でのコンソールの行:
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 の DeferredLogs と同じく、ファイル、バッファー、追加したアペンダーに再生されます。起動が失敗した場合は、失敗レポートがログに出されるまでシステムはインストールされたままなので、レポートもファイルに届きます。
内容
- コンソール: デフォルトの形式、色、出力先、しきい値。
- パターン:
logging.pattern.consoleとlogging.pattern.fileのすべての変換ワード。 - ログファイル:
logging.file.*、ロールオーバー、書き込みの失敗、Flutter のファイルディレクトリ。 - ログ画面:
LogBuffer、クエリ、ライブリスト、エクスポート。 - 実行時のレベルとアペンダー:
LoggingSystem.setLogLevel、独自のLogAppender、Spring Boot なしでの使用。 - すべてのプロパティ: スターターのすべてのキー。
- Spring との違い: Logback と動作が異なる点。
Spring (Java) との対応
@Slf4j(topic = "neon.checkout") // Lombok
@Service
class Checkout {
void pay(int order, double amount) {
log.info("paid {}", amount);
}
}
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 との違い にあります。