# microsoft/gctoolkit

Tool for parsing GC logs

Repository: https://github.com/microsoft/gctoolkit
Canonical: https://ross.abutalabs.com/products/gctoolkit
Homepage: https://github.com/microsoft/gctoolkit
Language: Java
License: MIT
License Family: permissive
Topics: java, gc, performance, jvm, heap, memory, memory-management
Last push: 2026-09-02T22:24:58+00:00

## Health v2 (maintenance only)
Score: 79/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 40, longevity 100
- inputs: {"age_days": 1870, "days_push": 0, "days_rel": 489, "gap_med": 13, "n_releases_24m": 8}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1301, forks 178 (observed 2026-09-03T02:15:15.019925+00:00)

## What it is
GCToolKit is a set of Java libraries for parsing HotSpot JVM garbage collection log files into discrete events. It provides an API for aggregating and analyzing GC data to build custom analyses of JVM managed memory behavior.

## Use cases
- parse HotSpot GC log files into structured events
- analyze Java heap occupancy after garbage collections
- build custom analytics on JVM garbage collection telemetry
- tune JVM memory management using GC log data
- aggregate GC pause and collection statistics
- diagnose memory issues in Java applications from logs

## When to choose
- you need to programmatically analyze HotSpot GC logs in Java
- you want to build custom GC analysis or reporting tools
- you're tuning JVM garbage collection and need structured log parsing
- you need a maintained, MIT-licensed library for GC log parsing

## When to avoid
- you need GC log parsing for non-HotSpot JVMs
- you want a ready-made GUI or dashboard rather than a library
- you need real-time GC monitoring rather than log file analysis

## Facets
- artifact type: library
- maturity: active
- function: parser, monitoring, analytics, developer-tools
- domain: developer-tools, performance, monitoring
- platform: jvm, cross-platform
- tags: garbage-collection, gc-logs, jvm-tuning, memory-analysis, hotspot, jvm

## Member repositories
- microsoft/gctoolkit (main) score 79

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:15.019925+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:52:19.263953+00:00, confidence not recorded.
  - readme: https://github.com/microsoft/gctoolkit (fetched 2026-09-03T02:15:15.019925+00:00, sha 01954360df47)
  - homepage: https://github.com/microsoft/gctoolkit (fetched 2026-08-29T12:09:48.729927+00:00, sha cc721abcc3f0)
- Data as of 2026-08-30T08:39:29.467469+00:00.