ロギング設定

Red Hat build of Quarkus 3.20

Red Hat Customer Content Services

法律上の通知

概要

Red Hat build of Quarkus でのロギング API の使用、ロギング出力の設定、統合出力のためのロギングアダプターの使用についてお読みください。

Red Hat build of Quarkus ドキュメントへのフィードバックの提供

エラーを報告したり、ドキュメントを改善したりするには、Red Hat Jira アカウントにログインし、課題を送信してください。Red Hat Jira アカウントをお持ちでない場合は、アカウントを作成するように求められます。

手順

次のリンクをクリックして チケットを作成します。
Summary に課題の簡単な説明を入力します。
Description に課題や機能拡張の詳細な説明を入力します。問題があるドキュメントのセクションへの URL も記載してください。
Submit をクリックすると、課題が作成され、適切なドキュメントチームに転送されます。

第1章ロギング設定

Red Hat build of Quarkus でのロギング API の使用、ロギング出力の設定、他のロギング API からの出力を統合するためのロギングアダプターの使用を説明します。

このドキュメントは、このコンポーネントおよびその他の可観測性関連コンポーネントを取り上げている Observability in Quarkus リファレンスガイドの一部です。

Quarkus は、アプリケーションおよびフレームワークログの公開に、JBoss Log Manager ロギングバックエンドを使用します。Quarkus は、JBoss Log Manager とシームレスに統合された、JBoss Logging API およびその他の複数のロギング API をサポートします。以下の API のいずれかを使用できます。

1.1. JBoss Logging を使用するアプリケーションロギング

JBoss Logging API を使用する場合、アプリケーションに追加の依存関係は必要ありません。依存関係は Red Hat build of Quarkus によって自動的に提供されます。

JBoss Logging API を使用してメッセージをログに記録する例:

import org.jboss.logging.Logger;

import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.MediaType;

@Path("/hello")
public class ExampleResource {

    private static final Logger LOG = Logger.getLogger(ExampleResource.class);

    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String hello() {
        LOG.info("Hello");
        return "hello";
    }
}

注記

JBoss Logging は、ログメッセージを JBoss Log Manager に直接ルーティングしますが、別のロギング API に依存するライブラリーがある可能性もあります。その場合、ロギングアダプターを使用して、ログメッセージも JBoss Log Manager にルーティングされるようにする必要があります。

1.2. アプリケーションロガーの取得

Red Hat build of Quarkus でアプリケーションロガーを取得するには、次のいずれかの方法を選択します。

ロガーフィールドを宣言する
ロギングを簡素化する
設定されたロガーを注入する

1.2.1. ロガーフィールドを宣言する

この従来のアプローチでは、特定の API を使用してロガーインスタンスを取得し、それをクラスの静的フィールドに格納し、このインスタンスに対してロギング操作を呼び出します。

サポートされているロギング API であれば、同じフローを適用できます。

JBoss Logging API を使用してロガーインスタンスを静的フィールドに保存する例:

package com.example;

import org.jboss.logging.Logger;

public class MyService {
    private static final Logger log = Logger.getLogger(MyService.class); 1

    public void doSomething() {
        log.info("It works!"); 2
    }
}

1: ロガーフィールドを定義します。
2: log オブジェクト上で目的のロギングメソッドを呼び出します。

1.2.2. ロギングを簡素化する

Quarkus は、io.quarkus.logging.Log を使用するクラスにロガーフィールドを自動的に追加することで、ロギングを簡素化します。これにより、反復的なボイラープレートコードが不要になり、ロギング設定の利便性が向上します。

静的メソッド呼び出しを使用した簡素化されたロギングの例:

package com.example;

import io.quarkus.logging.Log; 1

class MyService { 2
    public void doSomething() {
        Log.info("Simple!"); 3
    }
}

1: io.quarkus.logging.Log クラスには、JBoss Logging と同じメソッドが含まれます。ただし、それが static である点は異なります。
2: クラスはロガーフィールドを宣言しないことに注意してください。これは、アプリケーションのビルド中に、Log API を使用する各クラスに private static final org.jboss.logging.Logger フィールドが自動的に作成されるためです。Log メソッドを呼び出すクラスの完全修飾名は、ロガー名として使用されます。この例のロガー名は com.example.MyService です。
3: 最後に、Log メソッドへの呼び出しはすべて、アプリケーションのビルド中にロガーフィールドに対する通常の JBoss Logging 呼び出しに書き換えられます。

警告

Log API は外部依存関係ではなく、アプリケーションクラスでのみ使用してください。ビルド時に Quarkus によって処理されない Log メソッドを呼び出すと、例外が発生します。

エクステンションでの io.quarkus.logging.Log の使用:

Log API は、アプリケーションクラスでのロギングを簡素化します。一方、拡張モジュールや外部依存関係で使用することは推奨されません。

次の点を考慮してください。

io.quarkus.logging.Log は、ビルド時に行われる Quarkus バイトコード変換に依存します。
拡張モジュールでは、モジュールに Jandex インデックスが含まれている場合に限り、Log が機能します。しかし、この動作はサポートされておらず、ロギングが信頼できないものになる可能性があります。
エクステンションの開発では、io.quarkus.logging.Log の代わりに org.jboss.logging.Logger.getLogger(String) を使用してください。

1.2.3. 設定されたロガーを注入する

@Inject アノテーションを使用して、設定済みの org.jboss.logging.Logger ロガーインスタンスを注入する方法は、アプリケーションアプリケーションロガーを追加する場合の代替手段ですが、これを適用できるのは CDI Bean のみです。

ロガーの名前は、@Inject Logger log を使用すると注入するクラスにちなんだ名前、@Inject @LoggerName("…") Logger log を使用すると特定の名前になります。注入が完了すると、log オブジェクトを使用してロギングメソッドを呼び出せます。

2 種類のロガーインジェクションの例:

package com.example;

import org.jboss.logging.Logger;

@ApplicationScoped
class SimpleBean {

   @Inject
   Logger log; 1

   @LoggerName("foo")
   Logger fooLog; 2

   public void ping() {
     log.info("Simple!");
     fooLog.info("Goes to _foo_ logger!");
   }
}

1: 宣言するクラスの完全修飾クラス名 (FQCN) は、ロガー名として使用されます。たとえば、org.jboss.logging.Logger.getLogger(SimpleBean.class) が使用されます。
2: この場合、ロガー名として foo という名前が使用されます。たとえば、org.jboss.logging.Logger.getLogger("foo") が使用されます。

注記

ロガーインスタンスは内部的にキャッシュされます。したがって、たとえば @RequestScoped Bean にロガーが注入されると、挿入されると、ロガーのインスタンス化に関連してパフォーマンスが低下することを回避するために、そのロガーはすべての Bean インスタンスで共有されます。

1.3. ログレベルの使用

Red Hat build of Quarkus ではさまざまなログレベルが用意されています。開発者はそれらを使用して、ログに記録する情報の量をイベントの重大度に基づき制御できます。

表1.1 利用可能なログレベル:

OFF	ロギングをオフにするために設定で使用される特別なレベル。
FATAL	重大なサービス障害またはリクエストをまったく処理できない状態。
ERROR	処理中の重大な問題またはリクエストを完了できない状態。
WARN	重大ではないサービスエラーまたは即時の修正を必要としない可能性がある問題。
INFO	サービスライフサイクルイベントまたはその他の重要で頻度の低い情報。
DEBUG	ライフサイクルイベントまたは特定のリクエストに関連付けられていないイベントに関する追加情報。デバッグに役立ちます。
TRACE	リクエストごとの詳細なデバッグ情報。非常に高頻度で提供される可能性があります。
ALL	カスタムレベルを含むすべてのメッセージのロギングをオンにする特別なレベル。

java.util.logging を使用するアプリケーションおよびライブラリーに対しては、以下のレベルも設定できます。

SEVERE	ERROR と同じ。
WARNING	WARN と同じ。
CONFIG	サービス設定情報。
FINE	DEBUG と同じ。
FINER	TRACE と同じ。
FINEST	デバッグ出力が `TRACE` よりも大きくなり、頻度も高い場合があります。

表1.2 レベル間のマッピング
数値で示したレベル値	標準レベル名	該当する `java.util.logging` (JUL) レベル名
1100	FATAL	該当なし
1000	ERROR	SEVERE
900	WARN	WARNING
800	INFO	INFO
700	該当なし	CONFIG
500	DEBUG	FINE
400	TRACE	FINER
300	該当なし	FINEST

1.4. ログレベル、カテゴリー、フォーマットの設定

Red Hat build of Quarkus に統合された JBoss Logging は、利用可能なすべてのエクステンションを設定する単一の設定ファイルを通じて、サポートされているすべてのロギング API の設定を一元化します。ランタイムロギングを調整するには、application.properties ファイルを変更します。

デフォルトのログレベルを INFO ロギングに設定し、Hibernate DEBUG ログを含める例:

quarkus.log.level=INFO
quarkus.log.category."org.hibernate".level=DEBUG

ログレベルを DEBUG 未満に設定する場合は、最小ログレベルも調整する必要があります。この設定は、quarkus.log.min-level 設定プロパティーを使用してグローバルに適用することも、カテゴリーごとに適用することもできます。

quarkus.log.category."org.hibernate".min-level=TRACE

これにより、Quarkus がサポートコードを生成する必要があるフロアレベルが設定されます。Quarkus が実用的ではないレベルのログを省略して最適化できるように、最小ログレベルはビルド時に設定する必要があります。

ネイティブ実行の例:

INFO を最小ログレベルとして設定すると、それより低い isTraceEnabled などのレベルのチェックが false に設定されます。これにより、if(logger.isDebug()) callMethod(); のようなコードが特定され、"dead" としてマークされて決して実行されなくなります。

警告

