AI Agent Hub
Back to skills
JVM GC Log Analysis Report icon

JVM GC Log Analysis Report

Data Analysis Updated 2026.08.29

Paste the following prompt into your AI chat to install this skill:

Install @user_c35d27f3/gc-log-report by following https://skillhub.cn/install/skillhub.md.

About this skill

Problem

In production, JVM GC logs are usually raw streams of timestamps, heap changes, and pause events. gc.log* files can record Full GC, Young GC, pause times, and heap usage, but they rarely answer the practical question: was the slowdown caused by GC, what is the risk level, and is the issue more likely an application allocation problem or a JVM tuning problem. This skill turns one or more GC log files into a reviewable analysis package suitable for performance owners, architects, or middleware teams.

How It Works and Boundaries

It starts by checking the available gc.log* files and whether the input is only part of a rotated log set. It then extracts key metrics such as time range, GC count, Full GC count, average/max/P95 pause, long pauses over 200ms, 500ms, and 1s, GC cause distribution, heap occupancy after collection, Metaspace changes, and peak windows. It also forms conclusions, such as whether there is a Full GC storm, frequent Young GC, long-tail pauses, or old-generation pressure, and marks issue items explicitly.

The output can include an HTML report and a Markdown summary, with optional line, pie, or bar charts rendered as self-contained HTML assets. It provides tuning guidance across application-side, JVM-parameter-side, and platform-side factors, rather than only recommending further observation. If only one rotated file is available, the log format is incomplete, or the data is insufficient, the report keeps the section and states the data boundary instead of presenting a partial sample as a full conclusion.

Use Cases

  • Diagnose intermittent API latency by checking gc.log* for Full GC or long pauses and producing reviewable conclusions.
  • Merge multiple rotated GC logs into one time window and prepare tuning evidence for architects.
  • Summarize GC metrics into a one-page Markdown risk report for leadership, with highlighted issue items.
  • Generate a self-contained HTML GC report with key charts for formal production incident reviews.

Best For

  • Java engineers turning raw GC logs into fault-detection conclusions
  • JVM architects evaluating GC policy, heap sizing, and tuning evidence
  • Operations leads reporting JVM risk in production systems to management
  • Middleware performance owners assessing Full GC, long pauses, and old-generation pressure