12.2. LogEIP

概述

Apache Camel 提供多种在路由中执行日志记录的方法：

  • 使用 log DSL 命令。
  • 使用 Log 组件，它可以记录消息内容。
  • 使用 Tracer，跟踪消息流。
  • 使用 处理器 或 Bean 端点在 Java 中执行日志记录。
日志 DSL 命令和日志组件之间的区别

日志 DSL 更加简洁，用于记录人类日志，如 Starting to do …​。它只能根据 Simple 语言记录消息。相反，Log 组件是一个功能齐全的日志组件。Log 组件能够记录消息本身，并且有许多 URI 选项来控制日志记录。

Java DSL 示例

自 Apache Camel 2.2 起，您可以使用 log DSL 命令，在运行时使用 Simple 表达式语言构建日志消息。例如，您可以在路由中创建日志消息，如下所示： 

from("direct:start").log("Processing ${id}").to("bean:foo");

此路由在运行时 构造字符串 格式消息。日志消息记录在 INFO 级别，将路由 ID 用作日志名称。默认情况下，路由会连续命名，分别为 route-1、route-2 等。但是，您可以使用 DSL 命令 routeId("myCoolRoute") 来指定自定义路由 ID。

日志 DSL 还提供变体，可让您明确设置日志级别和日志名称。例如，要将日志记录级别明确设置为 LoggingLevel.DEBUG，您可以按照如下所示调用日志 DSL：

日志 DSL 具有超载的方法，可用于设置日志级别和/或名称。 

from("direct:start").log(LoggingLevel.DEBUG, "Processing ${id}").to("bean:foo");

要将日志名称设置为 fileRoute，您可以按照以下方法调用日志 DSL： 

from("file://target/files").log(LoggingLevel.DEBUG, "fileRoute", "Processing file ${file:name}").to("bean:foo");

XML DSL 示例

在 XML DSL 中，日志 DSL 由 日志 元素表示，日志消息通过将 message 属性设置为 Simple 表达式来指定，如下所示： 

<route id="foo">
    <from uri="direct:foo"/>
    <log message="Got ${body}"/>
    <to uri="mock:foo"/>
</route>

log 元素支持 消息、loggingLevel 和 logName 属性。例如： 

<route id="baz">
    <from uri="direct:baz"/>
    <log message="Me Got ${body}" loggingLevel="FATAL" logName="cool"/>
    <to uri="mock:baz"/>
</route>

全局日志名称

路由 ID 用作默认日志名称。自 Apache Camel 2.17 起，可以通过配置 logname 参数来更改日志名称。

Java DSL，根据以下示例配置日志名称： 

CamelContext context = ...
context.getProperties().put(Exchange.LOG_EIP_NAME, "com.foo.myapp");

在 XML 中，使用以下方法配置日志名称： 

<camelContext ...>
  <properties>
    <property key="CamelLogEipName" value="com.foo.myapp"/>
  </properties>

如果您有多个日志，且您希望在所有日志中都有相同的日志名称，您必须将配置添加到每个日志中。