ログ記録

ロガーを構成する

ロガーを構成するには、SLF4J にバインドされたロギング フレームワークの構成システムを使用する必要があります。

次の例は、ロギング フレームワークの構成システムを使用してロガーのログレベルを設定する方法を示しています。

ロガーのログ レベルは、ロガーがメッセージを出力するのに必要なメッセージの緊急度の下限を指定します。

ロガー名

ロガーは、さまざまなログ イベントを整理するためにロガー名を使用します。ロガー名は階層を形成する文字列です。ロガーの名前の後に続く "." が他のロガーの名前のプレフィックスである場合、そのロガーは他のロガーの祖先です。例えば、"grandparent" は "grandparent.parent" の祖先であり、 は "grandparent.parent.child" の祖先です。

具体的な例として、コード内のロガー階層は次のようになります。

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
...
Logger logger_parent = LoggerFactory.getLogger("parent");
Logger logger_child = LoggerFactory.getLogger("parent.child");

ロガーは祖先のロガーのプロパティを継承し、独自のロガーを定義することができます。これは、Java のクラス継承に似ていると考えることができます。

Java Reactive Streams ドライバーは、ドライバー内の様々なログイベントを整理するために、次のロガー名を定義します。

• org.mongodb.driver.authenticator: 認証

• org.mongodb.driver.client: MongoClient インスタンスに関連するイベント

• org.mongodb.driver.cluster: MongoDB 配置のモニタリング

• org.mongodb.driver.connection: 接続と接続プール

• org.mongodb.driver.connection.tls: TLS/SSL

• org.mongodb.driver.operation: 自動再試行に関連するログ記録を含む操作

• org.mongodb.driver.protocol.command: MongoDB配置に送信されたコマンドとそこから受信された応答

• org.mongodb.driver.uri: 接続文字列の解析

• org.mongodb.driver.management: Java Management Extensions (JMX)

<configuration>
   <appender name="CONSOLE"
             class="ch.qos.logback.core.ConsoleAppender">
      <encoder>
         <pattern>
               %-4relative [%thread] %-5level %logger{30} - %msg%n
         </pattern>
      </encoder>
   </appender>
   <logger name="org.mongodb.driver.connection" level="INFO" additivity="true"/>
   <root level="OFF">
      <appender-ref ref="CONSOLE" />
   </root>
</configuration>

MongoClient mongoClient = MongoClients.create("<connection URI>");
MongoDatabase database = mongoClient.getDatabase("<database>");
MongoCollection<Document> collection = database.getCollection("<collection>");
Flux.from(collection.find()).blockFirst();

...
829  [cluster-rtt-ClusterId{value='<some value>', description='null'}-<your connection URI>] INFO  org.mongodb.driver.connection - Opened connection [connectionId{localValue:2, serverValue:<your server value>}] to <your connection uri>
977  [main] INFO  org.mongodb.driver.connection - Opened connection [connectionId{localValue:7, serverValue:<your server value>}] to <your connection uri>

ロガーを構成する

ロガーを構成するには、SLF4J にバインドされたロギング フレームワークの構成システムを使用する必要があります。

次の例は、ロギング フレームワークの構成システムを使用してロガーのログレベルを設定する方法を示しています。

ロガーのログ レベルは、ロガーがメッセージを出力するのに必要なメッセージの緊急度の下限を指定します。

ロガー名

ロガーは、さまざまなログ イベントを整理するためにロガー名を使用します。ロガー名は階層を形成する文字列です。ロガーの名前の後に続く "." が他のロガーの名前のプレフィックスである場合、そのロガーは他のロガーの祖先です。例えば、"grandparent" は "grandparent.parent" の祖先であり、 は "grandparent.parent.child" の祖先です。

具体的な例として、コード内のロガー階層は次のようになります。

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
...
Logger logger_parent = LoggerFactory.getLogger("parent");
Logger logger_child = LoggerFactory.getLogger("parent.child");

ロガーは祖先のロガーのプロパティを継承し、独自のロガーを定義することができます。これは、Java のクラス継承に似ていると考えることができます。

Java Reactive Streams ドライバーは、ドライバー内の様々なログイベントを整理するために、次のロガー名を定義します。

• org.mongodb.driver.authenticator: 認証

• org.mongodb.driver.client: MongoClient インスタンスに関連するイベント

• org.mongodb.driver.cluster: MongoDB 配置のモニタリング

• org.mongodb.driver.connection: 接続と接続プール

• org.mongodb.driver.connection.tls: TLS/SSL

• org.mongodb.driver.operation: 自動再試行に関連するログ記録を含む操作

• org.mongodb.driver.protocol.command: MongoDB配置に送信されたコマンドとそこから受信された応答

• org.mongodb.driver.uri: 接続文字列の解析

• org.mongodb.driver.management: Java Management Extensions (JMX)

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="INFO">
   <Appenders>
      <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
      </Console>
   </Appenders>
   <Loggers>
      <Logger name="org.mongodb.driver.connection" level="INFO"/>
      <Root level="OFF">
            <AppenderRef ref="Console"/>
      </Root>
   </Loggers>
</Configuration>

MongoClient mongoClient = MongoClients.create("<connection URI>");
MongoDatabase database = mongoClient.getDatabase("<database>");
MongoCollection<Document> collection = database.getCollection("<collection>");
Flux.from(collection.find()).blockFirst();

...
15:40:23.005 [cluster-ClusterId{value='<some value>', description='null'}-<your connection uri>] INFO  org.mongodb.driver.connection - Opened connection [connectionId{localValue:3, serverValue:<your server value>}] to <your connection uri>
15:40:23.159 [main] INFO  org.mongodb.driver.connection - Opened connection [connectionId{localValue:7, serverValue:<your server value>}] to <your connection uri>