HC-JMX

Expose PoolingHttpClientConnectionManager statistics via JMX

License	MIT License
GroupId	com.testingsyndicate
ArtifactId	hc-jmx
Last Version	3.0.3
Release Date	Mar 28, 2021
Type	jar
Description	HC-JMX Expose PoolingHttpClientConnectionManager statistics via JMX
Project URL	https://github.com/goughy000/hc-jmx
Source Code Management	https://github.com/goughy000/hc-jmx.git

Download hc-jmx

Filename	Size
hc-jmx-3.0.3.pom
hc-jmx-3.0.3.jar	6 KB
hc-jmx-3.0.3-sources.jar	3 KB
hc-jmx-3.0.3-javadoc.jar	33 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.testingsyndicate/hc-jmx/ -->
<dependency>
    <groupId>com.testingsyndicate</groupId>
    <artifactId>hc-jmx</artifactId>
    <version>3.0.3</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.testingsyndicate/hc-jmx/
implementation 'com.testingsyndicate:hc-jmx:3.0.3'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.testingsyndicate/hc-jmx/
implementation ("com.testingsyndicate:hc-jmx:3.0.3")

Apache Buildr

'com.testingsyndicate:hc-jmx:jar:3.0.3'

Apache Ivy

<dependency org="com.testingsyndicate" name="hc-jmx" rev="3.0.3">
  <artifact name="hc-jmx" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.testingsyndicate', module='hc-jmx', version='3.0.3')
)

Scala SBT

libraryDependencies += "com.testingsyndicate" % "hc-jmx" % "3.0.3"

Leiningen

[com.testingsyndicate/hc-jmx "3.0.3"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.apache.httpcomponents : httpclient	jar	4.5

Project Modules

There are no modules declared in this project.

HC-JMX

JMX MXBean for Apache HttpComponents HttpClient 4.5.x

Summary

View HttpClient metrics from a PoolingHttpClientConnectionManager

• MaxTotal*
• DefaultMaxPerRoute*
• Leased
• Pending
• Available
• RoutesTotal

Metrics marked with an asterisk are read/write

Available to view via JMX compatible monitoring and profiling tools such as AppDynamics, DataDog and VisualVM

Usage

<dependency>
    <groupId>com.testingsyndicate</groupId>
    <artifactId>hc-jmx</artifactId>
    <version>...</version>
</dependency>
<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5</version>
</dependency>

// Create a PoolingHttpClientConnectionManager
PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager();

// Register it with the name "default"
HcJmx.getInstance().register(connectionManager);

// Or pass a Client directly (extracts PoolingHttpClientConnectionManager using reflection)
HttpClient client = HttpClients.custom()
    .setMaxConnPerRoute(10)
    .setMaxConnTotal(15)
    .build();

HcJmx.getInstance().register(client);

Screenshots

Metrics shown in VisualVM

License

MIT

Versions

Version
3.0.3 Mar 28, 2021
3.0.0 Nov 14, 2019
2.1.0 Nov 6, 2018
2.0.0 Oct 15, 2018
1.0.0 Sep 15, 2018
0.3 Feb 23, 2018
0.2 Feb 19, 2018
0.1 Feb 19, 2018