Activity logs
Activity logs display a chronological list of activities that occur at organization and repository levels. The activity log provides organization owners with a record of all member activities.
With activity logs, owners can view and track:
- What changes were made
- The date when a change was made
- Who initiated the change
For example, activity logs display activities such as the date when a repository was created or deleted, the member who created the repository, the name of the repository, and when there was a change to the privacy settings.
Owners can also see the activity logs for their repository if the repository is part of the organization subscribed to a Docker Business or Team subscription.
Access activity logs
To view activity logs in Docker Home:
- Sign in to Docker Home and select your organization.
- Select Admin Console, then Activity logs.
To view activity logs using the Docker Hub API, use the Audit logs endpoints.
Filter and customize activity logs
ImportantDocker Home retains activity logs for 30 days. To retrieve activities beyond 30 days, you must use the Docker Hub API.
By default, the Activity tab displays all recorded events within the last 30 days. To narrow your view, use the calendar to select a specific date range. The log updates to show only the activities that occurred during that period.
You can also filter by activity type. Use the All Activities drop-down to focus on organization-level, repository-level, or billing-related events. In Docker Hub, when viewing a repository, the Activities tab only shows events for that repository.
After selecting a category—Organization, Repository, or Billing—use the All Actions drop-down to refine the results even further by specific event type.
NoteEvents triggered by Docker Support appear under the username dockersupport.
Types of activity log events
Refer to the following section for a list of events and their descriptions:
Organization events
Repository events
NoteEvent descriptions that include a user action can refer to a Docker username, personal access token (PAT) or organization access token (OAT). For example, if a user pushes a tag to a repository, the event would include the description:
<user-access-token>pushed the tag to the repository.
| Event | Description |
|---|---|
| Repository Created | Activities related to the creation of a new repository |
| Repository Deleted | Activities related to the deletion of a repository |
| Repository Updated | Activities related to updating the description, full description, or status of a repository |
| Privacy Changed | Details related to the privacy policies that were updated |
| Tag Pushed | Activities related to the tags pushed |
| Tag Deleted | Activities related to the tags deleted |
| Categories Updated | Activities related to setting or updating categories of a repository |
Billing events
| Event | Description |
|---|---|
| Plan Upgraded | Occurs when your organization’s billing plan is upgraded to a higher tier plan. |
| Plan Downgraded | Occurs when your organization’s billing plan is downgraded to a lower tier plan. |
| Seat Added | Occurs when a seat is added to your organization’s billing plan. |
| Seat Removed | Occurs when a seat is removed from your organization’s billing plan. |
| Billing Cycle Changed | Occurs when there is a change in the recurring interval that your organization is charged. |
| Plan Downgrade Canceled | Occurs when a scheduled plan downgrade for your organization is canceled. |
| Seat Removal Canceled | Occurs when a scheduled seat removal for an organization’s billing plan is canceled. |
| Plan Upgrade Requested | Occurs when a user in your organization requests a plan upgrade. |
| Plan Downgrade Requested | Occurs when a user in your organization requests a plan downgrade. |
| Seat Addition Requested | Occurs when a user in your organization requests an increase in the number of seats. |
| Seat Removal Requested | Occurs when a user in your organization requests a decrease in the number of seats. |
| Billing Cycle Change Requested | Occurs when a user in your organization requests a change in the billing cycle. |
| Plan Downgrade Cancellation Requested | Occurs when a user in your organization requests a cancellation of a scheduled plan downgrade. |
| Seat Removal Cancellation Requested | Occurs when a user in your organization requests a cancellation of a scheduled seat removal. |
Offload events
NoteEvent descriptions show the Docker username of the actor and details about the lease.
