SPM Integration Build Status

Gitter Maven Central

Reporting Metrics to SPM

SPM is a proactive performance monitoring solution that provides anomaly detection, alerting, transaction tracing, network topology discovery and log correlation available in the Cloud and On Premises.

Installation

Sign up. Create 'Akka' app in SPM. Get your SPM app token. Add kamon-spm dependency to your project.

Getting Started

Kamon akka-spm module is currently available for Scala 2.10, 2.11 and 2.12.

Supported releases and dependencies are shown below.

kamon-spm status jdk scala
1.1.1 stable 1.8+ 2.10, 2.11, 2.12
1.1.2 stable 1.8+ 2.10, 2.11, 2.12

To get started with SBT, simply add the following to your build.sbt file:

libraryDependencies += "io.kamon" %% "kamon-spm" % "1.1.2"

Configuration

SPM backend extension requires the property kamon.spm.token to be defined. SPM provides reports for akka-actor, akka-router, akka-dispatcher and system-metrics categories. By default all entities for given categories are included.

  kamon {
    spm {
        token = "[place-token-here]"
    }
    reporters = ["kamon.spm.SPMReporter"]
  }
  
  kamon.util.filters {
  
    "akka.tracked-actor" {
      includes = [ "**" ]
    }
  
    "akka.tracked-dispatcher" {
      includes = [ "**" ]
    }
  
    "akka.tracked-router" {
      includes = [ "**" ]
    }
  }

To see a full example of Kamon SPM Backend configuration look at application.conf in Sample Akka app with Kamon and SPM.

Note: By default this extension uses hostname resolved using InetAddress.getLocalHost.getHostName. However, hostname can be redefined using kamon.spm.hostname-alias property.

Visualisation

Overview:

Actors:

Dispatchers:

Routers:

CPU: