4.2. デバッグログ

1. ロギングをアプリケーションに追加するには、io.vertx.core.logging.Logger を作成します。

   Logger logger = LoggerFactory.getLogger(className);
   
   logger.info("something happened");
   logger.error("oops!", exception);
   logger.debug("debug message");
   logger.warn("warning");

   Important

   ロギングバックエンドは異なる形式を使用して、パラメーター化されたメッセージで置き換え可能なトークンを表します。パラメーター化されたロギングメソッドに依存すると、コードを変更せずにロギングバックエンドを切り替えることができません。

1. vertx.logger-delegate-factory-class-name システムプロパティーの値を LogDelegateFactory インターフェイスを実装するクラスの名前に設定します。Eclipse Vert.x は、以下のライブラリーに事前ビルドされた実装を提供し、以下のように対応する事前定義されたクラス名を提供します。

   Expand

   ライブラリー	クラス名
   Log4J v1	io.vertx.core.logging.Log4jLogDelegateFactory
   Log4J v2	io.vertx.core.logging.Log4j2LogDelegateFactory
   SLF4J	io.vertx.core.logging.SLF4JLogDelegateFactory

   Show more

   カスタムライブラリーを使用してロギングを実装する場合は、関連する Log4J jar または SLF4J jar がアプリケーションの依存関係に含まれていることを確認します。

   Important

   Eclipse Vert.x で提供される Log4J v1 委譲は、パラメーター化されたメッセージに対応していません。Log4J v2 および SLF4J の委譲はどちらも {} 構文を使用します。java.util.logging 委譲は、{n} 構文を使用する java.text.MessageFormat に依存します。

1. SLF4J
2. Log4J
3. フォールバックオプションとしての java.util.logging

手順

1. アプリケーションを OpenShift にデプロイします。

   $ mvn clean oc:deploy -Popenshift

2. ログを表示します。

   1. アプリケーションと共に Pod の名前を取得します。

      $ oc get pods

   2. ログ出力の監視を開始します。

      $ oc logs -f pod/MY_APP_NAME-2-aaaaa

      ログ出力を確認できるように、ターミナルウィンドウにログ出力が表示されます。

3. アプリケーションと対話します。

   たとえば、次のコマンドは、/api/greeting メソッドで message 変数をログに記録するようにデバッグログが設定されている REST API レベル 0 アプリケーションの例に基づいています。

   1. アプリケーションのルートを取得します。

      $ oc get routes

   2. アプリケーションの /api/greeting エンドポイントで HTTP 要求を作成します。

      $ curl $APPLICATION_ROUTE/api/greeting?name=Sarah

4. Pod ログのあるウィンドウに戻り、ログでデバッグロギングメッセージを検査します。

   ...
   Feb 11, 2017 10:23:42 AM io.openshift.MY_APP_NAME
   INFO: Greeting: Hello, Sarah
   ...

5. デバッグロギングを無効にするには、ロギング設定ファイル (例: src/main/resources/vertx-default-jul-logging.properties) を更新し、クラスのロギング設定を削除し、アプリケーションを再デプロイします。