View Results of Policy Runs

JFrog Platform Administration Documentation

Content Type
Administration / Platform
ft:sourceType
Paligo

You can view the history of cleanup policies that ran and download reports on each specific policy run.

To view cleanup policy history:

  1. At the top of the Artifactory screen, click the Administration tab.

  2. In the navigation panel on the left-hand side of the screen, go to Artifactory Settings>Retention Policies. The Retention Policies screen is displayed.

  3. If your version of Artifactory is configured for cold storage archiving, click the Cleanup tab. If your version of Artifactory is not configured for cold storage archiving, the Cleanup tab is selected by default.

  4. Under the Cleanup tab, click Runs. A list of policy runs appears.

    Cleanup_Policies_Runs_View.png

    In this list, you can review a comprehensive history of the cleanup policies that have been executed including: start time, number and physical size of cleaned items, and run status. The list is sorted chronologically starting from the most recent run. For more information on the run statuses, see the table below.

  5. To view a report on a specific policy run, go to the row of the policy and click download_button.png at the right end of the row to download the report. A zip file is downloaded including one or more .csv files. If this is a report for a dry run, you can review what items will be deleted if a real run is performed. If this is a report for a real cleanup run, you can review a report of what was deleted.

    Note

    • Reports are created and saved in a dedicated generic repository called jfrog-policy-reports-local. JFrog strongly recommends not deleting this repository in order to retain a history of policy executions and their results. If this repository is deleted, you will lose this history.

    • If no packages are deleted (for a real run) or detected (for a dry run) a report is not created.

    • The number of previous runs that are included in the history is defined with the artifactory.policy.cleanup.nodes_cleaned.expiration.days system property. See Cleanup Policies System Properties for more information.

Cleanup Policy Run Statuses

The table below lists the possible status for a cleanup policy run.

Status

Meaning

In Progress

The policy run is in progress and there are no errors.

In Progress with errors

The policy run is in progress, but there are errors. For information about these errors, see the logs.

Complete

The policy run completed successfully without errors.

Complete with errors

The policy run completed, but there are errors. For information about these errors, see the logs.

Stopped

The policy run was stopped prior to completion by an admin.

Stopping

The policy run is in the process of stopping prior to completion due to intervention by an admin.

Failed

The policy run failed.