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");

   Copy to Clipboard Toggle word wrap
   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 或 SLF4J jars 包含在应用程序的依赖项中。

   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

   Copy to Clipboard Toggle word wrap

2. 查看日志：

   1. 使用您的应用程序获取 pod 的名称：

      $ oc get pods

      Copy to Clipboard Toggle word wrap

   2. 开始监视日志输出：

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

      Copy to Clipboard Toggle word wrap

      保持打开日志输出的终端窗口，以便您可以观察日志输出。

3. 与应用程序交互：

   例如，以下命令基于一个示例 REST API 级别 0 应用程序，其中 debug logging 设置为在 /api/greeting 方法中记录 消息 变量：

   1. 获取应用程序的路由：

      $ oc get routes

      Copy to Clipboard Toggle word wrap

   2. 在应用程序的 /api/greeting 端点上发出 HTTP 请求：

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

      Copy to Clipboard Toggle word wrap

4. 返回到包含 Pod 日志的窗口，并检查日志中的调试日志消息。

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

   Copy to Clipboard Toggle word wrap
5. 要禁用 debug 日志记录，请更新日志记录配置文件，如 src/main/resources/vertx-default-jul-logging.properties，删除您的类的日志配置并重新部署您的应用程序。