Play

Lightbend Telemetry is capable of capturing data for the following Play related features for Play 2.6 and above, when using the default Akka HTTP server in Play.

Note: Cinnamon supports Play 2.6 and greater.

Cinnamon Play module dependency

After adding the Cinnamon Agent as described in the setup, make sure that you add the Cinnamon Play module dependency to your build file:

sbt
libraryDependencies += Cinnamon.library.cinnamonPlay
Maven
<dependency>
  <groupId>com.lightbend.cinnamon</groupId>
  <artifactId>cinnamon-play_2.12</artifactId>
  <version>2.10.0</version>
</dependency>
Gradle
dependencies {
    compile group: 'com.lightbend.cinnamon', name: 'cinnamon-play_2.12', version: '2.10.0'
}

Play server metrics

  • Connections (rate) — the rate of connections per server.

  • Requests (rate) — the rate of requests per server.

  • Responses (rate) — the rate of responses per server.

  • Responses 2xx (rate) — the rate of responses with 200-299 status codes per server.

  • Responses 3xx (rate) — the rate of responses with 300-399 status codes per server.

  • Responses 4xx (rate) — the rate of responses with 400-499 status codes per server.

  • Responses 5xx (rate) — the rate of responses with 500-599 status codes per server.

  • Response time (recorder) — the time for responses per server.

  • Response time 2xx (recorder) — the time for responses with 200-299 status codes per server.

  • Response time 3xx (recorder) — the time for responses with 300-399 status codes per server.

  • Response time 4xx (recorder) — the time for responses with 400-499 status codes per server.

  • Response time 5xx (recorder) — the time for responses with 500-599 status codes per server.

Note: Server metrics are created automatically when the Cinnamon Play module dependency is added. It is possible to turn server metrics off via configuration.

Play server endpoint metrics

The following metrics are recorded for configured endpoints.

  • Endpoint responses (rate) — the rate of responses per endpoint.

  • Endpoint response time (recorder) — the time for responses per endpoint.

Note: By default, no metrics are created for endpoints. Play Configuration is used to instruct Cinnamon what endpoints to create metrics for.

Play client metrics

The following metrics are recorded for instrumented Play WS clients, type of metric in parentheses:

Client metrics

  • Requests (rate) — the rate of requests from a client to a service.

  • Service response time (recorder) — the time for responses from a service.

Note: By default, no metrics are created for endpoints. Play Configuration is used to instruct Cinnamon what endpoints to create metrics for.

Play request tracing

Request tracing is supported through the Cinnamon OpenTracing integration. See Play configuration for OpenTracing.

Detailed information

For specific information of how to configure Play see: