This section outlines how to view the status of both past and ongoing cleanup runs. It provides guidance on how to review specific details, including the items that have been deleted, the associated timestamps, the status of each cleanup operation, customizing table columns, and applying filters to view the desired information.
To view the Cleanup policy runs, follow these steps:
As per the User persona, you can work with the contexts as described below:
Global Context
Note
Applies to Platform Admin only.
From the Projects drop-down list, click All Projects.
From the Administrator module, click Artifactory Settings, and then click Retention Policies.
The Retention Policies page appears.
Project Context
Note
Applies to both Platform Admin and Project Admin.
From the Projects drop-down list, choose the desired project.
From the Administrator module, click Artifactory, and then click Retention Policies.
The Retention Policies page appears.
In the Retention Policies page, click Cleanup.
From the Runs tab, under Runs, locate the Run Id you want to learn about it.
In this list, you can review a comprehensive history of executed cleanup policies, including the start time, number and physical size of deleted items, and run status. The list is sorted chronologically, with the most recent run at the top. For more information on run statuses, see the table below.
To view a report on a specific policy run, locate the run, and then click Report icon.
A zip file will be downloaded containing one or more .csv files. If the report is for a dry run, it will show the items that would be deleted in a real run. If it’s for an actual cleanup run, it will detail what was deleted.
Note
Reports are created and stored in a dedicated repository called
jfrog-policy-reports-local. We recommend not deleting this repository to maintain a history of policy executions and their results. Deleting it will result in the loss of this history.If no items are deleted (for a real run) or deleted (for a dry run), a report will not be generated.
The number of previous runs included in the history is defined by the artifactory.policy.cleanup.nodes_cleaned.expiration.days system property. To learn more, refer to Cleanup Policies System Properties.
Cleanup Runs Table Fields
The following table describes the columns of the cleanup runs table fields.
Field | Description | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Run ID | Indicates the number of the run id | ||||||||||||||||||||||||||||||
Global | Indicates the policy is applicable at the global level NoteGlobal Policy may affect multiple projects. It can be managed by a Platform Admin on the Global Scope only. | ||||||||||||||||||||||||||||||
Project | Indicates the name of the project | ||||||||||||||||||||||||||||||
Object Type | Indicated the type of object. It can be Packages or Release Bundles. | ||||||||||||||||||||||||||||||
Policy Name | Indicates the name of the policy | ||||||||||||||||||||||||||||||
Start Time | Indicates the date and time when the cleanup operation started running | ||||||||||||||||||||||||||||||
Cleaned Items (Physical Size) | The number of total deleted items, and the total items (The deleted size) | ||||||||||||||||||||||||||||||
Status | Indicates the status of each cleanup run execution, which can be one of the following:
| ||||||||||||||||||||||||||||||
Report | Indicates the report download state as follows |
Customize Table Columns
Arrange the table columns according to how you want to view them.
Follow these steps to display and arrange the columns:
From the Table header, click Customize Columns icon at the end.
Select which columns to display in the Customize Columns pop-up and drag and drop to reorder them.
Click Apply.
Apply Filters to Sort Run Results
You can apply the filter to the run results to easily access your desired view.
To apply filters, follow these steps:
Click the Filter icon from the top right above the table header.
Apply the following fields as you want to sort:
Name
Description
Policy Name
Enter the name of the policy and choose the policy from the list
Project
Enter the name of the project and choose the project from the list
Start Time
Select from the drop-down list or customize as per the timelines using the calendar
Status
Select the run status from the available list. To learn about statuses, refer to Cleanup Runs Table Fields and Status field.
Other
Select the available options as applicable
To remove applied filters, click Clear all.
Refresh Cleanup Runs
If you don't see the latest created runs in the list, you can refresh the runs to view them.
To refresh runs, click 
Refresh icon from the top right above the table header.