AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

java-diagnostics

Symptom-first runtime diagnostics for JVM applications using JDK tools: jcmd, jstack, jmap, jstat, JFR, GC logs, async-profiler, Native Memory Tracking, and Eclipse MAT. Use when a Java app has high CPU, memory leaks or OutOfMemoryError, slow startup, deadlocks or thread starvation, long GC pauses, native memory growth, or slow requests. Includes permission tiers for safe use.

Original source
github
License
MIT
Pinned revision
5269f7ea2d6c3a9bfda5ed878b6726cf509121fd

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read github--java-diagnostics at revision 5269f7ea2d6c3a9bfda5ed878b6726cf509121fd, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 9

references/native-memory.md

Native Memory Tracking (Tier 2: needs consent)

Use when container RSS grows but heap usage does not. NMT tracks JVM-internal allocations (metaspace, thread stacks, code cache, GC structures, direct buffers via Internal/Other), not arbitrary native library malloc.

Enable at startup (needs a restart; Oracle documents a 5-10% JVM performance drop with NMT enabled, plus extra malloc header memory, and detail costs more; measure on your workload):

-XX:NativeMemoryTracking=summary

Then:

jcmd <pid> VM.native_memory summary
jcmd <pid> VM.native_memory baseline
# ... wait while the problem develops ...
jcmd <pid> VM.native_memory summary.diff

Use detail only for short sessions (higher overhead). It cannot be enabled on a running JVM.

Common growth areas

| Category | Typical cause | Mitigation | |----------|---------------|-----------| | Thread | Too many threads (stack ~1 MB each) | Bound pools; virtual threads; -Xss | | Class | Classloader leak, dynamic proxies | Fix leak; -XX:MaxMetaspaceSize | | Code | Large JIT code cache | -XX:ReservedCodeCacheSize | | GC | Remembered sets/card tables for big heaps | Right-size heap | | Internal/Other | Direct ByteBuffer, Netty pools | -XX:MaxDirectMemorySize, check pooling | | Not in NMT | JNI/native libraries, glibc arenas | async-profiler nativemem; MALLOC_ARENA_MAX=2; allocator profiling |

Total RSS ≈ heap + metaspace + threads + code cache + direct buffers + native libs. Compare against the container memory limit (see containers).