12.2. LogEIP
概述
Apache Camel 提供了几种在路由中执行日志的方法:
-
使用
log
DSL 命令。 - 使用 Log 组件,它可以记录消息内容。
- 使用 tracer 来跟踪消息流。
-
使用
处理器或
Bean 端点执行 Java 中的日志记录。
Java DSL 示例
自 Apache Camel 2.2 起,您可以使用 log
DSL 命令在运行时使用简单表达式语言构建日志消息。例如,您可以在路由中创建日志消息,如下所示:
from("direct:start").log("Processing ${id}").to("bean:foo");
此路由在运行时构造 String
格式消息。日志消息将记录在 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 由 log
元素表示,并通过将 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>
如果您有多个日志,并且您希望在所有日志中都有相同的日志名称,则必须将配置添加到每个日志中。