System Health Check
GalataJ includes a built-in health check that diagnoses issues and fixes them automatically.
Running a Health Check
Dział zatytułowany „Running a Health Check”IntelliJ IDEA
Dział zatytułowany „IntelliJ IDEA”- Open the Profiler panel
- Click the Health button in the toolbar
VS Code / Cursor / Windsurf
Dział zatytułowany „VS Code / Cursor / Windsurf”- Open the GalataJ sidebar panel
- Look at the System Health section
Or use Command Palette: GalataJ: Health Check
Understanding Results
Dział zatytułowany „Understanding Results”The health check shows the status of each component:

Status Indicators
Dział zatytułowany „Status Indicators”| Status | Meaning |
|---|---|
| 🟢 OK | Component is working properly |
| 🟡 Warning | Something to note, but not blocking |
| 🔴 Error | Needs to be fixed before profiling works |
Components Checked
Dział zatytułowany „Components Checked”| Component | What it checks |
|---|---|
| CLI | GalataJ command-line tool is installed |
| Java | Java JDK is available on your system |
| Controller | Controller component exists |
| Controller Running | Controller is currently active |
| Plugin Version | Whether updates are available |
Overall Status
Dział zatytułowany „Overall Status”The health check shows an overall status at the top:
| Status | Meaning |
|---|---|
| Healthy | Everything works, ready to profile |
| Degraded | Some warnings, but profiling should work |
| Unhealthy | Critical issues, fix before profiling |
When to Run Health Check
Dział zatytułowany „When to Run Health Check”Run a health check when:
- You just installed the plugin
- Profiling won’t start
- JVMs don’t appear in the list
- Metrics aren’t showing up
- Something seems wrong
Quick Tip
If profiling isn’t working, Health Check should be your first step. It usually identifies and fixes the problem automatically.
Common Issues
Dział zatytułowany „Common Issues””CLI not found”
Dział zatytułowany „”CLI not found””The GalataJ command-line component isn’t installed.
Fix: Click the Fix button to download it, or reinstall the plugin.
”Controller not running”
Dział zatytułowany „”Controller not running””The profiling controller isn’t active.
Fix: Click the Run Controller button to start it.
”Java not found”
Dział zatytułowany „”Java not found””No Java JDK detected on your system.
Fix: Install a JDK (Java 8 or later). The Fix button opens the Adoptium download page.
”Update available”
Dział zatytułowany „”Update available””A newer version of GalataJ is available.
Fix: Click to update. Restart your IDE after updating.
Next Steps
Dział zatytułowany „Next Steps”- Troubleshooting — More detailed problem solving
- Quickstart — Start profiling once health check passes