Qodana 2025.1 Help

Analysis reports

Qodana lets you review analysis reports in an interactive and user-friendly form either locally or in Qodana Cloud.

Report UI overview

Qodana report UI overview

Each report contains the following tabs:

  • Actual problems exposes the problems that Qodana detected during the latest inspection.

  • Baseline lists the problems that were marked as baseline and were not fixed since then.

  • Configuration lets you configure Qodana for future use.

  • License audit reveals the license audit results and shows the dependency licenses that are incompatible with the project license.

The upper-right corner of the report shows code coverage analysis results.

Qodana report UI overview

Actual problems

Using this tab, you can see the problems found as a result of the latest inspection.

The Actual problems tab

This tab consists of several elements:

  1. The sunburst diagram provides a graphical overview of the problems and allows you to drill down into the cause of the issue.

  2. The group of filters lets you filter the report data using various criteria.

  3. You can navigate between the list of problems and files, as well as search and group problems.

  4. The Move selected to baseline button saves the selected problems to the Baseline list.

  5. Clicking a problem in the list expands the underlying code fragment containing the detailed description.

  6. If you have JetBrains Toolbox and JetBrains IDEs installed, you can edit the file containing the problem using your IDE. To do it, select your IDE from the dropdown list, and click the Open file in... button.

    If you have several versions of the same IDE, you can select which version will be used to open the file. In the JetBrains Toolbox UI, drag or move the required version of the IDE to the top of the list using the Ctrl + Shift + ↑/↓ shortcut on Windows or Linux, or ⌘ + ⇧ + ↑/↓ on macOS.

    The More actions list provides other options for handling problems, see the Adjust the analysis scope section.

  7. You can copy the link to the problem and then navigate to it in Qodana Cloud.

Baseline

When you click the Move selected to baseline button on the Actual problems tab, the selected problems move to this tab.

This tab is similar to the Actual problems tab. To enable the baseline feature for future inspections, follow the instructions that appear in the report UI. For more information, explore the Baseline section.

Configuration

The Configuration tab lists the inspections and lets you adjust your inspection profile by specifying a set of inspections that Qodana will be using the next run.

The Configuration tab

Here, you can learn what each inspection does, as well as enable or disable it. To use this configuration for future use, you can download the qodana.yaml file and save it into your project root directory.

See the Adjust your inspection profile section to learn the best practices.

License audit

The License audit tab provides results of inspection by the license audit feature.

The dependency tree

License audit analysis results are grouped into a dependency tree.

  1. If applicable, you can expand a specific dependency to see its dependency tree.

  2. Using Only alerted, you can switch between all project dependencies and dependencies which licenses are incompatible with the project license.

  3. In the Licenses section, you can find the list of project, module and dependency licenses. Using Open license rules, you can view the rules of license compatibility.

  4. You can download the list of licenses in various formats.

Adjust your inspection profile

We believe that the ability to see what was checked is as important as the list of problems found. For example, if you haven't checked for typos, you can be happy to see zero typos in your project. There may be many of them – you just don't check.

If the number of problems is manageable, you can fix them and consider the 'problem-free code' goal achieved. We suggest that you follow that goal and fix new problems as soon as they appear.

In case the number of problems is above your expectations, we suggest using the Qodana features to examine them.

When you have no possibility to fix old problems and want to prevent the appearance of new ones, you can run Qodana in the baseline mode.

Adjust the analysis scope

Reduce the scope of analyzed issues

When viewing a code fragment with a detected problem, you may decide that it is irrelevant. You can make sure that more problems of the same type are omitted in the future. For this purpose, you can edit qodana.yaml or use the Actual problems tab as shown below.

  1. Exclude a file or directory from the future analysis

Reason: The analysis of the file containing the error, or even the directory containing this file, doesn't make sense in your project. For example, it's actually not the source code but some generated or downloaded content.

Howto: Under the code fragment view, click More actions and select the necessary option.

Selecting the options

OR:

Above the code fragment view, click the file path to navigate to the File explorer.

Adjusting the analysis scope, first step

On the File explorer, click the icon to the left of the filename, and then select Mark as Excluded.

Excluding from analysis
  1. Hide a problem type or category from the list of problems

Reason: You suppose that the error type or its category is not relevant or want to get back to it later.
Howto: Under the code fragment view, click More actions and select the necessary option.

Selecting the options

Enable excluded or hidden problems

To reverse the exclusions you made, download qodana.yaml in the Profile configuration section, edit it as necessary, put it in the project root directory, and then run Qodana again with this new configuration.

To learn how to configure Qodana using qodana.yaml, see the Configure profile section.

Open an HTML report

You can open HTML-formatted Qodana reports using JetBrains IDEs and shell commands.

Starting from version 2023.2 of Qodana, you can open HTML reports using IntelliJ IDEA, PhpStorm, WebStorm, Rider, GoLand, PyCharm, and Rider as explained in the Qodana report overview section.

In this case, your IDE needs to be installed via JetBrains Toolbox App.

See the Visual Studio Code section for details.

When you run Qodana with the --save-report option, it stores an HTML version of the report in /data/results/report. This directory is typically mounted via Docker to let you view the HTML report later, independently of running Qodana. Due to JavaScript security restrictions, you cannot browse the HTML report by double-clicking the index.html file. Instead, the HTML report needs to be served via a web server, and you can run the Dockerized version of nginx, or invoke the Python or PHP built-in web servers as shown below.

  1. After running Qodana, navigate to the report folder and make sure that the index.html file is present there.

  2. Serve the report using the web server of your choice:

    docker run -it --rm -p 8000:80 \ -v $(pwd):/usr/share/nginx/html nginx

    In your browser, navigate to http://localhost:8000 to see the generated report.

    python2 -m SimpleHTTPServer

    In your browser, navigate to http://localhost:8000 to see the generated report.

    python3 -m http.server

    In your browser, navigate to http://localhost:8000 to see the generated report.

    php -S localhost:8000

    In your browser, navigate to http://localhost:8000 to see the generated report.

Last modified: 23 May 2025