Documentation
Sponsored by Kamino

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 according to application creation instructions.

To add the kamon-spm dependency to your build take into account:

  • Group ID: io.kamon
  • Package ID: kamon-spm
  • Scala Versions: 2.10 / 2.11 / 2.12
  • Latest Version: Maven Central.

Configuration

SPM backend extension requires the property kamon.spm.token to be defined. SPM provides reports for akka-actor, akka-router, akka-dispatcher, system-metrics, trace and other categories. You should define all required categories under kamon.util.filters.

kamon {
    util.filters{
      ...
    }
    spm {
      token = "[place-token-here]"
    }
    reporters = ["kamon.spm.SPMReporter"]
  }

To see a full example of Kamon SPM Backend configuration look at application.conf in sample Akka/Play 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:

System:

Custom:

Traces: