= core: first simple approach to providing traces and a subscription mechanism.

1 files changed, 29 insertions, 0 deletions

diff --git a/kamon-core/src/main/resources/reference.conf b/kamon-core/src/main/resources/reference.conf
index 639d4aba..78d0900e 100644
--- a/kamon-core/src/main/resources/reference.conf
+++ b/kamon-core/src/main/resources/reference.conf
@@ -127,6 +127,35 @@ kamon {
 
   trace {
 
+    # Level of detail used when recording trace information. The posible 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.
+    #  - 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 = 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 = random
+
+    # Use a ThreadLocalRandom to generate numbers between 1 and 100, if the random number is less or equal to .chance
+    # then tracing information will be gathered and reported for the current trace.
+    random-sampler {
+      chance = 10
+    }
+
+    # Use a AtomicLong to ensure that every .sample-interval number of requests tracing information will be gathered and
+    # reported.
+    ordered-sampler {
+      sample-interval = 10
+    }
+
+    # Gather tracing information for all traces but only report those whose elapsed-time is equal or greated to the
+    # .minimum-elapsed-time setting.
+    threshold-sampler {
+      threshold = 1 second
+    }
+
     # If ask-pattern-tracing is enabled, a WARN level log message will be generated if a future generated by the `ask`
     # pattern fails with a `AskTimeoutException` and the log message will contain a stack trace captured at the moment
     # the future was created.