該当するプロパティーをコマンドラインで追加する場合は、" の文字が正しくエスケープされていることを確認してください。

-Dquarkus.log.category.\"org.hibernate\".level=TRACE

可能性のあるプロパティーは、すべてロギング設定リファレンスセクションにリストされています。

1.4.1. ロギングカテゴリー

ロギングはカテゴリーごとに設定され、各カテゴリーは個別に設定されます。具体的なサブカテゴリー設定がなければ、カテゴリーの設定はすべてのサブカテゴリーに再帰的に適用されます。

すべてのロギングカテゴリーの親は、"ルートカテゴリー" と呼ばれます。最終的な親となるこのカテゴリーには、他の全カテゴリーにグローバルに適用される設定が含まれる場合があります。これには、グローバルに設定されたハンドラーおよびフォーマッターが含まれます。

例1.1 すべてのカテゴリーに適用されるグローバル設定の例:

quarkus.log.handlers=con,mylog

quarkus.log.handler.console.con.enable=true
quarkus.log.handler.file.mylog.enable=true

この例では、ルートカテゴリーは、con と mylog という 2 つの名前付きハンドラーを使用するように設定されています。

例1.2 カテゴリーごとの設定の例:

quarkus.log.category."org.apache.kafka.clients".level=INFO
quarkus.log.category."org.apache.kafka.common.utils".level=INFO

この例は、org.apache.kafka.clients および org.apache.kafka.common.utils のカテゴリーで、最小ログレベルを設定する方法を示しています。

詳細は、ロギング設定リファレンスを参照してください。

特定のカテゴリーに設定を追加する場合は、quarkus.log.handler.[console|file|syslog].<your-handler-name>.* などの名前付きハンドラーを作成し、quarkus.log.category.<my-category>.handlers を使用してそのカテゴリーに設定します。

ユースケースの例としては、ファイルに保存されるログメッセージに、他のハンドラーで使用されるフォーマットとは異なるタイムスタンプフォーマットを使用する場合があります。

詳細なデモは、名前付きハンドラーをカテゴリーに割り当てるの出力例を参照してください。

プロパティー名	デフォルト	説明
`quarkus.log.category."<category-name>".level`	`INFO ^[a]`	`<category-name>` という名前のカテゴリーの設定に使用するレベル。引用符が必要です。
`quarkus.log.category."<category-name>".min-level`	`DEBUG`	`<category-name>` という名前のカテゴリーの設定に使用する最小ログレベル。引用符が必要です。
`quarkus.log.category."<category-name>".use-parent-handlers`	`true`	このロガーが出力を親ロガーに送信するかどうかを指定します。
`quarkus.log.category."<category-name>".handlers=[<handler>]`	`empty ^[b]`	特定のカテゴリーに割り当てるハンドラーの名前。
^[a] 一部のエクステンションでは、ログノイズを減らすために、特定のカテゴリーに対して、カスタマイズされたデフォルトのログレベルがデフォルトで定義されている場合があります。設定でログレベルを設定すると、エクステンションで定義されたログレベルがオーバーライドされます。 ^[b] デフォルトで、設定されたカテゴリーのハンドラーは、ルートロガーに割り当てられたハンドラーと同じになります。

注記

. 記号は、設定プロパティーの特定の部分を分離します。プロパティー名に含まれる引用符は、カテゴリー仕様をそのまま維持するために必要なエスケープとして使用されます (例: quarkus.log.category."io.quarkus.smallrye.jwt".level=TRACE)。

1.4.2. ルートロガー設定

ルートロガーカテゴリーは個別に処理され、次のプロパティーを使用して設定されます。

プロパティー名	デフォルト	説明
`quarkus.log.level`	`INFO`	すべてのログカテゴリーのデフォルトログレベル。
`quarkus.log.min-level`	`DEBUG`	すべてのログカテゴリーのデフォルト最小ログレベル。

指定されたロガーカテゴリーにレベルが設定されていない場合は、親カテゴリーが確認されます。
カテゴリーやその親カテゴリーのいずれにも設定が指定されていない場合は、ルートロガー設定が使用されます。

注記

通常、ルートロガーのハンドラーは quarkus.log.console、quarkus.log.file、quarkus.log.syslog を介して直接設定されますが、quarkus.log.handlers プロパティーを使用して追加の名前付きハンドラーを割り当てることも可能です。

1.5. ロギングフォーマット

Red Hat build of Quarkus は、人間が判読できるテキストログを生成するパターンベースのロギングフォーマッターをデフォルトで使用します。ただし、専用のプロパティーを使用して各ログハンドラーのフォーマットを設定することもできます。

コンソールハンドラーの場合、プロパティーは quarkus.log.console.format です。

ロギングフォーマットの文字列では、次のシンボルを使用できます。

