8.17. sampling

sampling Throttler

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 命令示例支持以下选项:

名称

默认值

描述

messageFrequency

 

每 N 的消息示例示例。只能使用频率或周期。

示例Period

1

每 N 期示例消息。只能使用频率或周期。

单位

SECOND

从 JDK,作为 java.util.concurrent.TimeUnit 的枚举单位。