Atmos is an SBT plugin that allows you to trace Akka and Play projects to help identify and fix bottlenecks.

Installation

Add the following lines to your project:

1

addSbtPlugin("com.typesafe.sbt" % "sbt-atmos" % "0.3.2")

1
2
3

atmosSettings

atmosTestSettings

Usage

1

sbt atmos:run

The Atmos UI comes up on localhost:9900.

Screenshots

Atmos has a great overview screen that shows you vital system-wide statistics.

It also allows you to drill down and dig into dispatcher-level as well as ActorSystem level stats.

And, best of all, it shows you Actor-level stats like message throughput, mailbox size over time as well as mean time spent in mailbox- which are extremely helpful when tracing bottlenecks.

I’ve put up a working project with Atmos here. It’ll run for about 5 minutes so you can explore the Atmos UI and then terminate. If you want to give it a try:

1
2
3

git clone https://github.com/sqldump/akka-atmos.git
cd akka-atmos
sbt atmos:run