1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
Extras for JVM
===============
metrics-clojure contains some functions for instrumenting JVM metrics
Installation
------------
The extra JVM-related functionality is in a separate ``metrics-clojure-jvm``
library so its installation is optional.
To install it, add this to your ``project.clj``'s dependencies:
.. parsed-literal::
[metrics-clojure-jvm "|release|"]
Instrumenting the JVM
------------------------
The simplest way to add JVM metrics to your application is to simply call the ``instrument-jvm``
function in your code::
(require '[metrics.jvm.core :refer [instrument-jvm]])
(instrument-jvm metric-registry)
This will add a number of metrics, listed below.
``jvm.attribute``
~~~~~~~~~~~~~~~~~~~
A set of gauges for the JVM name, vendor and uptime.
``jvm.memory``
~~~~~~~~~~~~~~~~~~~
A set of gauges for JVM memory usage, include stats on
heap vs non-heap memory, plus GC-specific memory pools.
``jvm.file``
~~~~~~~~~~~~~~~~~~~
A gauge for the ratio of used to total file descriptors.
``jvm.gc``
~~~~~~~~~~~~~~~~~~~
A set of gauges for the counts and elapsed times of garbage collection.
``jvm.thread``
~~~~~~~~~~~~~~~~~~~
A set of gauges for the number of threads in their various states and deadlock detection.
If you want to add the individual gauge/metric sets that codahale's metrics-jvm library provides,
then the following functions are available::
(require '[metrics.jvm.core :as jvm])
(register-jvm-attribute-gauge-set metric-registry)
(register-memory-usage-gauge-set metric-registry)
(register-file-descriptor-ratio-gauge-set metric-registry)
(register-garbage-collector-metric-set metric-registry)
(register-thread-state-gauge-set metric-registry)
These functions also take an optional second argument
should you wish to override the metric prefix, e.g.::
(register-jvm-attribute-gauge-set metric-registry ["my" "preferred" "prefix"])
|
