Managing project history
On this page
One of the most powerful features of SonarQube is that it shows you not just your project health today, but how it has changed over time. It does that by selectively keeping data from previous analyses (see Housekeeping). It doesn't keep all previous analyses. That would bloat the database. Similarly, for the analyses it does keep, SonarQube doesn't keep all the data. Once a project snapshot moves from being the "last analysis" (i.e., the most recent) to being part of the project's history, data below the project level is purged to keep from bloating the database.
Typically these aren't things you need to even think about. SonarQube just handles them for you. But occasionally you may need to remove a bad snapshot from a project's history or change the housekeeping algorithms.
Managing history
Occasionally, you may need to manually delete a project snapshot, whether because the wrong quality profile was used, or because there was a problem with analysis, and so on. Note that the most recent snapshot (labeled Last snapshot) can never be deleted.
About deleting snapshots
Deleting a snapshot is a 2-step process:
- The snapshot must first be removed from the project history by clicking on Delete snapshot. It won't be displayed anymore on this History page but will still be present in the database.
- The snapshot is actually deleted during the next project analysis.
At the project level, from the front page Activity list, choose Show More to see the full activity list.
For every snapshot, it is possible to manually:
- Add, rename or remove a version.
- Add, rename or remove an event.
- Delete the snapshot
About inactive projects
Projects that are not analyzed for seven consecutive days are considered inactive, and SonarQube automatically deletes their cached data to free space in the database. See Maintaining your branches for more information on inactive branches and cached data.
The Projects Management search interface includes a date picker to help you find all projects last analyzed before your specified date. From there you can deal with them on this page as a set, or click through to the individual project homepages for individual attention and administration.
In Administration > Projects > Management search for Last analysis before to filter projects not analyzed since a specific date. Then use bulk Delete to remove the projects that match your filter.
This can be automated by using the corresponding Web API: api/projects/bulk_delete?analyzedBefore=YYYY-MM-DD.
Was this page helpful?
© 2008-2024 SonarSource SA. All rights reserved. SONAR, SONARSOURCE, SONARLINT, SONARQUBE, SONARCLOUD, and CLEAN AS YOU CODE are trademarks of SonarSource SA.
