Skip to content

Resin¶

Installation and Configuration¶

Note: The example Resin version is for the Windows environment Resin/4.0.66 (Windows).

Metrics collection is done through jolokia-jvm-agent to gather runtime Metrics for Resin.

Enabling Metrics Collection for Resin¶

Configure config/resin.properties

Add jvm_args, parameter description:

javaagent: jolokia-jvm-agent
port=9530 # Exposed port for metrics by jolokia-jvm-agent


jvm_args  : -Xmx2048m -XX:MaxPermSize=256m -javaagent:C:/"Program Files"/datakit/data/jolokia-jvm-agent.jar=port=9530

Restart Resin

Double-click resin.exe

DataKit Collector Configuration¶

Enable the DataKit JVM plugin, copy the sample file


cd datakit/conf.d/jvm
cp jvm.conf.sample jvm.conf

Modify the jvm.conf configuration file

Main parameter descriptions:

urls: Access addresses for the jolokia agent
interval: Collection frequency
inputs.jvm.metric: JVM related Metrics


# {"version": "1.2.12", "desc": "do NOT edit this line"}
[[inputs.jvm]]
# default_tag_prefix      = ""
# default_field_prefix    = ""
# default_field_separator = "."

# username = ""
# password = ""
# response_timeout = "5s"

## Optional TLS config
# tls_ca   = "/var/private/ca.pem"
# tls_cert = "/var/private/client.pem"
# tls_key  = "/var/private/client-key.pem"
# insecure_skip_verify = false

## Monitoring Interval
interval   = "10s"

# Add agents URLs to query
urls = ["http://localhost:9530/jolokia/"]

## Add Metrics to read
[[inputs.jvm.metric]]
name  = "resin_runtime"
mbean = "java.lang:type=Runtime"
paths = ["Uptime","StartTime","VmVersion","SpecName"]

[[inputs.jvm.metric]]
name  = "resin_memory"
mbean = "java.lang:type=Memory"
paths = ["HeapMemoryUsage", "NonHeapMemoryUsage", "ObjectPendingFinalizationCount"]

[[inputs.jvm.metric]]
name     = "resin_garbage_collector"
mbean    = "java.lang:name=*,type=GarbageCollector"
paths    = ["CollectionTime", "CollectionCount"]
tag_keys = ["name"]

[[inputs.jvm.metric]]
name  = "resin_threading"
mbean = "java.lang:type=Threading"
paths = ["TotalStartedThreadCount", "ThreadCount", "DaemonThreadCount", "PeakThreadCount"]

[[inputs.jvm.metric]]
name  = "resin_class_loading"
mbean = "java.lang:type=ClassLoading"
paths = ["LoadedClassCount", "UnloadedClassCount", "TotalLoadedClassCount"]

[[inputs.jvm.metric]]
name     = "resin_memory_pool"
mbean    = "java.lang:name=*,type=MemoryPool"
paths    = ["Usage", "PeakUsage", "CollectionUsage"]
tag_keys = ["name"]

[inputs.jvm.tags]
# some_tag = "some_value"
# more_tag = "some_other_value"
  # ...

Restart DataKit (If you need to enable logging, configure log collection before restarting)

Metrics¶

Measurement Set resin_runtime¶

Metric	Description
`Uptime`	Uptime
`StartTime`	Start time
`VmVersion`	Virtual machine version
`SpecName`	Java virtual machine specification name

Measurement Set resin_memory¶

Metric	Description
`HeapMemoryUsage`	Heap memory usage
`NonHeapMemoryUsage`	Non-heap memory usage

Measurement Set resin_threading¶

Metric	Description
`TotalStartedThreadCount`	Total started thread count
`ThreadCount`	Active thread count
`DaemonThreadCount`	Daemon thread count
`PeakThreadCount`	Peak thread count

Measurement Set resin_class_loading¶

Metric	Description
LoadedClassCount	Loaded class count
UnloadedClassCount	Unloaded class count
TotalLoadedClassCount	Total loaded class count

Measurement Set resin_memory_pool¶

Metric	Description
Usage	Used memory pool
PeakUsage	Peak used memory pool
CollectionUsage	Collected used memory pool

Measurement Set resin_garbage_collector¶

Metric	Description
CollectionTime	Garbage collection time
CollectionCount	Garbage collection count