> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/artifact-registry/3.0/artifacts/audit-dashboard.md).

# Audit dashboard

Use the built-in Artifact Registry Audit Dashboard in Harness Dashboards to track artifact upload and download activity by user, IP, and registry.

The **Artifact Registry Audit Dashboard** is an out-of-the-box dashboard in Harness Dashboards that records every artifact **upload** and **download** across your registries. Harness provisions and maintains it, so it appears automatically for every account with Artifact Registry enabled. You do not create, build, or edit it.

The dashboard supports security, compliance, and incident-response workflows: identifying who pulled a package version after a CVE disclosure, auditing upload activity for a compliance review, or comparing upload-versus-download activity across registries and projects.

{% hint style="info" %}
**Audit dashboard or Platform Audit Trail**

The Harness platform [Audit Trail](https://developer.harness.io/harness-platform/use-harness-platform/governance/audit-trail/audit-trail) records create, update, and delete operations on registries and lifecycle rules. Use it to identify who changed those resources and review the change details. The Artifact Registry Audit Dashboard covers only **upload** and **download** events on artifacts, which the Platform Audit Trail does not store.
{% endhint %}

## Before you begin

* A Harness account with Artifact Registry enabled and at least one registry that has received upload or download traffic.
* Access to **Harness Dashboards** in the same account.

## Open the dashboard

1. In the navigation menu, select **Dashboards**.
2. In the mode toggle, select **Standard** mode. New accounts open in **Legacy** mode by default, and the Artifact Registry Audit Dashboard is listed only in Standard mode.
3. In the **All Dashboards** list, find **Artifact Registry Audit Dashboard**. It is owned by `system` and tagged **By Harness**, **Harness**, and **AR**.
4. Click the dashboard name to open it.

## What the dashboard shows

The dashboard opens with a **Time Range** selector (defaulted to **Last 1 Month**) and five identifier filters: **Organization Identifier**, **Project Identifier**, **Registry Name**, **Package Name**, and **Version Name**. Every widget on the page reacts to these filters.

| Widget                           | What it shows                                                                                                                              | Use it to                                                                                                   |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| **Download Artifact Data**       | A paginated table of recent `DOWNLOAD` events: Action, Registry Name, Package Name, Version Name, Username, Client IP, and Timestamp Hour. | Trace exactly who downloaded a specific package version, and from which IP, during the selected time range. |
| **Upload Artifact Data**         | A paginated table of recent `UPLOAD` events with the same columns as the download table.                                                   | Audit which users or service accounts pushed artifacts into a registry.                                     |
| **Upload And Download Activity** | A daily time-series line chart with download count and upload count.                                                                       | Spot spikes, drops, or unusual patterns in artifact traffic over the selected window.                       |
| **Upload/Download Aggregation**  | A donut chart showing the total upload-versus-download split, with absolute counts, for the filtered range.                                | Get the overall mix of activity at a glance for the selected scope.                                         |

## Identify who downloaded a package version

A typical zero-day workflow:

1. Set the **Time Range** to cover the period of concern (for example, **Last 1 Month**).
2. Set **Registry Name** to the registry's literal name.
3. Set **Package Name** to the package or image name.
4. Optionally, set **Version Name** to narrow to the specific affected version.
5. Read the **Download Artifact Data** table. Each row shows the **Username**, **Client IP**, and **Timestamp Hour** of the pull.

## Audit uploads to a registry

Use the same filter approach, then read the **Upload Artifact Data** table. Each row shows the principal that pushed the artifact, the source IP, and when the upload occurred. For client-token pushes, **Username** is the principal that issued the token.

## Troubleshooting

<details>

<summary>A registry create, update, or delete event is missing from the dashboard</summary>

The dashboard displays only artifact upload and download events; it has no widget for registry create, update, or delete events. Those events appear in the platform [Audit Trail](https://developer.harness.io/harness-platform/use-harness-platform/governance/audit-trail/audit-trail) instead. Filter by the Artifact Registry module, and include upstream proxies in the filter since they are recorded as a separate resource type. Upload and download events do not appear in the Audit Trail.

</details>

## Next steps

* [Browse and search artifacts](https://developer.harness.io/artifact-registry/3.0/artifacts/browse-and-search.md)
* [Harness platform Audit Trail](https://developer.harness.io/harness-platform/use-harness-platform/governance/audit-trail/audit-trail)
* [Harness Dashboards overview](https://developer.harness.io/harness-platform/use-harness-platform/harness-dashboards/dashboard-legacy/dashboards-overview)

{% @harness-feedback/feedback %}
