Azure SDK for Java と java.util.logging を使用してログを記録する

2025-04-04

この記事では、Azure SDK for Java を使用するアプリケーションに java.util.logging を使用してログを追加する方法の概要について説明します。 java.util.logging フレームワークは JDK の一部です。「Azure SDK for Java でのログ記録の構成」で説明したように、すべての Azure クライアントライブラリは Simple Logging Facade for Java (SLF4J) を使用してログを記録するため、java.util.loggingなどのログ記録フレームワークを使用できます。

java.util.loggingを有効にするには、次の 2 つの操作を行う必要があります。

java.util.logging用の SLF4J アダプターを依存関係として含めます。
/src/main/resources プロジェクトディレクトリの下に、logging.properties という名前のファイルを作成します。

ロガーの構成に関する詳細については、Oracle ドキュメントの「ログ出力の構成」を参照してください。

Maven 依存関係を追加する

Maven 依存関係を追加するには、プロジェクトの pom.xml ファイルに次の XML を含めます。 1.7.30 のバージョン番号を、SLF4J JDK14 バインディングページに表示されている最新のリリースバージョン番号に置き換えます。

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-jdk14</artifactId>
    <version>1.7.30</version> <!-- replace this version with the latest available version on Maven central -->
</dependency>

プロジェクトに logging.properties を追加する

を使用してログを記録するには、プロジェクトの ./src/main/resources ディレクトリまたはその他の場所に logging.properties という名前のファイルを作成します。このファイルには、ログ記録のニーズをカスタマイズするためのログ構成が含まれます。 java.util.logging.config.file システムプロパティを設定して、ファイルへのパスを指定します。ロガーインスタンスを作成する前に、このプロパティを設定する必要があります。詳細については、「Java ログ: 構成」を参照してください。

コンソールのログ記録

次の例に示すように、コンソールにログを記録する構成を作成できます。この例は、INFO レベル以上のすべてのログイベントがどこから来たかをログに記録するように構成されています。

handlers = java.util.logging.ConsoleHandler
.level = INFO

java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.SimpleFormatter.format=[%1$tF %1$tH:%1$tM:%1$tS.%1$tL] [%4$s] %3$s %5$s %n

ファイルにログを記録する

前の例ではコンソールにログが記録されますが、通常、ログを記録するのに適した場所ではありません。代わりにファイルへのログ記録を構成するには、次の構成を使用します。

handlers = java.util.logging.FileHandler
.level = INFO

java.util.logging.FileHandler.pattern = %h/myapplication.log
java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.FileHandler.level = INFO

このコードでは、ホームディレクトリ () に %h という名前のファイルが作成されます。このロガーは、一定期間後の自動ファイルローテーションをサポートしていません。この機能が必要な場合は、ログファイルのローテーションを管理するためのスケジューラを記述する必要があります。

次の手順

この記事では、java.util.logging の構成と、Azure SDK for Java でログ記録に使用する方法について説明しました。 Azure SDK for Java はすべての SLF4J ログ記録フレームワークで動作するため、詳細については、SLF4J ユーザーマニュアルを確認することを検討してください。

ログ記録を習得したら、 Azure が Spring などのフレームワークに提供する統合を調べることを検討してください。