220.13. MetricsMessageHistoryFactory
从 Camel 2.17 开始提供
此工厂允许在路由消息时使用指标捕获消息历史性能统计信息。它的工作原理是在所有路由中使用每个节点的指标计时器。此工厂可以在 Java 和 XML 中使用,如下例所示。
从 Java,您刚刚将工厂设置为 CamelContext
,如下所示:
context.setMessageHistoryFactory(new MetricsMessageHistoryFactory());
在 XML DSL 中,您可以定义一个 <bean>,如下所示:
<!-- use camel-metrics message history to gather metrics for all messages being routed --> <bean id="metricsMessageHistoryFactory" class="org.apache.camel.component.metrics.messagehistory.MetricsMessageHistoryFactory"/>
工厂支持以下选项:
名称 | default | 描述 |
---|---|---|
useJmx | false |
是否使用 |
jmxDomain | org.apache.camel.metrics | JMX 域名 |
prettyPrint | false | 在以 json 格式输出统计信息时是否使用用户打印 |
metricsRegistry |
允许使用共享 | |
rateUnit | TimeUnit.SECONDS | 在指标报告器或将统计信息转储为 json 时用于速率的单位。 |
durationUnit | TimeUnit.MILLISECONDS | 在指标报告器中使用 for 单位,或者在将统计信息转储为 json 时。 |
namePattern |
|
要使用的名称模式。使用点作为分隔符,但您可以更改。值 |
在运行时,可以从 Java API 或 JMX 访问指标,允许以 json 输出的形式收集数据。
从 Java 代码中,您可以从 CamelContext 获取服务,如下所示:
MetricsMessageHistoryService service = context.hasService(MetricsMessageHistoryService.class); String json = service.dumpStatisticsAsJson();
和 JMX API,MBean 在 type=services
树中注册,其名称为 name=MetricsMessageHistoryService
。