mirror of https://github.com/vapor/docs.git
110 lines
4.8 KiB
Markdown
110 lines
4.8 KiB
Markdown
# ロギング
|
|
|
|
Vapor のロギング API は [SwiftLog](https://github.com/apple/swift-log) を基に構築されています。これは、Vapor が SwiftLog の[バックエンド実装](https://github.com/apple/swift-log#backends)と互換性があることを示しています。
|
|
|
|
## ロガー
|
|
|
|
`Logger` のインスタンスはログメッセージを出力するために使用されます。Vapor はロガーにアクセスするためのいくつかの簡単な方法を提供しています。
|
|
|
|
### リクエスト
|
|
|
|
各入力 `Request` には、そのリクエストに固有のログを使用するためのユニークなロガーがあります。
|
|
|
|
```swift
|
|
app.get("hello") { req -> String in
|
|
req.logger.info("Hello, logs!")
|
|
return "Hello, world!"
|
|
}
|
|
```
|
|
|
|
リクエストロガーには、ログの追跡を容易にするために、入力リクエストを識別するユニークな UUID が含まれています。
|
|
|
|
```
|
|
[ INFO ] Hello, logs! [request-id: C637065A-8CB0-4502-91DC-9B8615C5D315] (App/routes.swift:10)
|
|
```
|
|
|
|
!!! info
|
|
ロガーメタデータは、デバッグログレベルまたはそれ以下でのみ表示されます。
|
|
|
|
### アプリケーション
|
|
|
|
アプリの起動や設定中のログメッセージには、`Application` のロガーを使用します。
|
|
|
|
```swift
|
|
app.logger.info("Setting up migrations...")
|
|
app.migrations.use(...)
|
|
```
|
|
|
|
### カスタムロガー
|
|
|
|
`Application` や `Request` にアクセスできない状況では、新しい `Logger` を初期化できます。
|
|
|
|
```swift
|
|
let logger = Logger(label: "dev.logger.my")
|
|
logger.info(...)
|
|
```
|
|
|
|
カスタムロガーは設定されたロギングバックエンドに出力されますが、リクエスト UUID のような重要なメタデータは付加されません。可能な限りリクエストやアプリケーション固有のロガーを使用してください。
|
|
|
|
## レベル
|
|
|
|
SwiftLog はいくつかの異なるログレベルをサポートしています。
|
|
|
|
|nama|description|
|
|
|-|-|
|
|
|trace|プログラムの実行を追跡する際に通常のみ役立つ情報を含むメッセージに適しています。|
|
|
|debug|プログラムをデバッグする際に通常のみ役立つ情報を含むメッセージに適しています。|
|
|
|info|情報メッセージに適しています。|
|
|
|notice|エラー条件ではないが、特別な処理が必要な条件に適しています。|
|
|
|warning|エラー条件ではないが、noticeよりも重大なメッセージに適しています。|
|
|
|error|エラー条件に適しています。|
|
|
|critical|通常は直ちに注意が必要な重大なエラー条件に適しています。|
|
|
|
|
`critical` メッセージがログに記録されると、ログバックエンドはシステム状態をキャプチャするために重い操作（スタックトレースのキャプチャなど）を自由に実行できます。
|
|
|
|
デフォルトでは、Vapor は `info` レベルのログを使用します。`production` 環境で実行する場合は、パフォーマンス向上のためにnoticeが使用されます。
|
|
|
|
### ログレベルの変更
|
|
|
|
環境モードに関係なく、ログの量を増減するためにログレベルをオーバーライドできます。
|
|
|
|
最初の方法は、アプリケーションを起動する際にオプションの `--log` フラグを渡すことです。
|
|
|
|
```sh
|
|
swift run App serve --log debug
|
|
```
|
|
|
|
2番目の方法は、`LOG_LEVEL` 環境変数を設定することです。
|
|
|
|
```sh
|
|
export LOG_LEVEL=debug
|
|
swift run App serve
|
|
```
|
|
|
|
これらの操作は、Xcodeで `App` スキームを編集することで行うことができます。
|
|
|
|
## 設定
|
|
|
|
SwiftLog は、プロセスごとに一度 `LoggingSystem` をブートストラップすることによって設定されます。Vapor プロジェクトでは、これは通常 `entrypoint.swift` で行われます。
|
|
|
|
```swift
|
|
var env = try Environment.detect()
|
|
try LoggingSystem.bootstrap(from: &env)
|
|
```
|
|
|
|
`bootstrap(from:)` は、コマンドライン引数や環境変数に基づいてデフォルトのログハンドラーを設定するために Vapor が提供するヘルパーメソッドです。デフォルトのログハンドラーは、ANSI カラーサポートを備えた端末へのメッセージ出力をサポートしています。
|
|
|
|
### カスタムハンドラー
|
|
|
|
Vaporのデフォルトのログハンドラーをオーバーライドし、独自のものを登録することができます。
|
|
|
|
```swift
|
|
import Logging
|
|
|
|
LoggingSystem.bootstrap { label in
|
|
StreamLogHandler.standardOutput(label: label)
|
|
}
|
|
```
|
|
|
|
SwiftLog がサポートするすべてのバックエンドは Vapor と互換性があります。ただし、コマンドライン引数や環境変数を使用したログレベルの変更は、Vapor のデフォルトのログハンドラーとのみ互換性があります。
|