Eclipse Jifa

Eclipse Jifa is open-source software for better troubleshooting common problems that occurred in Java applications.

Many of the useful tools are client-based. When faced with problems in the production environment or the cloud environment, such tools cannot be used directly due to network or resource problems. Jifa provides a web solution, allowing developers to use the browser to troubleshoot.

The following features are supported:

• Heap Dump Analysis

• GC Log Analysis

• Thread Dump Analysis

The backend of Jifa uses Vert.x as the main framework and consists of two modules:

• Master
  • manage workers and route the requests from browser to the workers
• Worker
  • do the real analysis work

The frontend of Jifa uses Vue as the main framework.

Getting Started

Build

• Prerequisites

  • JDK 8, and make sure $JAVA_HOME is set properly

    Jifa uses the plugin 'com.diffplug.p2.asmaven' to get MAT's dependencies.
    Thisplugin can only run on JRE 8 now, so we need to set $JAVA_HOME to JDK8.
    While other modules depend on JDK11+, Gradle handles this for us correctly.
    

  • npm

• Build All

  $ ./gradlew buildJifa
  

• Build Worker Only

  $ ./gradlew buildWorker
  

Run & Deploy

• Master & Worker

  • Default pattern

    $ cd deploy/default_pattern
    $ ./deploy_jifa.sh
    

  • K8S pattern, workers are scheduled by K8S

    $ cd deploy/k8s_pattern
    $ ./deploy.sh
    

• Worker Only

  $ cd deploy
  $ ./depoy_worker.sh
  

See deployment document for more details.

Quick Demo

$ docker pull jifadocker/jifa-worker:demo
$ docker run -p 8102:8102 jifadocker/jifa-worker:demo

Note: if running Apple's M1 Max chip, include the --platform linux/amd64 switch after the run command.

Then, you can visit Jifa at http://localhost:8102

Documents

• Jifa Customization
• Contribution Guide

Links

• Join the Eclipse Jifa developer community mailing list. The community primarily uses this list for project announcements and administrative discussions amongst committers. Questions are welcome here as well.
• Ask a question or start a discussion via the GitHub issue.(Recommend)
• Slack channel: Eclipse Jifa