Java version support

The Lightbend platform documentation provides information on the minimum supported Java versions. Lightbend guarantees Telemetry support for Java versions 8 and 11 (current LTS versions).

Unsupported Java versions

By default, Telemetry will emit a warning and will not attempt to instrument bytecode when loaded under Java versions other than 8 or 11. The error will look like this:

[Cinnamon] !! Java version 10 is not officially supported by Telemetry. Telemetry expects one of the following versions: 1.8, 11

Forcing instrumentation

You can force Telemetry to attempt instrumentation by adding force=true to your Telemetry Java agent parameters, details of configuring the agent under different build systems can be found in the Setup section.

sbt

You can specify the cinnamonArguments sbt setting to provide force=true to your Telemetry agent:

  • cinnamonArguments := "force=true"

Maven

Under maven, you can modify the <argument> tag that loads the Telemetry agent:

  • <argument>-javaagent:${project.build.directory}/dependency/cinnamon-agent.jar=force=true</argument>

Gradle

Under gradle you can modify the jvmArgs attribute that loads the Telemetry agent:

  • jvmArgs "-javaagent:${configurations.agent.singleFile}=force=true"