JarCasting
JarCasting JarCasting

org.gridkit.jvmtool::heaplib

Heap analysis library

License

License
GroupId

GroupId

org.gridkit.jvmtool
ArtifactId

ArtifactId

heaplib
Last Version

Last Version

0.2
Release Date

Release Date
Type

Type

jar
Description

Description

org.gridkit.jvmtool::heaplib
Heap analysis library
Project URL

Project URL

http://code.google.com/p/gridkit/heaplib

Download heaplib

Filename Size
heaplib-0.2.pom
heaplib-0.2.jar 17 KB
heaplib-0.2-sources.jar 7 KB
heaplib-0.2-javadoc.jar 73 KB
Browse

How to add to project

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

Dependencies

compile (3)

Group / Artifact Type Version
org.gridkit.jvmtool : hprof-heap jar 0.2
org.gridkit.jvmtool : hprof-oql-engine jar 0.2
org.gridkit.jvmtool : sjk-cli jar 0.12

test (3)

Group / Artifact Type Version
junit : junit jar 4.11
org.assertj : assertj-core jar 1.6.0
org.gridkit.lab : jvm-attach-api jar 1.4

Project Modules

There are no modules declared in this project.

HeapLib

HeapLib a tool/library for analyzing JVM heap dumps. HeapLib is using modified heap parser from Apache NetBeans (same library is used by VisualVM).

Main driver for this project was a need in automated analyzing of heap dump on remote servers.

In addition for original Heap class implementation from NetBeans library this project has an alteranative which:

  • Works with heap dump file without any additional on disk files
  • Process GZip compressed heap dump files directly
  • Cannot calculate retained size or walk object references in backward direction

Besides an API, you can use executable jar for console to execute OQL/JavaScript.

Using HeapLib from Java code

HeapLib is a library you can use from Java code. You can find few examples in hprof-heap/src/test/java/org/gridkit/jvmtool/heapdump/example/ path formatted as JUnit tests.

Using HeapLib CLI

You can use executable jar to execute OQL/JavaScript scripts from console.

To get executable java build project with mvn clean package. Executable jar would be placed under name heap-cli/target/heap-cli-0.1-SNAPSHOT.jar.

Below few commands support by executable:

  • java -jar heap-cli-*.jar --commands print list of supported command
  • java -jar heap-cli-*.jar histo -d dump.hprof produce class histogram from path
  • java -jar heap-cli-*.jar exec --noindex -d dump.hprof -j script.oql execute script on heap dump open in diskless mode (no on-disk indexes should be generated)

Few script examples could be would under hprof-oql-engine/src/test/resources/oql/ path.

Versions

Version
0.2
0.1