TeamCity On-Premises 2020.2 Help

Disk Usage

TeamCity analyses disk space and provides the Disk Usage report. It detects all local and remote artifact directories configured on the server and analyses the disk space occupied by builds in these storages.

To see the report, open Administration| Disk Usage.

Disk usage

The report contains information on the total free disk space and the amount of space taken by build artifacts and build logs.

The default location for these directories is <TeamCity Data Directory>/system. If build logs and artifacts directories are located on different disks, free space is reported for each of the disks.

The report also displays pinned builds, if available, and the space taken by their logs and artifacts.

By default, the report displays data on the builds run from build configurations grouped by projects. You can choose to view the ungrouped list of build configurations or to show archived projects if required using the corresponding checkboxes. You can sort the information by clicking the column name.

The report allows you to see which projects consume most of the disk space and configure the clean-up rules. The link to the report is available from the build history clean-up page. This page also displays disk usage information for the selected project or build configuration when managing clean-up rules in the Configure Clean-up section.

You can also see which configurations produce large build logs and adjust the settings accordingly.

The report is automatically updated when a new build is run or removed: only the data pertaining to this build is analyzed and the corresponding information is reflected in the report. TeamCity updates the report when performing a full disk scan: by default, after a build history clean-up is run. You can force TeamCity to scan the disk on demand using the Rescan now button, but it may be time-consuming.

The Disk Usage report allows going deeper in the build history of a specific build configuration and showing some additional statistics for the builds of this configuration. The clean-up rules for this build configuration are also listed allowing you to adjust the settings based on the data displayed:

Disk usage in details

Last modified: 05 February 2021