Java APM on Linux
  • 1 Minute to read
  • Dark
  • PDF

Java APM on Linux

  • Dark
  • PDF

Article summary

This document details how to install the Java APM Profiler in your Java application running on Linux.


Follow the Retrace Linux Install Guide.

Step 1 - Enable the Stackify Java Profiler

The Stackify Java Profiler is enabled by the -javaagent JVM option:


Modify or
CATALINA_OPTS="$CATALINA_OPTS -javaagent:/usr/local/stackify/stackify-java-apm/stackify-java-apm.jar"

Wildfly / JBoss

Modify standalone.conf:
JAVA_OPTS="$JAVA_OPTS -javaagent:/usr/local/stackify/stackify-java-apm/stackify-java-apm.jar"


JAVA_OPTIONS="$JAVA_OPTIONS -javaagent:/usr/local/stackify/stackify-java-apm/stackify-java-apm.jar"


Add the following line to the java-config section of the Glassfish domain.xml file:


Create a jvm.options under WEBSPHERE/usr/servers/SERVER with:

Depending on your preferences, you may configure a single JVM or all Liberty JVMs with your options file.

  • To apply these settings to a single server, save jvm.options at ${server.config.dir}/jvm.options
  • To apply these changes to all Liberty JVMs, save jvm.options at: ${wlp.install.dir}/etc/jvm.options. This will take effect for all JVMs that do not have a locally defined jvm.options file.

Play Framework 1.2.x - 1.4.x

Before running your application, enter the following command:
export JAVA_OPTS='-javaagent:/usr/local/stackify/stackify-java-apm/stackify-java-apm.jar'

Play Framework 2.x+

Run the application with the following argument:

Step 2 - Configure Application

Configure how your Java application is identified by using a properties file or passing in java system properties.

Properties File Option

Create a file inside your application's classpath with the following contents:

stackify.application=My Java Application 

Java System Properties Option

Application and Enviornment can be setup by passing in Java System Properties via:


Restart Your Web Server
After modifying your configuration, you must now restart your application server.

Was this article helpful?