jvm-diagnostics

Analyze JVM diagnostic files to detect performance issues and generate reports.

Updated Sep 21, 2025
One-click install
npx skills add https://github.com/adrianprecub/blog --skill jvm-diagnostics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jvm-diagnostics
Source: https://github.com/adrianprecub/blog/tree/main/ai/skills/jvm-diagnostics
Command: npx skills add https://github.com/adrianprecub/blog --skill jvm-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jfr_parser.py, hprof_parser.py, thread_dump_parser.py, visualvm_parser.py, gc_log_parser.py, core_dump_analyzer.py, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you analyze complex JVM diagnostic files to pinpoint and resolve performance bottlenecks, memory leaks, thread deadlocks, and other critical issues affecting your Java applications.

Core Features & Use Cases

  • Comprehensive Analysis: Parses JFR recordings, heap dumps, thread dumps, GC logs, and core dumps.
  • Automated Issue Detection: Identifies common JVM problems like memory leaks, thread churn, GC pressure, and CPU bottlenecks based on predefined rules.
  • Structured Reporting: Generates a detailed jvm-diagnostics.md report outlining findings and actionable recommendations.
  • Use Case: When your Java application is experiencing high latency, you can feed its JFR recording or heap dump to this Skill to get a quick, expert-level analysis of the root cause.

Quick Start

Analyze the provided JFR file 'application.jfr' to identify performance issues.

Frequently Asked Questions about jvm-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a JFR recording to find JVM performance bottlenecks?

To analyze a JFR recording for JVM performance bottlenecks, you parse the file to detect CPU bottlenecks, memory leaks, and GC pressure. This Skill processes Java Flight Recorder files and generates a structured report with actionable recommendations.

Can I detect memory leaks from a heap dump automatically?

Yes, you can detect memory leaks from a heap dump automatically by parsing the HPRO file. The analysis identifies memory retention issues and produces a detailed diagnostics report outlining the root cause and actionable recommendations.

What is the best way to diagnose thread deadlocks and high CPU usage in a Java application?

The best way to diagnose thread deadlocks and high CPU usage is by analyzing thread dumps and core dumps. This process identifies blocked threads, deadlocks, and CPU consumption patterns, delivering a comprehensive markdown report.

How do I identify GC pressure from garbage collection logs?

You identify GC pressure from garbage collection logs by parsing the log files to evaluate pause times and collection frequency. This analysis detects excessive GC overhead and provides recommendations to optimize memory management.

Does this JVM diagnostics approach work with VisualVM output?

Yes, this JVM diagnostics approach works with VisualVM output by utilizing a dedicated parser. It processes VisualVM data alongside JFR recordings, heap dumps, and thread dumps to detect performance issues like thread churn and memory leaks.

What types of JVM performance issues can be identified from diagnostic files?

JVM performance issues that can be identified from diagnostic files include memory leaks, thread leaks, GC pressure, CPU bottlenecks, and deadlocks. The analysis applies predefined rules to generate a comprehensive report with actionable recommendations.