Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

第3章 ランタイム設定の設定

application.properties ファイルで、ロギングレベルおよびロギングカテゴリーを設定できます。

ロギングカテゴリーは階層的です。カテゴリーのロギングレベルを設定すると、設定はそのカテゴリーのすべてのサブカテゴリーに適用されます。

ロギングレベル設定には、ロギングレベルと最小ロギングレベルの 2 つがあります。デフォルトのロギングレベルは INFO で、デフォルトの最小ロギングレベルは DEBUG です。quarkus.log.level および quarkus.log.min-level プロパティーまたはカテゴリーを使用して、グローバルで調整できます。

ロギングレベルを最小ロギングレベルより低く設定する場合は、最小ロギングレベルも調整する必要があります。そうしないと、最小ロギングレベルの値がロギングレベルをオーバーライドします。

過度のロギングは、パフォーマンスに影響を与えます。最小ロギングレベルを調整して、アプリケーションに関連するデータのみを収集できます。ログボリュームを減らすと、メモリー使用量が最適化され、アプリケーションのパフォーマンスが向上する可能性があります。たとえば、ネイティブ実行では、最小レベルにより、低いレベルのチェック (isTraceEnabled) を false に折りたたむことができます。これにより、デッドコードが削除されます。

手順

  • application.properties ファイルでロギング出力を設定します。

    src/main/resources/application.properties

    <configuration_key>=<value>
    Copy to Clipboard Toggle word wrap

    以下の例は、デフォルトのロギングレベルを INFO ロギングに設定し、Hibernate DEBUG ログを含める方法を示しています。

    src/main/resources/application.properties

    quarkus.log.level=INFO
quarkus.log.category."org.hibernate".level=DEBUG
    Copy to Clipboard Toggle word wrap

    注記

    コマンドラインで設定プロパティーを設定する場合は、" をエスケープしてください。たとえば、-Dquarkus.log.category.\"org.hibernate\".level=TRACE です。

3.1. ロギング形式の設定
リンクのコピー

Quarkus は、人間が判読できるテキストログを生成するパターンベースのロギングフォーマッターを使用します。ログエントリーには、タイムスタンプ、ロギングレベル、クラス名、スレッド ID、およびメッセージが表示されます。専用の設定プロパティーを使用して、各ログハンドラーの形式をカスタマイズできます。

前提条件

  • Quarkus Maven プロジェクトがある。

手順

  • quarkus.log.console.format の値を設定して、コンソールハンドラーを設定します。

    src/main/resources/application.properties

    quarkus.log.console.format=<logging_format_string>
    Copy to Clipboard Toggle word wrap

    src/main/resources/application.properties

    quarkus.log.console.format=%d{HH:mm:ss} %-5p [%c{2.}] (%t) %s%e%n
    Copy to Clipboard Toggle word wrap

    この設定により、ログメッセージのフォーマットは以下のようになります。 

    14:11:07 INFO  [ExampleResource] (executor-thread-199) Hello
    Copy to Clipboard Toggle word wrap

3.1.1. ロギング形式の文字列
リンクのコピー

次の表に、ログメッセージの形式を設定するために使用できるロギング形式の文字列記号を示します。

Expand
表3.1 サポートされているロギング形式の記号
Symbol概要説明

%%

%

単純な % 文字

%c

カテゴリー

カテゴリー名

%C

ソースクラス

ソースクラス名[a]

%d{xxx}

日付

java.text.SimpleDateFormat に従った、指定された日付形式文字列の日付

%e

例外

例外スタックトレース

%F

ソースファイル

ソースファイル名 [a]

%h

ホスト名

システムのシンプルなホスト名

%H

修飾ホスト名

システムの完全修飾ホスト名。OS の設定によっては、シンプルなホスト名と同じになる場合があります。

%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>}

マップされた診断コンテキスト値

マップされた診断コンテキストからの値

%X

マップされた診断コンテキスト値

{property.key=property.value} 形式のマップされた診断コンテキストからのすべての値

%x

ネスト化された診断コンテキスト値

ネスト化された診断コンテキストからのすべての値 ({value1.value2} の形式)

[a] 呼び出し元情報を調べるフォーマットシーケンスは、パフォーマンスに影響を与える可能性があります。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

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

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat