[KIEKER-1298] Howto use Kieker with different Java EE containers

[rju]

JIRA Issue: KIEKER-1298 Howto use Kieker with different Java EE containers
Original Reporter: Andre van Hoorn

---

E.g.,

• Tomcat
• JBoss
• Glassfish
• WebSphere
• Jetty

[rju]

author nils-christian -- Tue, 28 May 2013 17:07:58 +0200

That would go beyond the scope of the user guide, I think. Maybe put this into the FAQ we talked about?

[rju]

author André van Hoorn -- Tue, 28 May 2013 18:52:25 +0200

Some hints on using it with JBoss: http://blog.novatec-gmbh.de/analysing-kieker-with-jboss-dvdstore-sample-application/

[rju]

author André van Hoorn -- Mon, 21 Oct 2013 16:57:42 +0200

Create Trac page

[rju]

author André van Hoorn -- Wed, 19 Feb 2014 14:33:55 +0100

Tomcat:

Thomas, Tobias: Could you please provide a brief documentation of the problems (ClassNotFound...Exception for JMSException) and solutions how to use Kieker (AspectJ, CPU/Memory etc.) with Tomcat (core point: do not use kieker-aspectj.jar as aspectagent because of classloader problems resulting from this; instead: add kieker.jar to lib/ folder and use aspectjagent as weaver)? Asking you because you probably have the console windows with the messages open and it's still in your mind.

[rju]

author André van Hoorn -- Wed, 19 Feb 2014 14:36:59 +0100

Further documentation in wiki:/howtos/KiekerInJavaEEContainers

[rju]

author André van Hoorn -- Wed, 19 Feb 2014 14:44:54 +0100

Decided to reopen because wiki:/howtos/KiekerInJavaEEContainers far from complete

[rju]

author Imported User 22 -- Wed, 19 Feb 2014 15:29:15 +0100

To be able to instrument Tomcat to monitor method calls and system load:

• Extract Tomcat
• Add following jars to lib-folder:

  
  - aspectjweaver-*.jar

  
  - kieker-1.8.jar

  
  - sigar-*.jar (required for load monitoring)

  
  - system specific sigar-files (extracted to this folder) (required for load monitoring)

• Edit bin/catalina.(sh|bat)

  Add the following option to JAVA_OPTS:

  -javaagent:${CATALINA_BASE}/lib/aspectjweaver-1.7.3.jar"
  

• Edit conf/web.xml to be able to monitor system load

  Add within

  <web-app>
  

  tags:

    <context-param>
     <param-name>CPUMemUsageServletContextListener.samplingIntervalSeconds</param-name>
     <param-value>15</param-value>
    </context-param>
  <context-param>
  
  <param-name>CPUMemUsageServletContextListener.initialSamplingDelaySeconds</param-name>
  
  <param-value>0</param-value>
  
  </context-param>
  <listener>
  
  <listener-class>
  
  kieker.monitoring.probe.servlet.CPUMemUsageServletContextListener
  
  </listener-class>
  
  </listener>
  

[rju]

author André van Hoorn -- Wed, 16 Apr 2014 10:24:36 +0200

To be considered: KIEKER-971 Done

[rju]

author André van Hoorn -- Wed, 21 May 2014 09:02:09 +0200

+ logger issue: KIEKER-638 Done