Skip to main content

Install Java Agent

Prerequisites

  • Java version 8 and above
  • Levo eBPF Sensor installed and running on the server. Refer to Install eBPF Sensor

Installation

  • Download the zipped file from our Downloads repo. This contains the agent jars and a shared library.

  • Copy the zipped file to the Application Server and extract the files.

  • The extracted contents should have two jar files and one shared library (.so) file:

    levo-agent-0.1.4-all.jar
    levo-agent-bootstrap-0.1.4.jar
    libnative_ioctl.so
  • In the Application Server:

    • Set the system environment variable, or pass it during program execution LIB_NATIVE_IOCTL_FILE_PATH to the absolute path of the shared library libnative_ioctl.so.
    • Start the JVM application by providing the path to the levo-agent jar using the flag:
    -javaagent:/path/to/agent-jars/levo-agent-0.1.4-all.jar
    info

    Note: If you are running a JRuby application, you can pass the agent using


    JRUBY_OPTS="-J-javaagent:/path/to/agent-jars/levo-agent-0.1.4-all.jar”

Configuration

  • Enable tracing client side traffic only
-javaagent:/path/to/agent-jars/levo-agent-0.1.4-all.jar=TraceClientTrafficOnly=true”