aboutsummaryrefslogtreecommitdiff
path: root/kamon-statsd/src/main/scala/kamon/statsd/Statsd.scala
diff options
context:
space:
mode:
Diffstat (limited to 'kamon-statsd/src/main/scala/kamon/statsd/Statsd.scala')
-rw-r--r--kamon-statsd/src/main/scala/kamon/statsd/Statsd.scala110
1 files changed, 110 insertions, 0 deletions
diff --git a/kamon-statsd/src/main/scala/kamon/statsd/Statsd.scala b/kamon-statsd/src/main/scala/kamon/statsd/Statsd.scala
new file mode 100644
index 00000000..0ded1394
--- /dev/null
+++ b/kamon-statsd/src/main/scala/kamon/statsd/Statsd.scala
@@ -0,0 +1,110 @@
+/*
+ * =========================================================================================
+ * Copyright © 2013-2014 the kamon project <http://kamon.io/>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the
+ * License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+ * either express or implied. See the License for the specific language governing permissions
+ * and limitations under the License.
+ * =========================================================================================
+ */
+
+package kamon.statsd
+
+import akka.actor._
+import kamon.Kamon
+import kamon.metrics._
+import scala.concurrent.duration._
+import scala.collection.JavaConverters._
+import akka.util.ByteString
+import com.typesafe.config.Config
+import java.lang.management.ManagementFactory
+
+object StatsD extends ExtensionId[StatsDExtension] with ExtensionIdProvider {
+ override def lookup(): ExtensionId[_ <: Extension] = StatsD
+ override def createExtension(system: ExtendedActorSystem): StatsDExtension = new StatsDExtension(system)
+
+
+ trait MetricKeyGenerator {
+ def generateKey(groupIdentity: MetricGroupIdentity, metricIdentity: MetricIdentity): String
+ }
+
+ sealed trait Metric {
+ def key: String
+ def value: Double
+ def suffix: String
+ def samplingRate: Double
+
+ /*
+ * Creates the stats string to send to StatsD.
+ * For counters, it provides something like {@code key:value|c}.
+ * For timing, it provides something like {@code key:millis|ms}.
+ * If sampling rate is less than 1, it provides something like {@code key:value|type|@rate}
+ */
+ def toByteString: ByteString =
+ if(samplingRate >= 1D)
+ ByteString(s"$key:$value|$suffix")
+ else
+ ByteString(s"$key:$value|$suffix|@$samplingRate")
+ }
+
+ case class Counter(key: String, value: Double = 1D, samplingRate: Double = 1.0) extends Metric {
+ val suffix: String = "c"
+ }
+
+ case class Timing(key: String, value: Double, samplingRate: Double = 1.0) extends Metric {
+ val suffix: String = "ms"
+ }
+
+ case class Gauge(key: String, value: Double, samplingRate: Double = 1.0) extends Metric {
+ val suffix: String = "g"
+ }
+
+ case class MetricBatch(metrics: Iterable[Metric])
+}
+
+
+class StatsDExtension(system: ExtendedActorSystem) extends Kamon.Extension {
+ private val statsDConfig = system.settings.config.getConfig("kamon.statsd")
+
+ val hostname = statsDConfig.getString("hostname")
+ val port = statsDConfig.getInt("port")
+ val flushInterval = statsDConfig.getMilliseconds("flush-interval")
+ val maxPacketSize = statsDConfig.getInt("max-packet-size")
+ val tickInterval = system.settings.config.getMilliseconds("kamon.metrics.tick-interval")
+
+ val statsDMetricsListener = buildMetricsListener(tickInterval, flushInterval)
+
+ val includedActors = statsDConfig.getStringList("includes.actor").asScala
+ for(actorPathPattern <- includedActors) {
+ Kamon(Metrics)(system).subscribe(ActorMetrics, actorPathPattern, statsDMetricsListener, permanently = true)
+ }
+
+
+ def buildMetricsListener(tickInterval: Long, flushInterval: Long): ActorRef = {
+ assert(flushInterval >= tickInterval, "StatsD flush-interval needs to be equal or greater to the tick-interval")
+
+ val metricsTranslator = system.actorOf(StatsDMetricTranslator.props, "statsd-metrics-translator")
+ if(flushInterval == tickInterval) {
+ // No need to buffer the metrics, let's go straight to the metrics translator.
+ metricsTranslator
+ } else {
+ system.actorOf(TickMetricSnapshotBuffer.props(flushInterval.toInt.millis, metricsTranslator), "statsd-metrics-buffer")
+ }
+ }
+}
+
+
+class SimpleMetricKeyGenerator(config: Config) extends StatsD.MetricKeyGenerator {
+ val application = config.getString("kamon.statsd.simple-metric-key-generator.application")
+ val localhostName = ManagementFactory.getRuntimeMXBean.getName.split('@')(1)
+
+ def generateKey(groupIdentity: MetricGroupIdentity, metricIdentity: MetricIdentity): String =
+ application + "." + localhostName + "." + groupIdentity.category.name + "." + groupIdentity.name + "." + metricIdentity.name
+}
+