YaSuenag / gcjfrlog

JFR event shipper for GC

gcjfrlog

gcjfrlog is Java agent to gather GC information via JFR Event Sreaming and to post them as JSON document via HTTP.

Requirements

JDK 14 or later

How to build

$ mvn package

How to use

Examples

Post events to Elasticsearch

$ java -javaagent:/path/to/gcjfrlog.jar=uri=http://localhost:9200/gcjfrlog-%y-%m/%h,label=app ...

Start agent

Start log shipping since process start

Set path to gcjfrlog-<version>.jar to -javaagent

$ java -javaagent:/path/to/gcjfrlog.jar=<option> ...

Attach gcjfrlog to existing process

You need to escape double-quote.

$ jcmd <PID> JVMTI.agent_load \"/path/tp/gcjfrlog.jar=<option>\"

Option

• uri mandatory option
  • URI to push
• label
  • label field would be set if this value is set
• connect_timeout
  • Connection timeout in millis
• request_timeout
  • HTTP request timeout in millis

Format strings

You can use format strings in uri.

• %h
  • hostname
• %l
  • label
• %y
  • year (yyyy)
• %m
  • month (mm)
• %d
  • day (dd)

JFR events which are handled

• jdk.GCPhasePause
• jdk.PromotionFailed
• jdk.EvacuationFailed
• jdk.ConcurrentModeFailure
• jdk.MetaspaceOOM
• jdk.GCHeapSummary
• jdk.MetaspaceSummary
• jdk.GarbageCollection

License

The GNU Lesser General Public License, version 3.0