JFR Catalina

A Catalina Valve that generates JFR events.

License	MIT
GroupId	com.github.marschall
ArtifactId	catalina-jfr
Last Version	0.1.0
Release Date	Jun 16, 2019
Type	jar
Description	JFR Catalina A Catalina Valve that generates JFR events.
Project URL	https://github.com/marschall/catalina-jfr
Source Code Management	https://github.com/marschall/catalina-jfr

Download catalina-jfr

Filename	Size
catalina-jfr-0.1.0.pom
catalina-jfr-0.1.0.jar	7 KB
catalina-jfr-0.1.0-sources.jar	4 KB
catalina-jfr-0.1.0-javadoc.jar	395 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.marschall/catalina-jfr/ -->
<dependency>
    <groupId>com.github.marschall</groupId>
    <artifactId>catalina-jfr</artifactId>
    <version>0.1.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.marschall/catalina-jfr/
implementation 'com.github.marschall:catalina-jfr:0.1.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.marschall/catalina-jfr/
implementation ("com.github.marschall:catalina-jfr:0.1.0")

Apache Buildr

'com.github.marschall:catalina-jfr:jar:0.1.0'

Apache Ivy

<dependency org="com.github.marschall" name="catalina-jfr" rev="0.1.0">
  <artifact name="catalina-jfr" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.marschall', module='catalina-jfr', version='0.1.0')
)

Scala SBT

libraryDependencies += "com.github.marschall" % "catalina-jfr" % "0.1.0"

Leiningen

[com.github.marschall/catalina-jfr "0.1.0"]

Dependencies

provided (1)

Group / Artifact	Type	Version
org.apache.tomcat : tomcat-catalina	jar	9.0.21

test (2)

Group / Artifact	Type	Version
org.junit.jupiter : junit-jupiter	jar	5.4.2
org.hamcrest : hamcrest-junit	jar	2.0.0.0

Project Modules

There are no modules declared in this project.

Catalina JFR

A Catalina valve that generates Flight Recorder events. Unlike a filter based approach a valve based approach also generate events for internal servlets like the DefaultServlet and JasperServlet.

This project requires Java 11.

Usage

Copy the jar to ${tomcat.home}/lib and add the following valve to server.xml.

        <Valve className="com.github.marschall.catalina.jfr.JfrValve" />

Correlating Dispatches

A single request may traverse the servlet chain multiple times, either because of a server side redirect or because of asynchronous processing. We generate a unique exchangeId for every request so that multiple dispatches of the same request can be correlated.

Versions

Version
0.1.0 Jun 16, 2019