The purpose of this project is to provide tests and test applications which can be used to determine the performance costs of instrumenting a Wildfly Swarm, Spring Boot, or Vert-X application using OpenTracing/Jaeger

The project includes simple example for each of these frameworks which is based on http://www.hawkular.org/blog/2017/07/opentracing-jaxrs.html and can be used to do basic performance testing. Tests can be run on a desktop, using Docker, or on OpenShift. Running in any of these environments requires the following steps:

• Start a Jaeger instance
• Build and run the desired application
• Run the JMeter test found in TestPlans/SimpleTracingTest

The test applications are very simple and each has the same 2 endpoints, singleSpan and spanWithChild The following environment variables can be used to alter the default behavior:

• TRACER_TYPE The NoopTracer will be used if this is set to any value other than "jaeger"
• TEST_SERVICE_NAME Service name to use when reporting spans to jaeger. Defaults to "framework-name-opentracing-demo", e.g. "vertx-opentracing-demo"
• JAEGER_SAMPLING_RATE Set between 0.0 and 1.0 to set the sampling rate
• JAEGER_AGENT_HOST Host the jaeger agent is running on, defaults to localhost

Apache JMeter is used for testing. Download the latest instance from http://jmeter.apache.org/download_jmeter.cgi and add it to your PATH

• Start Jaeger. The simplest way to do this is to run the Jaeger all-in-one Docker image

  • docker run -d -p5775:5775/udp -p6831:6831/udp -p6832:6832/udp -p5778:5778 -p16686:16686 -p14268:14268 jaegertracing/all-in-one:latest

• Build the example using mvn -f <framework-dir>/pom.xml clean install

• Run the application using its maven plugin or fat jar:

  • mvn -f wildfly-swarm/pom.xml wildfly-swarm:run OR java -jar wildfly-swarm/target/jaeger-performance-wildfly-swarm-app-swarm.jar
  • mvn -f spring-boot/pom.xml spring-boot:run OR java -jar spring-boot/target/jaeger-performance-spring-boot-app.jar
  • mvn -f vertx/pom.xml vertx:run OR java -jar vertx/target/jaeger-performance-vertx-app.jar

• Run the JMeter test (Options are described below)

  • jmeter --nongui --testfile TestPlans/SimpleTracingTest.jmx -JTHREADCOUNT=100 -JITERATIONS=1000 -JRAMPUP=0 -JURL=localhost -JPORT=8080 --logfile log.txt --reportatendofloadtests --reportoutputfolder reports

• Open reports/index.html in a browser to view the results

If you'd prefer, you can run any of the example applications in Docker. To do so replace the build and run steps from the previous section with these steps

• Create a docker image: mvn -f <framework>/pom.xml clean install -Pdocker
• Run the application: docker run -p 8080:8080 -eJAEGER_AGENT_HOST=${jaeger-host-ip} jaeger-performance-<framework>-app

Note that jaeger-host-ip should be the real ip of the machine where you're running Jaeger, not localhost

This section describes how to set up a Jenkins job and run the tests on an OpenShift instance. At the current time, there are hard-coded dependencies on the project name, so the first thing you'll need to do is create a project named jaeger-infra

• oc new-project jaeger-infra

Next create and configure a Jenkins instance on OpenShift. Log onto OpenShift in a browser, select the jaeger-infra project, and do the following:

• Click on Add to Project
• Select 'Continuous Integration and Deployment'
• Select Jenkins Ephemeral (Or Jenkins-Persistent if you have persistent volumes set up)
• Change the Memory Limit to at least 2048MiB
• Click Create

It may take 5 minutes or so until you can login to Jenkins.

Once you can log onto Jenkins, there are two further configuration steps

• Click on Manage Jenkins and then Global Tool Configuration
  • Add the latest JDK 8 and name it jdk8
  • Add Maven 3.5.0 and name it maven-3.5.0
• Go back to Manage Jenkins and then click on Manage Plugins
  • Go to the Available tab, enter HTML in the Filter box, select HTML Publisher plugin and then click on Install without restart
  • Go to the Updates tab, select all items (sorry, the UI for this is terrible) then click on Download now and install after restart.
  • Click on the Restart Jenkins... box when it appears.

Wait 5 minutes or so for Jenkins to restart so you can reconnect

NOTE: We need to find a better long term solution for this. Ideally, we would use the Jenkins Global Tool page to manage this in the same way as other tools like Maven and Java. However I tried the Custom Tools Plugin on my personal Jenkins instance, and it broke the Jenkins Global Tool page

For the time being the job depends on JMeter being installed in Jenkins's tools directory on the Jenkins pod. To install:

• oc login to the OpenShift instance
• oc project jaeger-infra
• oc get pods | grep jenkins
• oc rsh <jenkins-pod>
• cd /var/lib/jenkins/tools
• Download [JMeter 3.3] (http://apache.mindstudios.com/jmeter/binaries/apache-jmeter-3.3.tgz) and extract it to apache-jmeter-3.3
• ~/tools/apache-jmeter-3.3/bin/jmeter --version to validate the installation

Log back into Jenkins, and select New Item

• Enter the name Jaeger Performance, select Pipeline Script, and click OK
• Scroll down to the Pipeline section and select Pipeline script from SCM
• Select Git as the SCM and enter [email protected]:kevinearls/jaeger-instrumentation-performance-tests.git as the repository URL

To run the test click the Build with Parameters link. Change the default parameters to whatever you'd like.

NOTE: This job requires a number of parameters which are defined in the Jenkinsfile. At the time of this writing there is a bug in Jenkins where you will not see any of the parameters the first time the job is run. After the first run and subsequent failure, they should be shown on any build.

To enable proper dsiplay of the results on the Jenkins console goto "Manage Jenkins" and then to "Script Console" type in this text: System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "") and hit

Then for each build the results will be available using the Performance Report link on the left side of the page.
So far I have been unable to get the HTML Publisher Plugin to work correctly in Jenkins on OpenShift.
In order to see the full results, after running a job on Jenkins, click on the Performance Report link on the left side of page, and then click on the Zip link on the top right corner of that page. Unzip the Performance_Report.zip file that is downloaded, and then open Performance_Report/index.html in a browser to view the results.

The file Jenkinsfile.multi can be used to set off multiple runs of the main Jenkins job. Follow the instructions for creating the Jaeger Performance job above, but change the Script Path name to Jenkinsfile.multi

This job will kick off the primary job ("Jaeger Performance") multiple times, depending on options selected. If RUN_WITH_NO_TRACING is selected we will run the job once for each test example that is selected. If RUN_WITH_NOOP_TRACER or RUN_WITH_JAEGER are selected, the primary job will be run once with each tracer for each rate given in the RATES field.

To run the performance test, use the following command: jmeter --nongui --testfile TestPlans/SimpleTracingTest.jmx -JTHREADCOUNT=100 -JITERATIONS=1000 -JRAMPUP=0 -JURL=localhost -JPORT=8080 --logfile log.txt --reportatendofloadtests --reportoutputfolder reports

• THREADCOUNT is the number of client threads to run
• ITERATIONS is the number of iterations each client will make
• RAMPUP is the number of seconds taken to start all clients
• URL is the host that the wildfly-swarm app is running on. It defaults to localhost
• PORT is the port, defaults to 8080

Each iteration of the test defined in TestPlan/SimpleTracingTest.jmx will hit 2 urls, singleSpan and /spanWithChild. In addition to the variables above, there are two others that can be set to create a delay after each endpoing

• DELAY1 sets a delay after hitting /singleSpan, default is 5 milliseconds
• DELAY2 sets a delay after hitting /spanWithChild, default is 5 milliseconds