+ core: add a clock-sampler, fix ordered-sampler, add unit tests for samplers

1 files changed, 9 insertions, 4 deletions

diff --git a/kamon-core/src/main/resources/reference.conf b/kamon-core/src/main/resources/reference.conf
index c78d56cd..b3adbe83 100644
--- a/kamon-core/src/main/resources/reference.conf
+++ b/kamon-core/src/main/resources/reference.conf
@@ -87,15 +87,15 @@ kamon {
 
   trace {
 
-    # Level of detail used when recording trace information. The posible values are:
+    # Level of detail used when recording trace information. The possible values are:
     #  - metrics-only: metrics for all included traces and all segments are recorded, but no Trace messages will be sent
-    #    to the subscriptors of trace data.
+    #    to the subscribers of trace data.
     #  - simple-trace: metrics for all included traces and all segments are recorded and additionally a Trace message
     #    containing the trace and segments details and metadata.
     level-of-detail = metrics-only
 
-    # Sampling strategy to apply when the tracing level is set to `simple-trace`. The options are: all, random, ordered
-    # and threshold. The details of each sampler are bellow.
+    # Sampling strategy to apply when the tracing level is set to `simple-trace`. The options are: all, random, ordered,
+    # threshold and clock. The details of each sampler are below.
     sampling = random
 
     # Use a ThreadLocalRandom to generate numbers between 1 and 100, if the random number is less or equal to .chance
@@ -120,6 +120,11 @@ kamon {
       minimum-elapsed-time = 1 second
     }
 
+    # Use a FiniteDuration to only record a trace each .pause nanoseconds.
+    clock-sampler {
+      pause = 1 second
+    }
+
     incubator {
       # Minimum time to stay in the trace incubator before checking if the trace should not be incubated anymore. No
       # checks are made at least until this period has passed.