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

Status Indicators
Seção intitulada “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
Seção intitulada “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
Seção intitulada “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
Seção intitulada “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
Seção intitulada “Common Issues””CLI not found”
Seção intitulada “”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”
Seção intitulada “”Controller not running””The profiling controller isn’t active.
Fix: Click the Run Controller button to start it.
”Java not found”
Seção intitulada “”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”
Seção intitulada “”Update available””A newer version of GalataJ is available.
Fix: Click to update. Restart your IDE after updating.
Next Steps
Seção intitulada “Next Steps”- Troubleshooting — More detailed problem solving
- Quickstart — Start profiling once health check passes