JarCasting
JarCasting JarCasting

mod-metrics

Vert.x Metrics module for JMX reporting

License

License
Categories

Categories

Metrics Application Testing & Monitoring Monitoring
GroupId

GroupId

com.bloidonia
ArtifactId

ArtifactId

mod-metrics
Last Version

Last Version

1.0.1
Release Date

Release Date
Type

Type

jar
Description

Description

mod-metrics
Vert.x Metrics module for JMX reporting
Project URL

Project URL

https://github.com/timyates/mod-metrics
Source Code Management

Source Code Management

https://github.com/timyates/mod-metrics

Download mod-metrics

Filename Size
mod-metrics-1.0.1.pom
mod-metrics-1.0.1.jar 6 KB
mod-metrics-1.0.1-sources.jar 2 KB
mod-metrics-1.0.1-mod.zip 100 KB
mod-metrics-1.0.1-javadoc.jar 31 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.bloidonia/mod-metrics/ -->
<dependency>
    <groupId>com.bloidonia</groupId>
    <artifactId>mod-metrics</artifactId>
    <version>1.0.1</version>
</dependency>
// https://jarcasting.com/artifacts/com.bloidonia/mod-metrics/
implementation 'com.bloidonia:mod-metrics:1.0.1'
// https://jarcasting.com/artifacts/com.bloidonia/mod-metrics/
implementation ("com.bloidonia:mod-metrics:1.0.1")
'com.bloidonia:mod-metrics:jar:1.0.1'
<dependency org="com.bloidonia" name="mod-metrics" rev="1.0.1">
  <artifact name="mod-metrics" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.bloidonia', module='mod-metrics', version='1.0.1')
)
libraryDependencies += "com.bloidonia" % "mod-metrics" % "1.0.1"
[com.bloidonia/mod-metrics "1.0.1"]

Dependencies

compile (1)

Group / Artifact Type Version
com.codahale.metrics : metrics-core jar 3.0.1

test (2)

Group / Artifact Type Version
io.vertx : testtools jar 2.0.3-final
junit : junit jar 4.11

Project Modules

There are no modules declared in this project.

mod-metrics

A vert.x mod to try and expose stats over JMX using the Metrics library.

Default config:

{
  address  : "com.bloidonia.metrics"
}

Deploy with:

vertx.deployModule( 'com.bloidonia~mod-metrics~1.0.0', config, 1, function() {} ) ;

You should then be able to point jconsole (or jvisualvm with the jmx plugin) at the machine running this module and see stats appear as they are populated.

The mod accepts the messages below.

Notes

  • if a metric with the specified name does not exist, then a metric of the related type is created.
  • if you try to call an invalid method on an already existing metric (ie: call set on a metric already constructed with inc) then I suspect things will blow up in (not so) interesting ways.

Gauges (see here)

NB: Only accepts Integer values

setting

{
    name   : "gauge.name",
    action : "set",
    n      : 128
}

Counters (see here)

incrementing

{
    name   : "counter.name",
    action : "inc",
    n      : 1        // Optional, defaults to 1
}

decrementing

{
    name   : "counter.name",
    action : "dec",
    n      : 1        // Optional, defaults to 1
}

Meters (see here)

mark

{
    name   : "meter.name",
    action : "mark"
}

Histograms (see here)

update

{
    name   : "histogram.name",
    action : "update",
    n      : 10
}

Timers (see here)

If you start a timer, then the Context for that timer is stored in a Map. Not stopping the timer will cause this Context to persist in-perpetuity.

Timers are also of questionable use as you are also going to be timing the event bus propagation time and any Vert.x internals between your sending the message and it being processed by this module. However if you take that to be a constant, you could say that they will show you something. It just arguable whether that something is trustworthy or consistent ;-)

start

{
    name   : "timer.name",
    action : "start"
}

stop

{
    name   : "timer.name",
    action : "stop"
}

Removal

If you want to remove a metric from the system, just send the message:

{
    name   : "metric.name",
    action : "remove"
}

Reading values over the EventBus

counters

{
    action : "counters"
}

Example response:

{
    status : "ok"
    countername : {
        count: 10
    },
    countername2 : {
        count: 15
    }
}

gauges

{
    action : "gauges"
}

Example response:

{
    status : "ok"
    gaugename : {
        value: 4
    },
    gaugename2 : {
        value: 15
    }
}

histograms

{
    action : "histograms"
}

Example response:

{
    status : "ok"
    hist1 : {
        count  : 10,
        min    : 3,
        max    : 100,
        median : 23.5,
        mean   : 32.4,
        stddev : 2.8,
        size   : 23,
        75th   : 34.5,
        95th   : 24.5,
        98th   : 14.5,
        99th   : 11.5,
        999th  : 10.2
    }
}

histograms

{
    action : "meters"
}

Example response:

{
    status : "ok"
    meter1 : {
        1m    : 2.4,
        5m    : 3.8,
        15m   : 4.2,
        count : 120,
        mean  : 3.2
    }
}

timers

{
    action : "timers"
}

Example response:

{
    status : "ok"
    timer1 : {
        1m     : 2.4,
        5m     : 3.8,
        15m    : 4.2,
        count  : 120,
        mean   : 3.2,
        count  : 10,
        min    : 3,
        max    : 100,
        median : 23.5,
        mean   : 32.4,
        stddev : 2.8,
        size   : 10,
        75th   : 34.5,
        95th   : 24.5,
        98th   : 14.5,
        99th   : 11.5,
        999th  : 10.2
    }
}

Versions

Version
1.0.1
1.0.0