記号	概要	説明
`%%`	`%`	単純な `%` 文字をレンダリングします。
`%c`	カテゴリー	カテゴリー名をレンダリングします。
`%C`	ソースクラス	ソースクラス名をレンダリングします。^[a]
`%d{xxx}`	日付	指定された日付フォーマットの文字列で日付をレンダリングします。`java.text.SimpleDateFormat` で定義された構文を使用します。
`%e`	例外	発生した例外がある場合はそれをレンダリングします。
`%F`	ソースファイル	ソースファイル名をレンダリングします。^[a]
`%h`	ホスト名	システムの単純なホスト名をレンダリングします。
`%H`	修飾ホスト名	システムの完全修飾ホスト名を表示します。オペレーティングシステムの設定によっては、単純なホスト名と同じになる場合があります。
`%i`	プロセス ID	現在のプロセス PID をレンダリングします。
`%l`	ソースの場所	ソースファイル名、行番号、クラス名、メソッド名を含むソースの場所情報をレンダリングします。^[a]
`%L`	ソース行	ソース行番号をレンダリングします。^[a]
`%m`	フルメッセージ	ログメッセージと例外 (存在する場合) をレンダリングします。
`%M`	ソースメソッド	ソースメソッド名をレンダリングします。^[a]
`%n`	改行	プラットフォーム固有の行区切り文字列をレンダリングします。
`%N`	プロセス名	現在のプロセスの名前をレンダリングします。
`%p`	レベル	メッセージのログレベルをレンダリングします。
`%r`	相対時間	アプリケーションログの開始からの相対時間 (ミリ秒単位) をレンダリングします。
`%s`	単純なメッセージ	例外トレースなしで、ログメッセージのみをレンダリングします。
`%t`	スレッド名	スレッド名をレンダリングします。
`%t{id}`	スレッド ID	スレッド ID をレンダリングします。
`%z{<zone name>}`	タイムゾーン	出力のタイムゾーンを `<zone name>` に設定します。
`%X{<MDC property name>}`	Mapped Diagnostic Context の値	Mapped Diagnostic Context から値をレンダリングします。
`%X`	Mapped Diagnostic Context の複数の値	Mapped Diagnostic Context からすべての値を `{property.key=property.value}` フォーマットでレンダリングします。
X	ネスト化された診断コンテキスト値	ネストされた診断コンテキストから、すべての値を {`value1.value2}` フォーマットでレンダリングします。
^[a] 呼び出し元情報を調べるフォーマットシーケンスがパフォーマンスに影響する可能性があります。

1.5.1. 代替のコンソールロギングフォーマット

コンソールログフォーマットは、たとえば後で分析するためにログ情報を処理および保存するサービスが Quarkus アプリケーションのコンソール出力をキャプチャーする場合などに変更できます。

1.5.1.1. JSON ロギングフォーマット

quarkus-logging-json エクステンションを使用すると、JSON ロギングフォーマットとその関連設定のサポートを追加できます。

次の抜粋が示すとおり、このエクステンションをビルドファイルに追加します。
- Maven を使用:
```
<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-logging-json</artifactId>
</dependency>
```
- Gradle を使用する場合:
```
implementation("io.quarkus:quarkus-logging-json")
```
  デフォルトでは、このエクステンションが存在するとコンソール設定の出力フォーマット設定が置き換えられ、フォーマット文字列と色設定 (存在する場合) は無視されます。非同期ログやログレベルの制御など、他のコンソール設定項目は引き続き適用されます。
  開発モードでは人間が判読できる (非構造化) ログを使用し、実稼働モードでは JSON ログ (構造化) を使用することが合理的なこともあります。その場合は、次の設定に示すように、さまざまなプロファイルを使用できます。
開発モードおよびテストモードで application.properties の JSON ロギングを無効にします。
```
%dev.quarkus.log.console.json.enabled=false
%test.quarkus.log.console.json.enabled=false
```

1.5.1.1.1. 設定

サポートされるプロパティーを使用して JSON ロギングエクステンションを設定し、動作をカスタマイズします。

lock ビルド時に固定された設定プロパティー: その他の設定プロパティーはすべて実行時にオーバーライド可能

設定プロパティー	型	デフォルト
コンソールロギング	型	Default
`quarkus.log.console.json.enabled` JSON コンソールフォーマットエクステンションを有効にするかどうかを決定します。これにより、"通常の" コンソールフォーマットが無効になります。環境変数: `QUARKUS_LOG_CONSOLE_JSON_ENABLED`	boolean
`quarkus.log.console.json.pretty-print` JSON レコードの "プリティープリント" を有効にします。一部の JSON パーサーは、プリティープリント出力を読み取れないことに注意してください。環境変数: `QUARKUS_LOG_CONSOLE_JSON_PRETTY_PRINT`	boolean	`false`
`quarkus.log.console.json.date-format` 使用する日付フォーマット。"default" は特別な文字列で、デフォルトフォーマットを使用する必要があることを示します。環境変数: `QUARKUS_LOG_CONSOLE_JSON_DATE_FORMAT`	string	`default`
`quarkus.log.console.json.record-delimiter` 使用する特別なレコード終了区切り文字。デフォルトでは、改行が使用されます。環境変数: `QUARKUS_LOG_CONSOLE_JSON_RECORD_DELIMITER`	string
`quarkus.log.console.json.zone-id` 使用するゾーン ID。"default" は特別な文字列で、デフォルトのゾーンを使用する必要があることを示します。環境変数: `QUARKUS_LOG_CONSOLE_JSON_ZONE_ID`	string	`default`
`quarkus.log.console.json.exception-output-type` 指定する例外出力型。環境変数: `QUARKUS_LOG_CONSOLE_JSON_EXCEPTION_OUTPUT_TYPE`	`detailed`, `formatted`, `detailed-and-formatted`	`detailed`
`quarkus.log.console.json.print-details` ログでの詳細出力を有効にします。値は呼び出し元から取得されるため、詳細の出力はリソースを多く使用する可能性があります。詳細には、ソースクラス名、ソースファイル名、ソースメソッド名、およびソース行番号が含まれます。環境変数: `QUARKUS_LOG_CONSOLE_JSON_PRINT_DETAILS`	boolean	`false`
`quarkus.log.console.json.key-overrides` カスタム値でキーをオーバーライドします。この値を省略すると、キーはオーバーライドされません。環境変数: `QUARKUS_LOG_CONSOLE_JSON_KEY_OVERRIDES`	string
`quarkus.log.console.json.excluded-keys` JSON 出力から除外するキー。環境変数: `QUARKUS_LOG_CONSOLE_JSON_EXCLUDED_KEYS`	list of string
`quarkus.log.console.json.additional-field."field-name".value` 追加フィールドの値。環境変数: `QUARKUS_LOG_CONSOLE_JSON_ADDITIONAL_FIELD__FIELD_NAME__VALUE`	string	required
`quarkus.log.console.json.additional-field."field-name".type` 追加フィールドの型指定。サポートされている型: `string`、`int`、`long`。指定されていない場合は string がデフォルトになります。環境変数: `QUARKUS_LOG_CONSOLE_JSON_ADDITIONAL_FIELD__FIELD_NAME__TYPE`	`string`, `int`, `long`	`string`
`quarkus.log.console.json.log-format` 生成される JSON のフォーマットを指定します。環境変数: `QUARKUS_LOG_CONSOLE_JSON_LOG_FORMAT`	`default`、`ecs`	`default`
ファイルロギング	型	Default
`quarkus.log.file.json.enabled` JSON コンソールフォーマットエクステンションを有効にするかどうかを決定します。これにより、"通常の" コンソールフォーマットが無効になります。環境変数: `QUARKUS_LOG_FILE_JSON_ENABLED`	boolean
`quarkus.log.file.json.pretty-print` JSON レコードの "プリティープリント" を有効にします。一部の JSON パーサーは、プリティープリント出力を読み取れないことに注意してください。環境変数: `QUARKUS_LOG_FILE_JSON_PRETTY_PRINT`	boolean	`false`
`quarkus.log.file.json.date-format` 使用する日付フォーマット。"default" は特別な文字列で、デフォルトフォーマットを使用する必要があることを示します。環境変数: `QUARKUS_LOG_FILE_JSON_DATE_FORMAT`	string	`default`
`quarkus.log.file.json.record-delimiter` 使用する特別なレコード終了区切り文字。デフォルトでは、改行が使用されます。環境変数: `QUARKUS_LOG_FILE_JSON_RECORD_DELIMITER`	string
`quarkus.log.file.json.zone-id` 使用するゾーン ID。"default" は特別な文字列で、デフォルトのゾーンを使用する必要があることを示します。環境変数: `QUARKUS_LOG_FILE_JSON_ZONE_ID`	string	`default`
`quarkus.log.file.json.exception-output-type` 指定する例外出力型。環境変数: `QUARKUS_LOG_FILE_JSON_EXCEPTION_OUTPUT_TYPE`	`detailed`, `formatted`, `detailed-and-formatted`	`detailed`
`quarkus.log.file.json.print-details` ログでの詳細出力を有効にします。値は呼び出し元から取得されるため、詳細の出力はリソースを多く使用する可能性があります。詳細には、ソースクラス名、ソースファイル名、ソースメソッド名、およびソース行番号が含まれます。環境変数: `QUARKUS_LOG_FILE_JSON_PRINT_DETAILS`	boolean	`false`
`quarkus.log.file.json.key-overrides` カスタム値でキーをオーバーライドします。この値を省略すると、キーはオーバーライドされません。環境変数: `QUARKUS_LOG_FILE_JSON_KEY_OVERRIDES`	string
`quarkus.log.file.json.excluded-keys` JSON 出力から除外するキー。環境変数: `QUARKUS_LOG_FILE_JSON_EXCLUDED_KEYS`	list of string
`quarkus.log.file.json.additional-field."field-name".value` 追加フィールドの値。環境変数: `QUARKUS_LOG_FILE_JSON_ADDITIONAL_FIELD__FIELD_NAME__VALUE`	string	required
`quarkus.log.file.json.additional-field."field-name".type` 追加フィールドの型指定。サポートされている型: `string`、`int`、`long`。指定されていない場合は string がデフォルトになります。環境変数: `QUARKUS_LOG_FILE_JSON_ADDITIONAL_FIELD__FIELD_NAME__TYPE`	`string`, `int`, `long`	`string`
`quarkus.log.file.json.log-format` 生成される JSON のフォーマットを指定します。環境変数: `QUARKUS_LOG_FILE_JSON_LOG_FORMAT`	`default`、`ecs`	`default`
Syslog ロギング	型	Default
`quarkus.log.syslog.json.enabled` JSON コンソールフォーマットエクステンションを有効にするかどうかを決定します。これにより、"通常の" コンソールフォーマットが無効になります。環境変数: `QUARKUS_LOG_SYSLOG_JSON_ENABLED`	boolean
`quarkus.log.syslog.json.pretty-print` JSON レコードの "プリティープリント" を有効にします。一部の JSON パーサーは、プリティープリント出力を読み取れないことに注意してください。環境変数: `QUARKUS_LOG_SYSLOG_JSON_PRETTY_PRINT`	boolean	`false`
`quarkus.log.syslog.json.date-format` 使用する日付フォーマット。"default" は特別な文字列で、デフォルトフォーマットを使用する必要があることを示します。環境変数: `QUARKUS_LOG_SYSLOG_JSON_DATE_FORMAT`	string	`default`
`quarkus.log.syslog.json.record-delimiter` 使用する特別なレコード終了区切り文字。デフォルトでは、改行が使用されます。環境変数: `QUARKUS_LOG_SYSLOG_JSON_RECORD_DELIMITER`	string
`quarkus.log.syslog.json.zone-id` 使用するゾーン ID。"default" は特別な文字列で、デフォルトのゾーンを使用する必要があることを示します。環境変数: `QUARKUS_LOG_SYSLOG_JSON_ZONE_ID`	string	`default`
`quarkus.log.syslog.json.exception-output-type` 指定する例外出力型。環境変数: `QUARKUS_LOG_SYSLOG_JSON_EXCEPTION_OUTPUT_TYPE`	`detailed`, `formatted`, `detailed-and-formatted`	`detailed`
`quarkus.log.syslog.json.print-details` ログでの詳細出力を有効にします。値は呼び出し元から取得されるため、詳細の出力はリソースを多く使用する可能性があります。詳細には、ソースクラス名、ソースファイル名、ソースメソッド名、およびソース行番号が含まれます。環境変数: `QUARKUS_LOG_SYSLOG_JSON_PRINT_DETAILS`	boolean	`false`
`quarkus.log.syslog.json.key-overrides` カスタム値でキーをオーバーライドします。この値を省略すると、キーはオーバーライドされません。環境変数: `QUARKUS_LOG_SYSLOG_JSON_KEY_OVERRIDES`	string
`quarkus.log.syslog.json.excluded-keys` JSON 出力から除外するキー。環境変数: `QUARKUS_LOG_SYSLOG_JSON_EXCLUDED_KEYS`	list of string
`quarkus.log.syslog.json.additional-field."field-name".value` 追加フィールドの値。環境変数: `QUARKUS_LOG_SYSLOG_JSON_ADDITIONAL_FIELD__FIELD_NAME__VALUE`	string	required
`quarkus.log.syslog.json.additional-field."field-name".type` 追加フィールドの型指定。サポートされている型: `string`、`int`、`long`。指定されていない場合は string がデフォルトになります。環境変数: `QUARKUS_LOG_SYSLOG_JSON_ADDITIONAL_FIELD__FIELD_NAME__TYPE`	`string`, `int`, `long`	`string`
`quarkus.log.syslog.json.log-format` 生成される JSON のフォーマットを指定します。環境変数: `QUARKUS_LOG_SYSLOG_JSON_LOG_FORMAT`	`default`、`ecs`	`default`
ソケットロギング	型	Default
`quarkus.log.socket.json.enabled` JSON コンソールフォーマットエクステンションを有効にするかどうかを決定します。これにより、"通常の" コンソールフォーマットが無効になります。環境変数: `QUARKUS_LOG_SOCKET_JSON_ENABLED`	boolean
`quarkus.log.socket.json.pretty-print` JSON レコードの "プリティープリント" を有効にします。一部の JSON パーサーは、プリティープリント出力を読み取れないことに注意してください。環境変数: `QUARKUS_LOG_SOCKET_JSON_PRETTY_PRINT`	boolean	`false`
`quarkus.log.socket.json.date-format` 使用する日付フォーマット。"default" は特別な文字列で、デフォルトフォーマットを使用する必要があることを示します。環境変数: `QUARKUS_LOG_SOCKET_JSON_DATE_FORMAT`	string	`default`
`quarkus.log.socket.json.record-delimiter` 使用する特別なレコード終了区切り文字。デフォルトでは、改行が使用されます。環境変数: `QUARKUS_LOG_SOCKET_JSON_RECORD_DELIMITER`	string
`quarkus.log.socket.json.zone-id` 使用するゾーン ID。"default" は特別な文字列で、デフォルトのゾーンを使用する必要があることを示します。環境変数: `QUARKUS_LOG_SOCKET_JSON_ZONE_ID`	string	`default`
`quarkus.log.socket.json.exception-output-type` 指定する例外出力型。環境変数: `QUARKUS_LOG_SOCKET_JSON_EXCEPTION_OUTPUT_TYPE`	`detailed`, `formatted`, `detailed-and-formatted`	`detailed`
`quarkus.log.socket.json.print-details` ログでの詳細出力を有効にします。値は呼び出し元から取得されるため、詳細の出力はリソースを多く使用する可能性があります。詳細には、ソースクラス名、ソースファイル名、ソースメソッド名、およびソース行番号が含まれます。環境変数: `QUARKUS_LOG_SOCKET_JSON_PRINT_DETAILS`	boolean	`false`
`quarkus.log.socket.json.key-overrides` カスタム値でキーをオーバーライドします。この値を省略すると、キーはオーバーライドされません。環境変数: `QUARKUS_LOG_SOCKET_JSON_KEY_OVERRIDES`	string
`quarkus.log.socket.json.excluded-keys` JSON 出力から除外するキー。環境変数: `QUARKUS_LOG_SOCKET_JSON_EXCLUDED_KEYS`	list of string
`quarkus.log.socket.json.additional-field."field-name".value` 追加フィールドの値。環境変数: `QUARKUS_LOG_SOCKET_JSON_ADDITIONAL_FIELD__FIELD_NAME__VALUE`	string	required
`quarkus.log.socket.json.additional-field."field-name".type` 追加フィールドの型指定。サポートされている型: `string`、`int`、`long`。指定されていない場合は string がデフォルトになります。環境変数: `QUARKUS_LOG_SOCKET_JSON_ADDITIONAL_FIELD__FIELD_NAME__TYPE`	`string`, `int`, `long`	`string`
`quarkus.log.socket.json.log-format` 生成される JSON のフォーマットを指定します。環境変数: `QUARKUS_LOG_SOCKET_JSON_LOG_FORMAT`	`default`、`ecs`	`default`

警告

プリティープリントを有効にすると、特定のプロセッサーや JSON パーサーが失敗する場合があります。

注記

値は呼び出し元から取得されるため、詳細の出力はリソースを多く使用する可能性があります。詳細には、ソースクラス名、ソースファイル名、ソースメソッド名、およびソース行番号が含まれます。

1.6. ログハンドラー

ログハンドラーは、ログイベントを受信者に送信するロギングコンポーネントです。Red Hat build of Quarkus には、console、file、syslog など、いくつかの異なるログハンドラーが含まれています。

ここで示す例では、ログカテゴリーとして com.example を使用しています。

1.6.1. コンソールログハンドラー

コンソールログハンドラーはデフォルトで有効になっており、すべてのログイベントをアプリケーションのコンソール (通常はシステムの stdout) に送信します。

グローバル設定の例:

quarkus.log.console.format=%d{yyyy-MM-dd HH:mm:ss} %-5p [%c] (%t) %s%e%n

カテゴリーごとの設定の例:

quarkus.log.handler.console.my-console-handler.format=%d{yyyy-MM-dd HH:mm:ss} [com.example] %s%e%n

quarkus.log.category."com.example".handlers=my-console-handler
quarkus.log.category."com.example".use-parent-handlers=false

設定の詳細は、コンソールロギング設定リファレンスを参照してください。

1.6.2. ファイルログハンドラー

アプリケーションのホスト上にあるファイルにイベントを記録するには、Quarkus ファイルログハンドラーを使用します。ファイルログハンドラーはデフォルトで無効になっており、使用する場合はまず有効にする必要があります。

Quarkus ファイルログハンドラーは、ログファイルのローテーションをサポートします。

ログファイルのローテーションにより、主要なログファイルを最新の状態に保ち、管理可能なサイズに保ちながら、一定数のバックアップファイルを保持することで、効率的なログ管理が実現します。

グローバル設定の例:

quarkus.log.file.enable=true
quarkus.log.file.path=application.log
quarkus.log.file.format=%d{yyyy-MM-dd HH:mm:ss} %-5p [%c] (%t) %s%e%n

カテゴリーごとの設定の例:

quarkus.log.handler.file.my-file-handler.enable=true
quarkus.log.handler.file.my-file-handler.path=application.log
quarkus.log.handler.file.my-file-handler.format=%d{yyyy-MM-dd HH:mm:ss} [com.example] %s%e%n

quarkus.log.category."com.example".handlers=my-file-handler
quarkus.log.category."com.example".use-parent-handlers=false

設定の詳細は、ファイルロギング設定リファレンスを参照してください。

1.6.3. Syslog ログハンドラー

Quarkus の syslog ハンドラーは、UNIX 系システムでログメッセージの送信に使用される Syslog プロトコルに準じます。RFC 5424 で定義されたプロトコルを使用します。

syslog ハンドラーは、デフォルトで無効になっています。有効にすると、すべてのログイベントが syslog サーバー (通常はアプリケーションのローカル syslog サーバー) に送信されます。

グローバル設定の例:

quarkus.log.syslog.enable=true
quarkus.log.syslog.app-name=my-application
quarkus.log.syslog.format=%d{yyyy-MM-dd HH:mm:ss} %-5p [%c] (%t) %s%e%n

カテゴリーごとの設定の例:

quarkus.log.handler.syslog.my-syslog-handler.enable=true
quarkus.log.handler.syslog.my-syslog-handler.app-name=my-application
quarkus.log.handler.syslog.my-syslog-handler.format=%d{yyyy-MM-dd HH:mm:ss} [com.example] %s%e%n

quarkus.log.category."com.example".handlers=my-syslog-handler
quarkus.log.category."com.example".use-parent-handlers=false

設定の詳細は、Syslog ロギング設定リファレンスを参照してください。

1.6.4. ソケットログハンドラー

このハンドラーはログをソケットに送信します。ソケットログハンドラーはデフォルトで無効になっています。使用するには有効にしてください。有効にすると、すべてのログイベントが Logstash サーバーなどのソケットに送信されます。

グローバル設定の例:

quarkus.log.socket.enable=true
quarkus.log.socket.endpoint=localhost:4560

通常、このハンドラーは、ECS フォーマットのログを Elasticsearch インスタンスに送信するために、quarkus-logging-json エクステンションとともに使用されます。設定例については、ログの一元管理ガイドを参照してください。

1.7. ログハンドラーにロギングフィルターを追加する

コンソールログハンドラーなどのログハンドラーは、ログレコードをログに記録するかどうかを決定するフィルターにリンクできます。

ログフィルターを登録するには、以下を実行します。

java.util.logging.Filter を実装する final クラスにアノテーション @io.quarkus.logging.LoggingFilter を追加し、name プロパティーを設定します。
フィルターの作成例:
```
package com.example;

import io.quarkus.logging.LoggingFilter;
import java.util.logging.Filter;
import java.util.logging.LogRecord;

@LoggingFilter(name = "my-filter")
public final class TestFilter implements Filter {

    private final String part;

    public TestFilter(@ConfigProperty(name = "my-filter.part") String part) {
        this.part = part;
    }

    @Override
    public boolean isLoggable(LogRecord record) {
        return !record.getMessage().contains(part);
    }
}
```
この例では、特定のテキストを含むログレコードをコンソールログから除外しています。フィルターする特定のテキストはハードコーディングされず、my-filter.part 設定プロパティーから読み込まれます。
application.properties でフィルターを設定する例:
```
my-filter.part=TEST
```
application.properties にある filter 設定プロパティーを使用して、対応するハンドラーにフィルターを割り当てます。
```
quarkus.log.console.filter=my-filter
```

1.8. ロギング設定の例

以下に、Red Hat build of Quarkus でロギングを設定する方法の例をいくつか示します。

Quarkus ログ (INFO) 以外のコンソール DEBUG ロギング、色なし、時間短縮、カテゴリー接頭辞の短縮

quarkus.log.console.format=%d{HH:mm:ss} %-5p [%c{2.}] (%t) %s%e%n
quarkus.log.console.level=DEBUG
quarkus.console.color=false

quarkus.log.category."io.quarkus".level=INFO

注記

これらのプロパティーをコマンドラインに追加する場合は、" がエスケープされていることを確認してください。たとえば、-Dquarkus.log.category.\"io.quarkus\".level=DEBUG です。

ファイル TRACE ロギング設定

quarkus.log.file.enable=true
# Send output to a trace.log file under the /tmp directory
quarkus.log.file.path=/tmp/trace.log
quarkus.log.file.level=TRACE
quarkus.log.file.format=%d{HH:mm:ss} %-5p [%c{2.}] (%t) %s%e%n
# Set 2 categories (io.quarkus.smallrye.jwt, io.undertow.request.security) to TRACE level
quarkus.log.min-level=TRACE
quarkus.log.category."io.quarkus.smallrye.jwt".level=TRACE
quarkus.log.category."io.undertow.request.security".level=TRACE

注記

ここではルートロガーを変更していないため、コンソールログには INFO またはそれ以上のレベルのログのみが含まれます。

カテゴリーに割り当てられた名前付きハンドラー

# Send output to a trace.log file under the /tmp directory
quarkus.log.file.path=/tmp/trace.log
quarkus.log.console.format=%d{HH:mm:ss} %-5p [%c{2.}] (%t) %s%e%n
# Configure a named handler that logs to console
quarkus.log.handler.console."STRUCTURED_LOGGING".format=%e%n
# Configure a named handler that logs to file
quarkus.log.handler.file."STRUCTURED_LOGGING_FILE".enable=true
quarkus.log.handler.file."STRUCTURED_LOGGING_FILE".format=%e%n
# Configure the category and link the two named handlers to it
quarkus.log.category."io.quarkus.category".level=INFO
quarkus.log.category."io.quarkus.category".handlers=STRUCTURED_LOGGING,STRUCTURED_LOGGING_FILE

ルートロガーに割り当てられた名前付きハンドラー

# configure a named file handler that sends the output to 'quarkus.log'
quarkus.log.handler.file.CONSOLE_MIRROR.enable=true
quarkus.log.handler.file.CONSOLE_MIRROR.path=quarkus.log
# attach the handler to the root logger
quarkus.log.handlers=CONSOLE_MIRROR

1.9. ログの一元管理

場所を一元化することで、アプリケーションのさまざまなコンポーネントやインスタンスからログデータを効率的に収集、保存、分析できます。

Graylog、Logstash、Fluentd などの集約型ツールにログを送信する場合は、Quarkus ログの一元管理ガイドを参照してください。

1.9.1. OpenTelemetry ロギング

OpenTelemetry ロギングを使用すると、すべてのアペンダーからのロギングエントリーを送信できます。

詳細は、Quarkus の OpenTelemetry Logging ガイドを参照してください。

1.10. `@QuarkusTest` のロギング設定

@QuarkusTest の適切なロギングを有効化するには、java.util.logging.manager システムプロパティーを org.jboss.logmanager.LogManager に設定します。

システムプロパティーを有効にするには、早い段階で設定する必要があるため、ビルドシステム内で設定することが推奨されます。

Maven Surefire プラグイン設定で java.util.logging.manager システムプロパティーを設定する:

<build>
  <plugins>
    <plugin>
      <artifactId>maven-surefire-plugin</artifactId>
      <version>${surefire-plugin.version}</version>
      <configuration>
        <systemPropertyVariables>
          <java.util.logging.manager>org.jboss.logmanager.LogManager</java.util.logging.manager> 1
          <quarkus.log.level>DEBUG</quarkus.log.level>  2
          <maven.home>${maven.home}</maven.home>
        </systemPropertyVariables>
      </configuration>
    </plugin>
  </plugins>
</build>

1: 必ず org.jboss.logmanager.LogManager を使用してください。
2: すべてのロギングカテゴリーのデバッグロギングを有効にします。

Gradle の場合、次の設定を build.gradle ファイルに追加します。

test {
	systemProperty "java.util.logging.manager", "org.jboss.logmanager.LogManager"
}

Running @QuarkusTest from an IDE も参照してください。

1.11. 他のロギング API を使用する

Red Hat build of Quarkus は、すべてのロギング要件に関して JBoss Logging ライブラリーに依存しています。

Apache Commons Logging、Log4j、SLF4J などの他のロギングライブラリーに依存するライブラリーを使用すると想定します。その場合は、それらを依存関係から除外し、いずれかの JBoss Logging アダプターを使用します。

ネイティブ実行可能ファイルのコンパイル時に以下のような問題が発生する可能性があるため、これはネイティブ実行可能ファイルをビルドする場合に特に重要です。

Caused by java.lang.ClassNotFoundException: org.apache.commons.logging.impl.LogFactoryImpl

ロギングの実装はネイティブ実行可能ファイルに含まれませんが、JBoss Logging アダプターを使用してこの問題を解決できます。

次の章で説明するように、これらのアダプターは一般的なオープンソースのロギングコンポーネントで利用できます。

1.11.1. アプリケーションにロギングアダプターを追加する

jboss-logging 以外の各ロギング API では、以下を実行します。

ロギングアダプターライブラリーを追加して、これらの API 経由でログに記録されたメッセージが JBoss Log Manager バックエンドにルーティングされるようにします。
注記
この手順は、エクステンションが自動的に処理する Quarkus エクステンションの依存関係であるライブラリーには不要です。
- Apache Commons Logging:
  - Maven を使用:
    <dependency> <groupId>org.jboss.logging</groupId> <artifactId>commons-logging-jboss-logging</artifactId> </dependency>
  - Gradle を使用する場合:
    implementation("org.jboss.logging:commons-logging-jboss-logging")
- Log4j:
  - Maven を使用:
    <dependency> <groupId>org.jboss.logmanager</groupId> <artifactId>log4j-jboss-logmanager</artifactId> </dependency>
  - Gradle を使用する場合:
    implementation("org.jboss.logmanager:log4j-jboss-logmanager")
- Log4j 2:
  - Maven を使用:
    <dependency> <groupId>org.jboss.logmanager</groupId> <artifactId>log4j2-jboss-logmanager</artifactId> </dependency>
  - Gradle を使用:
    implementation("org.jboss.logmanager:log4j2-jboss-logmanager")
    注記
    log4j2-jboss-logmanager ライブラリーには、Log4j をロギング実装として使用するために必要なものがすべて含まれているため、Log4j の依存関係を含めないでください。
- SLF4J:
  - Maven を使用:
    <dependency> <groupId>org.jboss.slf4j</groupId> <artifactId>slf4j-jboss-logmanager</artifactId> </dependency>
  - Gradle を使用する場合:
    implementation("org.jboss.slf4j:slf4j-jboss-logmanager")
追加されたライブラリーが生成したログが、他の Quarkus ログと同じフォーマットになっているか確認します。

1.11.2. MDC を使用してコンテキストログ情報を追加する

Quarkus は、リアクティブコアとの互換性を高めるために、ロギングの Mapped Diagnostic Context (MDC) をオーバーライドします。

1.11.2.1. MDC データの追加と読み取り

MDC にデータを追加し、ログ出力で展開するには以下を実行します。

MDC クラスを使用してデータを設定します。

import org.jboss.logmanager.MDC; を追加します。

以下の例に示すように、MDC.put(…) を設定します。

JBoss Logging と io.quarkus.logging.Log の例

package me.sample;

import io.quarkus.logging.Log;
import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import org.jboss.logmanager.MDC;

import java.util.UUID;

@Path("/hello/jboss")
public class GreetingResourceJbossLogging {

    @GET
    @Path("/test")
    public String greeting() {
        MDC.put("request.id", UUID.randomUUID().toString());
        MDC.put("request.path", "/hello/test");
        Log.info("request received");
        return "hello world!";
    }
}

%X{mdc-key} を使用するようにログフォーマットを設定します。

quarkus.log.console.format=%d{HH:mm:ss} %-5p request.id=%X{request.id} request.path=%X{request.path} [%c{2.}] (%t) %s%n

結果のメッセージには MDC データが含まれます。

08:48:13 INFO request.id=c37a3a36-b7f6-4492-83a1-de41dbc26fe2 request.path=/hello/test [me.sa.GreetingResourceJbossLogging] (executor-thread-1) request received

1.11.2.2. MDC とサポートされるロギング API

ロギング API に応じて、次のいずれかの MDC クラスを使用します。

Log4j 1 - org.apache.log4j.MDC.put(key, value)
Log4j 2 - org.apache.logging.log4j.ThreadContext.put(key, value)
SLF4J - org.slf4j.MDC.put(key, value)

1.11.2.3. MDC の伝播

Quarkus では、MDC プロバイダーにはリアクティブコンテキストを処理するための特定の実装があるため、MDC データはリアクティブな非同期処理中に確実に伝播されます。

その結果、さまざまなシナリオで引き続き MDC データにアクセスできます。

非同期呼び出しの後、たとえば REST クライアントが Uni を返した場合。
org.eclipse.microprofile.context.ManagedExecutor. に送信されたコード内にて。
vertx.executeBlocking() で実行されるコード内にて。

注記

該当する場合、MDC データは 複製されたコンテキスト に保存されます。これは、単一のタスクまたはリクエストを処理するための分離されたコンテキストです。

1.12. ロギング設定リファレンス

lock ビルド時に固定された設定プロパティー: その他の設定プロパティーはすべて実行時にオーバーライドできます。

設定プロパティー	型	デフォルト
`quarkus.log.metrics.enabled` これが有効で、かつメトリクスエクステンションが存在する場合、ロギングメトリクスが公開されます。環境変数: `QUARKUS_LOG_METRICS_ENABLED`	boolean	`false`
`quarkus.log.min-level` デフォルトの最小ログレベル。環境変数: `QUAARKUS_LOG_MIN_LEVEL`	レベル	`DEBUG`
`quarkus.log.decorate-stacktraces` これにより、開発モードでスタックトレースがデコレートされ、例外の原因となったコード行が表示されます。環境変数: `QUARKUS_LOG_DECORATE_STACKTRACES`	boolean	`true`
`quarkus.log.level` ルートカテゴリーのログレベル。これは、すべてのカテゴリーのデフォルトのログレベルとして使用されます。<p>JBoss Logging は、Apache スタイルのログレベルをサポートしています。<p> * {@<p> * {@link org.jboss.logmanager.Level#FATAL} * {@link org.jboss.logmanager.Level#ERROR} * {@link org.jboss.logmanager.Level#WARN} * {@link org.jboss.logmanager.Level#INFO} * {@link org.jboss.logmanager.Level#DEBUG} * {@link org.jboss.logmanager.Level#TRACE} 標準の JDK ログレベルもサポートします。環境変数: `QUARKUS_LOG_LEVEL`	レベル	`INFO`
`quarkus.log.handlers` ルートカテゴリーにリンクする追加のハンドラーの名前。これらのハンドラーは、consoleHandlers、fileHandlers、または syslogHandlers で定義されます。環境変数: `QUARKUS_LOG_HANDLERS`	list of string
最小ロギングカテゴリー	型	デフォルト
`quarkus.log.category."categories".min-level` このカテゴリーの最小ログレベル。デフォルトでは、すべてのカテゴリーで最小レベルが `DEBUG` に設定されています。実行時のロギングを `DEBUG` より下のレベル (`TRACE` など) にするには、ビルド時に最小レベルを調整します。実行時に適切なログレベルを指定する必要があります。たとえば、`TRACE` ログを取得するには、最小レベルを `TRACE` にし、実行時のログレベルをそれに一致させる必要があります。環境変数: `QUARKUS_LOG_CATEGORY__CATEGORIES__MIN_LEVEL`	InheritableLevel	`inherit`
`quarkus.log.category."categories".level` このカテゴリーのログレベル。 `INFO` 未満のログレベルを取得するには、ビルド時の最小レベル設定オプションも調整する必要があることに注意してください。環境変数: `QUARKUS_LOG_CATEGORY__CATEGORIES__LEVEL`	InheritableLevel	`inherit`
`quarkus.log.category."categories".handlers` このカテゴリーにリンクするハンドラーの名前。環境変数: `QUARKUS_LOG_CATEGORY__CATEGORIES__HANDLERS`	list of string
`quarkus.log.category."categories".use-parent-handlers` このロガーが出力を親ロガーに送信するかどうかを指定します。環境変数: `QUARKUS_LOG_CATEGORY__CATEGORIES__USE_PARENT_HANDLERS`	boolean	`true`
コンソールロギング	型	デフォルト
`quarkus.log.console.enable` ファイルロギングを有効にする必要があるかどうか。環境変数: `QUARKUS_LOG_CONSOLE_ENABLE`	boolean	`true`
`quarkus.log.console.stderr` コンソールロギングを、`System#out` ではなく `System#err` にする場合。環境変数: `QUARKUS_LOG_CONSOLE_STDERR`	boolean	`false`
`quarkus.log.console.format` ログフォーマット。コンソールフォーマットを制御するエクステンション (XML または JSON フォーマットのエクステンションなど) が存在する場合、この値は無視されることに注意してください。環境変数: `QUARKUS_LOG_CONSOLE_FORMAT`	string	`%d{yyyy-MM-dd HH:mm:ss,SSS} %-5p [%c{3.}] (%t) %s%e%n`
`quarkus.log.console.level` コンソールのログレベル。環境変数: `QUARKUS_LOG_CONSOLE_LEVEL`	レベル	`ALL`
`quarkus.log.console.darken` 色をどの程度暗くするかを指定します。コンソールフォーマットを制御するエクステンション (XML または JSON フォーマットのエクステンションなど) が存在する場合、この値は無視されることに注意してください。環境変数: `QUARKUS_LOG_CONSOLE_DARKEN`	int	`0`
`quarkus.log.console.filter` コンソールハンドラーにリンクするフィルターの名前。環境変数: `QUARKUS_LOG_CONSOLE_FILTER`	string
`quarkus.log.console.async` 非同期でログを記録するかどうかを示します。環境変数: `QUARKUS_LOG_CONSOLE_ASYNC`	boolean	`false`
`quarkus.log.console.async.queue-length` 書き込みをフラッシュする前に使用するキューの長さ。環境変数: `QUARKUS_LOG_CONSOLE_ASYNC_QUEUE_LENGTH`	int	`512`
`quarkus.log.console.async.overflow` キューが制限に達した場合に、(メッセージをドロップするのではなく) パブリッシャーをブロックするかどうかを決定します。環境変数: `QUARKUS_LOG_CONSOLE_ASYNC_OVERFLOW`	`block`, `discard`	`block`
ファイルロギング	型	デフォルト
`quarkus.log.file.enable` ファイルロギングを有効にする必要があるかどうか。環境変数: `QUARKUS_LOG_FILE_ENABLE`	boolean	`false`
`quarkus.log.file.format` ログフォーマット環境変数: `QUARKUS_LOG_FILE_FORMAT`	string	`%d{yyyy-MM-dd HH:mm:ss,SSS} %h %N[%i] %-5p [%c{3.}] (%t) %s%e%n`
`quarkus.log.file.level` ファイルに書き込まれるログのレベル。環境変数: `QUARKUS_LOG_FILE_LEVEL`	レベル	`ALL`
`quarkus.log.file.path` ログが書き込まれるファイルの名前。環境変数: `QUARKUS_LOG_FILE_PATH`	ファイル	`quarkus.log`
`quarkus.log.file.filter` ファイルハンドラーにリンクするフィルターの名前。環境変数: `QUARKUS_LOG_FILE_FILTER`	string
`quarkus.log.file.encoding` 使用される文字エンコーディング環境変数: `QUARKUS_LOG_FILE_ENCODING`	Charset
`quarkus.log.file.async` 非同期でログを記録するかどうかを示します。環境変数: `QUARKUS_LOG_FILE_ASYNC`	boolean	`false`
`quarkus.log.file.async.queue-length` 書き込みをフラッシュする前に使用するキューの長さ。環境変数: `QUARKUS_LOG_FILE_ASYNC_QUEUE_LENGTH`	int	`512`
`quarkus.log.file.async.overflow` キューが制限に達した場合に、(メッセージをドロップするのではなく) パブリッシャーをブロックするかどうかを決定します。環境変数: `QUARKUS_LOG_FILE_ASYNC_OVERFLOW`	`block`, `discard`	`block`
`quarkus.log.file.rotation.max-file-size` 到達した場合にローテーションが実行されるログファイル最大サイズ。ファイルがローテーションされるのは、ログレコードが書き込まれた後であることに注意してください。したがって、これはファイルサイズの厳密な最大値ではなく、ローテーション前のファイルサイズの厳密な最小値です。環境変数: `QUARKUS_LOG_FILE_ROTATION_MAX_FILE_SIZE`	MemorySize	`10 M`
`quarkus.log.file.rotation.max-backup-index` 保持するバックアップの最大数。環境変数: `QUARKUS_LOG_FILE_ROTATION_MAX_BACKUP_INDEX`	int	`5`
`quarkus.log.file.rotation.file-suffix` ファイルハンドラーローテーションファイルの接尾辞。使用すると、ファイルはその接尾辞に基づきローテーションされます。接尾辞は、`DateTimeFormatter` が認識できる日付と時刻のフォーマットである必要があります。 fileSuffix の例: .yyyy-MM-dd 注記: 接尾辞が .zip または .gz で終わる場合、ローテーションファイルも圧縮されます。環境変数: `QUARKUS_LOG_FILE_ROTATION_FILE_SUFFIX`	string
`quarkus.log.file.rotation.rotate-on-boot` サーバーの初期化時にログファイルをローテーションするかどうかを示します。これが機能するには、`max-file-size` か `file-suffix` を設定する必要があります。環境変数: `QUARKUS_LOG_FILE_ROTATION_ROTATE_ON_BOOT`	boolean	`true`
Syslog ロギング	型	デフォルト
`quarkus.log.syslog.enable` syslog ロギングを有効にする必要があるかどうか。環境変数: `QUARKUS_LOG_SYSLOG_ENABLE`	boolean	`false`
`quarkus.log.syslog.endpoint` Syslog サーバーの IP アドレスとポート。環境変数: `QUARKUS_LOG_SYSLOG_ENDPOINT`	host:port	`localhost:514`
`quarkus.log.syslog.app-name` メッセージを RFC5424 フォーマットでフォーマットするときに使用されるアプリケーション名。環境変数: `QUARKUS_LOG_SYSLOG_APP_NAME`	string
`quarkus.log.syslog.hostname` メッセージ送信元のホスト名。環境変数: `QUARKUS_LOG_SYSLOG_HOSTNAME`	string
`quarkus.log.syslog.facility` RFC-5424 および RFC-3164 で定義されるとおり、メッセージの優先度を計算する際に使用するファシリティーを設定します。環境変数: `QUARKUS_LOG_SYSLOG_FACILITY`	`kernel`, `user-level`, `mail-system`, `system-daemons`, `security`, `syslogd`, `line-printer`, `network-news`, `uucp`, `clock-daemon`, `security2`, `ftp-daemon`, `ntp`, `log-audit`, `log-alert`, `clock-daemon2`, `local-use-0`, `local-use-1`, `local-use-2`, `local-use-3`, `local-use-4`, `local-use-5`, `local-use-6`, `local-use-7`	`user-level`
`quarkus.log.syslog.syslog-type` このハンドラーが送信メッセージのフォーマットに使用する `SyslogType syslog type` を設定します。環境変数: `QUARKUS_LOG_SYSLOG_SYSLOG_TYPE`	`rfc5424`, `rfc3164`	`rfc5424`
`quarkus.log.syslog.protocol` Syslog サーバーへの接続に使用するプロトコルを設定します。環境変数: `QUARKUS_LOG_SYSLOG_PROTOCOL`	`tcp`, `udp`, `ssl-tcp`	`tcp`
`quarkus.log.syslog.use-counting-framing` 有効にすると、送信されるメッセージの先頭にメッセージのサイズが付加されます。環境変数: `QUARKUS_LOG_SYSLOG_USE_COUNTING_FRAMING`	boolean	`false`
`quarkus.log.syslog.truncate` `true` に設定すると、メッセージが最大長を超えた場合に切り捨てます。環境変数: `QUARKUS_LOG_SYSLOG_TRUNCATE`	boolean	`true`
`quarkus.log.syslog.block-on-reconnect` `Protocol#TCP TCP` または `Protocol#SSL_TCP SSL TCP` プロトコルへの再接続を試行するときにブロックを有効または無効にします。環境変数: `QUARKUS_LOG_SYSLOG_BLOCK_ON_RECONNECT`	boolean	`false`
`quarkus.log.syslog.format` ログメッセージのフォーマット。環境変数: `QUARKUS_LOG_SYSLOG_FORMAT`	string	`%d{yyyy-MM-dd HH:mm:ss,SSS} %-5p [%c{3.}] (%t) %s%e%n`
`quarkus.log.syslog.level` Syslog ロガーによって記録されるメッセージレベルを指定するログレベル。環境変数: `QUARKUS_LOG_SYSLOG_LEVEL`	レベル	`ALL`
`quarkus.log.syslog.filter` ファイルハンドラーにリンクするフィルターの名前。環境変数: `QUARKUS_LOG_SYSLOG_FILTER`	string
`quarkus.log.syslog.max-length` 送信可能なメッセージの最大長 (バイト単位)。長さには、ヘッダーとメッセージが含まれます。設定されていない場合、`sys-log-type` が `rfc5424` (デフォルト) の場合はデフォルト値は `2048`、`sys-log-type` が `rfc3164` の場合は `1024` になります。環境変数: `QUARKUS_LOG_SYSLOG_MAX_LENGTH`	MemorySize
`quarkus.log.syslog.async` 非同期でログを記録するかどうかを示します。環境変数: `QUARKUS_LOG_SYSLOG_ASYNC`	boolean	`false`
`quarkus.log.syslog.async.queue-length` 書き込みをフラッシュする前に使用するキューの長さ。環境変数: `QUARKUS_LOG_SYSLOG_ASYNC_QUEUE_LENGTH`	int	`512`
`quarkus.log.syslog.async.overflow` キューが制限に達した場合に、(メッセージをドロップするのではなく) パブリッシャーをブロックするかどうかを決定します。環境変数: `QUARKUS_LOG_SYSLOG_ASYNC_OVERFLOW`	`block`, `discard`	`block`
ソケットロギング	型	Default
`quarkus.log.socket.enable` ソケットロギングを有効にするかどうか。環境変数: `QUARKUS_LOG_SOCKET_ENABLE`	boolean	`false`
`quarkus.log.socket.endpoint` ログを受信するサーバーの IP アドレスとポート。環境変数: `QUARKUS_LOG_SOCKET_ENDPOINT`	host:port	`localhost:4560`
`quarkus.log.socket.protocol` Syslog サーバーへの接続に使用するプロトコルを設定します。環境変数: `QUARKUS_LOG_SOCKET_PROTOCOL`	`tcp`, `udp`, `ssl-tcp`	`tcp`
`quarkus.log.socket.block-on-reconnect` `Protocol#TCP TCP` または `Protocol#SSL_TCP SSL TCP` プロトコルへの再接続を試行するときにブロックを有効または無効にします。環境変数: `QUARKUS_LOG_SOCKET_BLOCK_ON_RECONNECT`	boolean	`false`
`quarkus.log.socket.format` ログメッセージのフォーマット。環境変数: `QUARKUS_LOG_SOCKET_FORMAT`	string	`%d{yyyy-MM-dd HH:mm:ss,SSS} %-5p [%c{3.}] (%t) %s%e%n`
`quarkus.log.socket.level` ソケットロガーによって記録されるメッセージレベルを指定するログレベル。環境変数: `QUARKUS_LOG_SOCKET_LEVEL`	レベル	`ALL`
`quarkus.log.socket.filter` ファイルハンドラーにリンクするフィルターの名前。環境変数: `QUARKUS_LOG_SOCKET_FILTER`	string
`quarkus.log.socket.async` 非同期でログを記録するかどうかを示します。環境変数: `QUARKUS_LOG_SOCKET_ASYNC`	boolean	`false`
`quarkus.log.socket.async.queue-length` 書き込みをフラッシュする前に使用するキューの長さ。環境変数: `QUARKUS_LOG_SOCKET_ASYNC_QUEUE_LENGTH`	int	`512`
`quarkus.log.socket.async.overflow` キューが制限に達した場合に、(メッセージをドロップするのではなく) パブリッシャーをブロックするかどうかを決定します。環境変数: `QUARKUS_LOG_SOCKET_ASYNC_OVERFLOW`	`block`, `discard`	`block`
コンソールハンドラー	型	デフォルト
`quarkus.log.handler.console."console-handlers".enable` ファイルロギングを有効にする必要があるかどうか。環境変数: `QUARKUS_LOG_HANDLER_CONSOLE__CONSOLE_HANDLERS__ENABLE`	boolean	`true`
`quarkus.log.handler.console."console-handlers".stderr` コンソールロギングを、`System#out` ではなく `System#err` にする場合。環境変数: `QUARKUS_LOG_HANDLER_CONSOLE__CONSOLE_HANDLERS__STDERR`	boolean	`false`
`quarkus.log.handler.console."console-handlers".format` ログフォーマット。コンソールフォーマットを制御するエクステンション (XML または JSON フォーマットのエクステンションなど) が存在する場合、この値は無視されることに注意してください。環境変数: `QUARKUS_LOG_HANDLER_CONSOLE__CONSOLE_HANDLERS__FORMAT`	string	`%d{yyyy-MM-dd HH:mm:ss,SSS} %-5p [%c{3.}] (%t) %s%e%n`
`quarkus.log.handler.console."console-handlers".level` コンソールのログレベル。環境変数: `QUARKUS_LOG_HANDLER_CONSOLE__CONSOLE_HANDLERS__LEVEL`	レベル	`ALL`
`quarkus.log.handler.console."console-handlers".darken` 色をどの程度暗くするかを指定します。コンソールフォーマットを制御するエクステンション (XML または JSON フォーマットのエクステンションなど) が存在する場合、この値は無視されることに注意してください。環境変数: `QUARKUS_LOG_HANDLER_CONSOLE__CONSOLE_HANDLERS__DARKEN`	int	`0`
`quarkus.log.handler.console."console-handlers".filter` コンソールハンドラーにリンクするフィルターの名前。環境変数: `QUARKUS_LOG_HANDLER_CONSOLE__CONSOLE_HANDLERS__FILTER`	string
`quarkus.log.handler.console."console-handlers".async` 非同期でログを記録するかどうかを示します。環境変数: `QUARKUS_LOG_HANDLER_CONSOLE__CONSOLE_HANDLERS__ASYNC`	boolean	`false`
`quarkus.log.handler.console."console-handlers".async.queue-length` 書き込みをフラッシュする前に使用するキューの長さ。環境変数: `QUARKUS_LOG_HANDLER_CONSOLE__CONSOLE_HANDLERS__ASYNC_QUEUE_LENGTH`	int	`512`
`quarkus.log.handler.console."console-handlers".async.overflow` キューが制限に達した場合に、(メッセージをドロップするのではなく) パブリッシャーをブロックするかどうかを決定します。環境変数: `QUARKUS_LOG_HANDLER_CONSOLE__CONSOLE_HANDLERS__ASYNC_OVERFLOW`	`block`, `discard`	`block`
ファイルハンドラー	型	デフォルト
`quarkus.log.handler.file."file-handlers".enable` ファイルロギングを有効にする必要があるかどうか。環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__ENABLE`	boolean	`false`
`quarkus.log.handler.file."file-handlers".format` ログフォーマット環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__FORMAT`	string	`%d{yyyy-MM-dd HH:mm:ss,SSS} %h %N[%i] %-5p [%c{3.}] (%t) %s%e%n`
`quarkus.log.handler.file."file-handlers".level` ファイルに書き込まれるログのレベル。環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__LEVEL`	レベル	`ALL`
`quarkus.log.handler.file."file-handlers".path` ログが書き込まれるファイルの名前。環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__PATH`	ファイル	`quarkus.log`
`quarkus.log.handler.file."file-handlers".filter` ファイルハンドラーにリンクするフィルターの名前。環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__FILTER`	string
`quarkus.log.handler.file."file-handlers".encoding` 使用される文字エンコーディング環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__ENCODING`	Charset
`quarkus.log.handler.file."file-handlers".async` 非同期でログを記録するかどうかを示します。環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__ASYNC`	boolean	`false`
`quarkus.log.handler.file."file-handlers".async.queue-length` 書き込みをフラッシュする前に使用するキューの長さ。環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__ASYNC_QUEUE_LENGTH`	int	`512`
`quarkus.log.handler.file."file-handlers".async.overflow` キューが制限に達した場合に、(メッセージをドロップするのではなく) パブリッシャーをブロックするかどうかを決定します。環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__ASYNC_OVERFLOW`	`block`, `discard`	`block`
`quarkus.log.handler.file."file-handlers".rotation.max-file-size` 到達した場合にローテーションが実行されるログファイル最大サイズ。ファイルがローテーションされるのは、ログレコードが書き込まれた後であることに注意してください。したがって、これはファイルサイズの厳密な最大値ではなく、ローテーション前のファイルサイズの厳密な最小値です。環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__ROTATION_MAX_FILE_SIZE`	MemorySize	`10 M`
`quarkus.log.handler.file."file-handlers".rotation.max-backup-index` 保持するバックアップの最大数。環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__ROTATION_MAX_BACKUP_INDEX`	int	`5`
`quarkus.log.handler.file."file-handlers".rotation.file-suffix` ファイルハンドラーローテーションファイルの接尾辞。使用すると、ファイルはその接尾辞に基づきローテーションされます。接尾辞は、`DateTimeFormatter` が認識できる日付と時刻のフォーマットである必要があります。 fileSuffix の例: .yyyy-MM-dd 注記: 接尾辞が .zip または .gz で終わる場合、ローテーションファイルも圧縮されます。環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__ROTATION_FILE_SUFFIX`	string
`quarkus.log.handler.file."file-handlers".rotation.rotate-on-boot` サーバーの初期化時にログファイルをローテーションするかどうかを示します。これが機能するには、`max-file-size` か `file-suffix` を設定する必要があります。環境変数: `QUARKUS_LOG_HANDLER_FILE__FILE_HANDLERS__ROTATION_ROTATE_ON_BOOT`	boolean	`true`
Syslog ハンドラー	型	デフォルト
`quarkus.log.handler.syslog."syslog-handlers".enable` syslog ロギングを有効にする必要があるかどうか。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__ENABLE`	boolean	`false`
`quarkus.log.handler.syslog."syslog-handlers".endpoint` Syslog サーバーの IP アドレスとポート。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__ENDPOINT`	host:port	`localhost:514`
`quarkus.log.handler.syslog."syslog-handlers".app-name` メッセージを RFC5424 フォーマットでフォーマットするときに使用されるアプリケーション名。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__APP_NAME`	string
`quarkus.log.handler.syslog."syslog-handlers".hostname` メッセージ送信元のホスト名。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__HOSTNAME`	string
`quarkus.log.handler.syslog."syslog-handlers".facility` RFC-5424 および RFC-3164 で定義されるとおり、メッセージの優先度を計算する際に使用するファシリティーを設定します。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__FACILITY`	`kernel`, `user-level`, `mail-system`, `system-daemons`, `security`, `syslogd`, `line-printer`, `network-news`, `uucp`, `clock-daemon`, `security2`, `ftp-daemon`, `ntp`, `log-audit`, `log-alert`, `clock-daemon2`, `local-use-0`, `local-use-1`, `local-use-2`, `local-use-3`, `local-use-4`, `local-use-5`, `local-use-6`, `local-use-7`	`user-level`
`quarkus.log.handler.syslog."syslog-handlers".syslog-type` このハンドラーが送信メッセージのフォーマットに使用する `SyslogType syslog type` を設定します。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__SYSLOG_TYPE`	`rfc5424`, `rfc3164`	`rfc5424`
`quarkus.log.handler.syslog."syslog-handlers".protocol` Syslog サーバーへの接続に使用するプロトコルを設定します。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__PROTOCOL`	`tcp`, `udp`, `ssl-tcp`	`tcp`
`quarkus.log.handler.syslog."syslog-handlers".use-counting-framing` 有効にすると、送信されるメッセージの先頭にメッセージのサイズが付加されます。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__USE_COUNTING_FRAMING`	boolean	`false`
`quarkus.log.handler.syslog."syslog-handlers".truncate` `true` に設定すると、メッセージが最大長を超えた場合に切り捨てます。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__TRUNCATE`	boolean	`true`
`quarkus.log.handler.syslog."syslog-handlers".block-on-reconnect` `Protocol#TCP TCP` または `Protocol#SSL_TCP SSL TCP` プロトコルへの再接続を試行するときにブロックを有効または無効にします。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__BLOCK_ON_RECONNECT`	boolean	`false`
`quarkus.log.handler.syslog."syslog-handlers".format` ログメッセージのフォーマット。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__FORMAT`	string	`%d{yyyy-MM-dd HH:mm:ss,SSS} %-5p [%c{3.}] (%t) %s%e%n`
`quarkus.log.handler.syslog."syslog-handlers".level` Syslog ロガーによって記録されるメッセージレベルを指定するログレベル。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__LEVEL`	レベル	`ALL`
`quarkus.log.handler.syslog."syslog-handlers".filter` ファイルハンドラーにリンクするフィルターの名前。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__FILTER`	string
`quarkus.log.handler.syslog."syslog-handlers".max-length` 送信可能なメッセージの最大長 (バイト単位)。長さには、ヘッダーとメッセージが含まれます。設定されていない場合、`sys-log-type` が `rfc5424` (デフォルト) の場合はデフォルト値は `2048`、`sys-log-type` が `rfc3164` の場合は `1024` になります。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__MAX_LENGTH`	MemorySize
`quarkus.log.handler.syslog."syslog-handlers".async` 非同期でログを記録するかどうかを示します。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__ASYNC`	boolean	`false`
`quarkus.log.handler.syslog."syslog-handlers".async.queue-length` 書き込みをフラッシュする前に使用するキューの長さ。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__ASYNC_QUEUE_LENGTH`	int	`512`
`quarkus.log.handler.syslog."syslog-handlers".async.overflow` キューが制限に達した場合に、(メッセージをドロップするのではなく) パブリッシャーをブロックするかどうかを決定します。環境変数: `QUARKUS_LOG_HANDLER_SYSLOG__SYSLOG_HANDLERS__ASYNC_OVERFLOW`	`block`, `discard`	`block`
Socket ハンドラー	型	Default
`quarkus.log.handler.socket."socket-handlers".enable` ソケットロギングを有効にするかどうか。環境変数: `QUARKUS_LOG_HANDLER_SOCKET__SOCKET_HANDLERS__ENABLE`	boolean	`false`
`quarkus.log.handler.socket."socket-handlers".endpoint` ログを受信するサーバーの IP アドレスとポート。環境変数: `QUARKUS_LOG_HANDLER_SOCKET__SOCKET_HANDLERS__ENDPOINT`	host:port	`localhost:4560`
`quarkus.log.handler.socket."socket-handlers".protocol` Syslog サーバーへの接続に使用するプロトコルを設定します。環境変数: `QUARKUS_LOG_HANDLER_SOCKET__SOCKET_HANDLERS__PROTOCOL`	`tcp`, `udp`, `ssl-tcp`	`tcp`
`quarkus.log.handler.socket."socket-handlers".block-on-reconnect` `Protocol#TCP TCP` または `Protocol#SSL_TCP SSL TCP` プロトコルへの再接続を試行するときにブロックを有効または無効にします。環境変数: `QUARKUS_LOG_HANDLER_SOCKET__SOCKET_HANDLERS__BLOCK_ON_RECONNECT`	boolean	`false`
`quarkus.log.handler.socket."socket-handlers".format` ログメッセージのフォーマット。環境変数: `QUARKUS_LOG_HANDLER_SOCKET__SOCKET_HANDLERS__FORMAT`	string	`%d{yyyy-MM-dd HH:mm:ss,SSS} %-5p [%c{3.}] (%t) %s%e%n`
`quarkus.log.handler.socket."socket-handlers".level` ソケットロガーによって記録されるメッセージレベルを指定するログレベル。環境変数: `QUARKUS_LOG_HANDLER_SOCKET__SOCKET_HANDLERS__LEVEL`	レベル	`ALL`
`quarkus.log.handler.socket."socket-handlers".filter` ファイルハンドラーにリンクするフィルターの名前。環境変数: `QUARKUS_LOG_HANDLER_SOCKET__SOCKET_HANDLERS__FILTER`	string
`quarkus.log.handler.socket."socket-handlers".async` 非同期でログを記録するかどうかを示します。環境変数: `QUARKUS_LOG_HANDLER_SOCKET__SOCKET_HANDLERS__ASYNC`	boolean	`false`
`quarkus.log.handler.socket."socket-handlers".async.queue-length` 書き込みをフラッシュする前に使用するキューの長さ。環境変数: `QUARKUS_LOG_HANDLER_SOCKET__SOCKET_HANDLERS__ASYNC_QUEUE_LENGTH`	int	`512`
`quarkus.log.handler.socket."socket-handlers".async.overflow` キューが制限に達した場合に、(メッセージをドロップするのではなく) パブリッシャーをブロックするかどうかを決定します。環境変数: `QUARKUS_LOG_HANDLER_SOCKET__SOCKET_HANDLERS__ASYNC_OVERFLOW`	`block`, `discard`	`block`
ログクリーンアップフィルター - 内部使用	型	デフォルト
`quarkus.log.filter."filters".if-starts-with` 照合するメッセージの接頭辞。環境変数: `QUARKUS_LOG_FILTER__FILTERS__IF_STARTS_WITH`	文字列のリスト	`inherit`
`quarkus.log.filter."filters".target-level` フィルタリングされたメッセージの新しいログレベル。デフォルトは DEBUG です。環境変数: `QUARKUS_LOG_FILTER__FILTERS__TARGET_LEVEL`	レベル	`DEBUG`

MemorySize フォーマットについて

サイズ設定オプションは、[0-9]+[KkMmGgTtPpEeZzYy]? (正規表現で表記) というフォーマットの文字列を認識します。

接尾辞が指定されていない場合は、バイトとみなされます。

法律上の通知

The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.

Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.

Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

ロギング設定

Red Hat build of Quarkus ドキュメントへのフィードバックの提供

第1章 ロギング設定

1.1. JBoss Logging を使用するアプリケーションロギング

1.2. アプリケーションロガーの取得

1.2.1. ロガーフィールドを宣言する

1.2.2. ロギングを簡素化する

1.2.3. 設定されたロガーを注入する

1.3. ログレベルの使用

1.4. ログレベル、カテゴリー、フォーマットの設定

1.4.1. ロギングカテゴリー

1.4.2. ルートロガー設定

1.5. ロギングフォーマット

1.5.1. 代替のコンソールロギングフォーマット

1.5.1.1. JSON ロギングフォーマット

1.5.1.1.1. 設定

1.6. ログハンドラー

1.6.1. コンソールログハンドラー

1.6.2. ファイルログハンドラー

1.6.3. Syslog ログハンドラー

1.6.4. ソケットログハンドラー

1.7. ログハンドラーにロギングフィルターを追加する

1.8. ロギング設定の例

1.9. ログの一元管理

1.9.1. OpenTelemetry ロギング

1.10. @QuarkusTest のロギング設定

1.11. 他のロギング API を使用する

1.11.1. アプリケーションにロギングアダプターを追加する

1.11.2. MDC を使用してコンテキストログ情報を追加する

1.11.2.1. MDC データの追加と読み取り

1.11.2.2. MDC とサポートされるロギング API

1.11.2.3. MDC の伝播

1.12. ロギング設定リファレンス

法律上の通知

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第1章ロギング設定

1.10. `@QuarkusTest` のロギング設定