Metrics Integration for OkHttp (Parent)

Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/

License	Apache 2.0
Categories	Metrics Application Testing & Monitoring Monitoring
GroupId	com.raskasa.metrics
ArtifactId	metrics-okhttp-parent
Last Version	0.4.0
Release Date	Nov 10, 2017
Type	pom
Description	Metrics Integration for OkHttp (Parent) Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/
Source Code Management	https://github.com/raskasa/metrics-okhttp

Download metrics-okhttp-parent

Filename	Size
metrics-okhttp-parent-0.4.0.pom	3 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.raskasa.metrics/metrics-okhttp-parent/ -->
<dependency>
    <groupId>com.raskasa.metrics</groupId>
    <artifactId>metrics-okhttp-parent</artifactId>
    <version>0.4.0</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.raskasa.metrics/metrics-okhttp-parent/
implementation 'com.raskasa.metrics:metrics-okhttp-parent:0.4.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.raskasa.metrics/metrics-okhttp-parent/
implementation ("com.raskasa.metrics:metrics-okhttp-parent:0.4.0")

Apache Buildr

'com.raskasa.metrics:metrics-okhttp-parent:pom:0.4.0'

Apache Ivy

<dependency org="com.raskasa.metrics" name="metrics-okhttp-parent" rev="0.4.0">
  <artifact name="metrics-okhttp-parent" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.raskasa.metrics', module='metrics-okhttp-parent', version='0.4.0')
)

Scala SBT

libraryDependencies += "com.raskasa.metrics" % "metrics-okhttp-parent" % "0.4.0"

Leiningen

[com.raskasa.metrics/metrics-okhttp-parent "0.4.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

• metrics-okhttp
• sample

Metrics Integration for OkHttp

An OkHttp HTTP client wrapper providing Metrics instrumentation of connection pools, request durations and rates, and other useful information.

Usage

Metrics Integration for OkHttp provides InstrumentedOkHttpClients, a static factory class for instrumenting OkHttp HTTP clients.

You can create an instrumented OkHttpClient by doing the following:

MetricRegistry registry = ...;
OkHttpClient client = InstrumentedOkHttpClients.create(registry);

If you wish to provide your own OkHttpClient instance, you can do that as well:

MetricRegistry registry = ...;
OkHttpClient rawClient = ...;
OkHttpClient client = InstrumentedOkHttpClients.create(registry, rawClient);

If you use more than one OkHttpClient instance in your application, you may want to provide a custom name when instrumenting the clients in order to properly distinguish them:

MetricRegistry registry = ...;
OkHttpClient client = InstrumentedOkHttpClients.create(registry, "custom-name");

MetricRegistry registry = ...;
OkHttpClient rawClient = ...;
OkHttpClient client = InstrumentedOkHttpClients.create(registry, rawClient, "custom-name");

An instrumented OkHttp HTTP client provides the following metrics:

okhttp3.OkHttpClient.cache-request-count
okhttp3.OkHttpClient.cache-hit-count
okhttp3.OkHttpClient.cache-network-count
okhttp3.OkHttpClient.cache-current-size
okhttp3.OkHttpClient.cache-max-size
okhttp3.OkHttpClient.cache-size
okhttp3.OkHttpClient.cache-write-success-count
okhttp3.OkHttpClient.cache-write-abort-count
okhttp3.OkHttpClient.connection-pool-count
okhttp3.OkHttpClient.connection-pool-count-http
okhttp3.OkHttpClient.connection-pool-count-multiplexed
okhttp3.OkHttpClient.network-requests-completed
okhttp3.OkHttpClient.network-requests-duration
okhttp3.OkHttpClient.network-requests-running
okhttp3.OkHttpClient.network-requests-submitted

If you provide a custom name for the instrumented client (i.e. custom-name), the metrics will have the following format:

...
okhttp3.OkHttpClient.custom-name.cache-write-success-count
okhttp3.OkHttpClient.custom-name.cache-write-abort-count
okhttp3.OkHttpClient.custom-name.connection-pool-count
...

Download

Metrics Integration for OkHttp is currently under development. The API is not stable and neither is the feature set.

Download the latest jar or depend on Maven:

<dependency>
  <groupId>com.raskasa.metrics</groupId>
  <artifactId>metrics-okhttp</artifactId>
  <version>0.4.0</version>
</dependency>

or Gradle:

compile 'com.raskasa.metrics:metrics-okhttp:0.4.0'

Snapshots of the development version are available in Sonatype's snapshots repository.

License

Copyright 2015 Ras Kasa Williams

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Versions

Version
0.4.0 Nov 10, 2017
0.2.0 Dec 15, 2015
0.1.0 Jul 22, 2015