javacore-analyser 2.0

The tool to review IBM Javacore files

Javacore Analyser

Scope

The tool analyzes Javacores and verbose gc logs and provides some reports like cpu/gc usage, blocked threads, some tips regarding the javacores. The tool can process the following data:

• Set of Javacores from the same run. Optionally you can add verbose.gc log file
• Single Javacore

Installation and usage

Installation:

The tool requires Python 3.9 or higher plus some packages - see more in REQUIREMENTS. Despite it is not mandatory, it is recommended in Python to use virtual environment to manage packages.

Installing from pip

This is most common option which you will need in 99% of situations

Steps:

1. Download and install Python. Usually the latest version is supported. Search for supported versions in REQUIREMENTS
2. Create and activate Virtual Environment according to Creating virtual environments.
3. Run the following command: pip install javacore-analyser
   OR pip install --extra-index-url https://test.pypi.org/simple/ javacore-analyser - if you want an experimental version

Installing from sources

This is recommended for geeks only:

1. Repeat steps 1 and 2 from above
2. Download the project files either from Releases or from main
3. Extract the code and from code directory execute pip install .

Running the tool:

Running cmd application:

1. Install application if not done yet
2. Activate your created virtual environment according to activate Virtual Environment according to Creating virtual environments
3. Run the following command from cmd: javacore-analyser-batch <input-data> <generated-reports-dir> Where <input-data> is one of the following:

• The directory containing javacores and optionally verbose gc
• Archive (7z, zip, tar.gz, tar.bz2) containing the same
• List of the javacores separated by ; character. Optionally you can add --separator option to define your own separator. You can type the following command to obtain the help:
  javacore-analyser-batch --help

Running web application:

1. Repeat steps 1-3 from cmd application
2. OPTIONAL: set the following variables:

export REPORTS_DIR=/tmp/reports  
export PORT=5000

The first parameter sets where the reports need to be stored. If not set, then the reports dir will be created in current location.
The first parameter set the port to use by application. If not specified, 5000 will be used.
3. Execute the following command from cmd:
javacore_analyser_web

Now you can type (http://localhost:5000/).

Notes

If you have any questions or issues you can create a new issue here.

Pull requests are very welcome! Make sure your patches are well tested. Ideally create a topic branch for every separate change you make. For example:

1. Fork the repo
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

License

All source files must include a Copyright and License header. The SPDX license header is preferred because it can be easily scanned.

If you would like to see the detailed LICENSE click here.

#
# Copyright IBM Corp. {Year project was created} - {Current Year}
# SPDX-License-Identifier: Apache-2.0
#

Authors

• Krzysztof Kazmierczyk [e-mail]
• Piotr Aniola [e-mail]
• Tadeusz Janasiewicz [e-mail]

Another pages

Another useful pages:

• LICENSE
• README.md
• CONTRIBUTING.md
• MAINTAINERS.md

• CHANGELOG.md
• REQUIREMENTS.md