Skip to content

Latest commit

 

History

History
80 lines (56 loc) · 1.34 KB

README.md

File metadata and controls

80 lines (56 loc) · 1.34 KB
Raw

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