8.17. sampling

sampling Throttler

通过抽样节流,您可以从路由中提取流量交换示例。它与一个抽样期进行配置,该期间只能通过 单个 交换。所有其他交换将被停止。

默认情况下,样本周期为 1 秒。

Java DSL 示例

使用 sample () DSL 命令调用 sampler,如下所示:

// Sample with default sampling period (1 second)
from("direct:sample")
    .sample()
    .to("mock:result");

// Sample with explicitly specified sample period
from("direct:sample-configured")
    .sample(1, TimeUnit.SECONDS)
    .to("mock:result");

// Alternative syntax for specifying sampling period
from("direct:sample-configured-via-dsl")
    .sample().samplePeriod(1).timeUnits(TimeUnit.SECONDS)
    .to("mock:result");

from("direct:sample-messageFrequency")
    .sample(10)
    .to("mock:result");

from("direct:sample-messageFrequency-via-dsl")
    .sample().sampleMessageFrequency(5)
    .to("mock:result");

Spring XML 示例

在 Spring XML 中,使用 sample 元素来调用 sampler,其中您可以选择使用 samplePeriodunits 属性指定抽样周期:

<route>
    <from uri="direct:sample"/>
    <sample samplePeriod="1" units="seconds">
        <to uri="mock:result"/>
    </sample>
</route>
<route>
    <from uri="direct:sample-messageFrequency"/>
    <sample messageFrequency="10">
        <to uri="mock:result"/>
    </sample>
</route>
<route>
    <from uri="direct:sample-messageFrequency-via-dsl"/>
    <sample messageFrequency="5">
        <to uri="mock:result"/>
    </sample>
</route>

选项

示例 DSL 命令支持以下选项:

Name

默认值

描述

messageFrequency

 

样本每条 N 消息的消息。您只能使用频率或句点。

samplePeriod

1

样本每 N 期间的消息。您只能使用频率或句点。

units

SECOND

定时器单元是 JDK 中的 java.util.concurrent.TimeUnit 的枚举。