1 files changed, 14 insertions, 2 deletions

diff --git a/kamon-statsd/src/main/resources/reference.conf b/kamon-statsd/src/main/resources/reference.conf
index 522f9ca9..bd713f65 100644
--- a/kamon-statsd/src/main/resources/reference.conf
+++ b/kamon-statsd/src/main/resources/reference.conf
@@ -30,18 +30,30 @@ kamon {
     report-system-metrics = false
 
     simple-metric-key-generator {
+
       # Application prefix for all metrics pushed to StatsD. The default namespacing scheme for metrics follows
       # this pattern:
       #    application.host.entity.entity-name.metric-name
       application = "kamon"
+
       # Includes the name of the hostname in the generated metric. When set to false, the scheme for the metrics
       # will look as follows:
       #    application.entity.entity-name.metric-name
       include-hostname = true
+
       # Allow users to override the name of the hostname reported by kamon. When changed, the scheme for the metrics
       # will have the following pattern:
-      # application.myhostname.entity.entity-name.metric-name
-      hostname-override = "none"
+      #   application.hostname-override-value.entity.entity-name.metric-name
+      hostname-override = none
+
+      # When the sections that make up the metric names have special characters like dots (very common in dispatcher
+      # names) or forward slashes (all actor metrics) we need to sanitize those values before sending them to StatsD
+      # with one of the following strategies:
+      #   - normalize: changes ': ' to '-' and ' ', '/' and '.' to '_'.
+      #   - percent-encode: percent encode the section on the metric name. Please note that StatsD doesn't support
+      #     percent encoded metric names, this option is only useful if using our docker image which has a patched
+      #     version of StatsD or if you are running your own, customized version of StatsD that supports this.
+      metric-name-normalization-strategy = normalize
     }
   }
 }
\ No newline at end of file