Java APM on Linux
  • Updated on 15 Nov 2019
  • 1 minute to read
  • Contributors
  • Print
  • Share
  • Dark

Java APM on Linux

  • Print
  • Share
  • Dark

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


Follow the Retrace Linux Install Guide.

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:

Configure Application

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

stackify.application=My Java Application 

Restart Your Web Server
After modifying your configuration, you must now restart your application server.
Was this article helpful?