Audit Repository EventsEstimated reading time: 5 minutes
This topic applies to Docker Enterprise.
The Docker Enterprise platform business, including products, customers, and employees, has been acquired by Mirantis, inc., effective 13-November-2019. For more information on the acquisition and how it may affect you and your business, refer to the Docker Enterprise Customer FAQ.
Starting in DTR 2.6, each repository page includes an Activity tab which displays a sortable and paginated list of the most recent events within the repository. This offers better visibility along with the ability to audit events. Event types listed will vary according to your repository permission level. Additionally, DTR admins can enable auto-deletion of repository events as part of maintenance and cleanup.
In the following section, we will show you how to view and audit the list of events in a repository. We will also cover the event types associated with your permission level.
View List of Events
As of DTR 2.3, admins were able to view a list of DTR events using the API. DTR 2.6 enhances that feature by showing a permission-based events list for each repository page on the web interface. To view the list of events within a repository, do the following:
https://<dtr-url>and log in with your DTR credentials.
Select Repositories from the left navigation pane, and then click on the name of the repository that you want to view. Note that you will have to click on the repository name following the
/after the specific namespace for your repository.
Select the Activity tab. You should see a paginated list of the latest events based on your repository permission level. By default, Activity shows the latest
10events and excludes pull events, which are only visible to repository and DTR admins.
- If you’re a repository or a DTR admin, uncheck “Exclude pull” to view pull events. This should give you a better understanding of who is consuming your images.
- To update your event view, select a different time filter from the drop-down list.
The following table breaks down the data included in an event and uses the highlighted “Create Promotion Policy” event as an example.
|Label||Friendly name of the event.||
|Repository||This will always be the repository in review following the
|Tag||Tag affected by the event, when applicable.||
|SHA||The digest value for
|Type||Event type. Possible values are:
|Initiated by||The actor responsible for the event. For user-initiated events, this will reflect the user ID and link to that user’s profile. For image events triggered by a policy – pruning, pull / push mirroring, or promotion – this will reflect the relevant policy ID except for manual promotions where it reflects
|Date and Time||When the event happened in your configured time zone.||2018 9:59 PM`|
Given the level of detail on each event, it should be easy for DTR and security admins to determine what events have taken place inside of DTR. For example, when an image which shouldn’t have been deleted ends up getting deleted, the security admin can determine when and who initiated the deletion.
For more details on different permission levels within DTR, see Authentication and authorization in DTR to understand the minimum level required to view the different repository events.
|Repository Event||Description||Minimum Permission Level|
|Push||Refers to “Create Manifest” and “Update Tag” events. Learn more about pushing images.||Authenticated Users|
|Scan||Requires security scanning to be set up by a DTR admin. Once enabled, this will display as a
|Promotion||Refers to a “Create Promotion Policy” event which links to the Promotions tab of the repository where you can edit the existing promotions. See Promotion Policies for different ways to promote an image.||Repository Admin|
|Delete||Refers to “Delete Tag” events. Learn more about deleting images.||Authenticated Users|
|Pull||Refers to “Get Tag” events. Learn more about pulling images.||Repository Admin|
|Mirror||Refers to “Pull mirroring” and “Push mirroring” events. See Mirror images to another registry and Mirror images from another registry for more details.||Repository Admin|
|Create repo||Refers to “Create Repository” events. See Create a repository for more details.||Authenticated Users|