Scala Shell
Latest commit 6149554 Dec 31, 2016 @dpsoft dpsoft relased 0.6.5
Permalink
Failed to load latest commit information.
project relased 0.6.5 Dec 31, 2016
src = kamon-scala: cross build for Scala 2.12 Dec 30, 2016
.gitignore scala moved Nov 30, 2016
.travis.yml scala moved Nov 30, 2016
CONTRIBUTING.md scala moved Nov 30, 2016
LICENSE scala moved Nov 30, 2016
README.md relased 0.6.5 Dec 31, 2016
build.sbt = kamon-scala: cross build for Scala 2.12 Dec 30, 2016
travis-test.sh scala moved Nov 30, 2016
version.sbt relased 0.6.5 Dec 31, 2016

README.md

Scala Integration

Build Status Gitter Maven Central

Getting Started

Kamon scala module is currently available for Scala 2.10, 2.11 and 2.12.

Supported releases and dependencies are shown below.

kamon-scala status jdk scala akka
0.6.5 stable 1.7+, 1.8+ 2.10, 2.11, 2.12 2.3.x, 2.4.x

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

libraryDependencies += "kamon.io" %% "kamon-scala" % "0.6.5"

Automatic TraceContext Propagation with Futures

The kamon-scala module provides bytecode instrumentation for both Scala, Scalaz and Twitter Futures that automatically propagates the TraceContext across the asynchronous operations that might be scheduled for a given Future.

The kamon-scala module require you to start your application using the AspectJ Weaver Agent. Kamon will warn you at startup if you failed to do so.

Future's Body and Callbacks

In the following piece of code, the body of the future will be executed asynchronously on some other thread provided by the ExecutionContext available in implicit scope, but Kamon will capture the TraceContext available when the future was created and make it available while executing the future's body.

Tracer.withNewContext("sample-trace") {
    // The same TraceContext available here,

    Future {
      // is available here as well.
      "Hello Kamon"

    }.map(_.length)
      .flatMap(len => Future(len.toString))
      .map(s => Tracer.currentContext)
      .map(println)
      // And through all async callbacks, even while
      // they are executed at different threads!
  }

Also, when you transform a future by using map/flatMap/filter and friends or you directly register a onComplete/onSuccess/onFailure callback on a future, Kamon will capture the TraceContext available when transforming the future and make it available when executing the given callback. The code snippet above would print the same TraceContext that was available when creating the future, during it's body execution and during the execution of all the asynchronous operations scheduled on it.