/* * ========================================================================================= * Copyright © 2013-2014 the kamon project * * 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 }