Java version support
The Lightbend platform documentation provides information on the minimum supported Java versions. Lightbend guarantees Telemetry support for Java versions 8, 11 and 17 (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, 11 or 17. 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, 17
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"