> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dqlabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Asset Audit

> How the asset-level Audit tab tracks CRUD operations, links, views, and job triggers for a single asset, with retention and export details.

<script type="application/ld+json">
  {`{
            "@context": "https://schema.org",
            "@type": "TechArticle",
            "headline": "Asset Audit",
            "description": "How the asset-level Audit tab tracks CRUD operations, links, views, and job triggers for a single asset, with retention and export details.",
            "url": "https://docs.dqlabs.ai/architecture/log/asset-audit",
            "publisher": {
              "@type": "Organization",
              "name": "DQLabs Inc",
              "logo": "https://media.brand.dev/332adc35-5bc4-4d2b-bf78-256aa4a5e414.svg"
            }
            }`}
</script>

## Overview

The **Audit** tab under an asset gives you a complete, chronological record of activity on an asset — who did what, and when. It captures create, read, update, and delete (CRUD) operations, as well as system-level events like linking assets to domains, running metric jobs, and permission changes.

You can access the Audit tab from any asset, semantic model, or metric page, alongside **Overview**, **Attribute**, **Metric**, **Usage**, **Lineage**, **Documentation**, **Conversation**, and **Catalog**.

<Frame>
  <img src="https://mintcdn.com/dqlabs/TEcT5Ut9iQfMyPTP/images/image-46.png?fit=max&auto=format&n=TEcT5Ut9iQfMyPTP&q=85&s=29b1b63d4b3d1d88897ceba70c3c59d8" alt="Image" width="679" height="676" data-path="images/image-46.png" />
</Frame>

## Asset Audit

The **Audit Log** panel lists every recorded event for the asset, most recent first. The header shows the total event count, e.g. `Audit Log (308)`.

### Table columns

Each row in the log captures both the "what" and the "who" behind an action:

| Column       | Description                                                                                                                                                                 |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Log Date** | Timestamp the action occurred, e.g. `Jul 03 2026 09:44 AM`                                                                                                                  |
| **Action**   | The type of event — see [Action types](#action-types) below                                                                                                                 |
| **Message**  | A human-readable description of what happened, e.g. *"User*[lisa@dqlabs.ai ](mailto:Jammalavamsi@dqlabs.ai)*linked GOLD\_FACT\_SELL\_THROUGH\_DAILY\_TEST to Marketing..."* |

Behind each entry, the system also tracks additional metadata used for filtering, search, and export: **Asset Name**, **Attribute**, **Metric Name**, **Source ID**, **Asset ID**, **User ID**, and **User Email**.

### Action types

| Action                   | Description                                                                           |
| ------------------------ | ------------------------------------------------------------------------------------- |
| **Created**              | A new asset, attribute, or resource was created                                       |
| **Read / View**          | A user viewed the asset, e.g. *"viewed GOLD\_FACT\_SELL\_THROUGH\_DAILY\_TEST asset"* |
| **Updated**              | A field, description, or configuration was changed                                    |
| **Deleted**              | An asset or resource was removed                                                      |
| **Approved**             | An asset or change was approved                                                       |
| **Link\_asset**          | The asset was linked to another resource, such as a domain, product, or tag           |
| **Metric\_job\_trigger** | A metric job (e.g. a `BUSINESS` job) was manually or automatically triggered          |

<Note>
  For update events, the message includes a before/after snapshot of the change where applicable — for example, a description update shows both the old and new text.
</Note>

### Filters and controls

Use the **ALL** filter above the table to scope results, and the icons in the top-right of the panel to:

* **Filter** — narrow entries by user, date range, resource type, or action type
* **Sort** — reorder the log by date or other columns
* **Search** — find specific entries by keyword
* **Export** — download the audit log (CSV) via the overflow menu

<Tip>
  Use the date range and action type filters together to quickly answer questions like "who updated this asset's description last week?"
</Tip>

## Data retention

Audit log entries are retained according to your organization's configured retention period:

* **Default minimum:** 90 days
* **Compliance mode:** up to 7 years, based on the storage setting configured in your organization profile

Audit logs are stored immutably — entries cannot be edited or deleted, ensuring the log remains a reliable record for compliance and investigation purposes.

## Audit vs. Activity logs

The Audit tab on an asset focuses on **changes and interactions with that specific asset** (CRUD operations, links, job triggers, views).

A separate, organization-wide **Activity Log** (under Security) tracks **access and session-level activity** across the platform, including:

* Login attempts, logouts, and failed authentication
* Session timeouts
* Permission checks and access denials
* Queries executed against semantic layers and metrics, with parameters

Each session appears as a single line in the Activity Log, with the underlying audit events available as drill-down detail. Like the asset-level Audit Log, the Activity Log is filterable, sortable, and exportable.

<Info>
  If you need to investigate *who accessed* a resource and *from where* (e.g. IP address, session), check the organization's Activity Log under **Security**. If you need to know *what changed* on a specific asset, use that asset's **Audit** tab.
</Info>

## Related pages

<CardGroup cols={2}>
  <Card title="Logging Overview" icon="layer-group" href="/architecture/log/logging-overview">
    Understand how this tab relates to the org-wide logs
  </Card>

  <Card title="Audit Log" icon="server" href="/architecture/log/audit-log">
    See Application, system-wide API, AI, and job-level events in Command Center
  </Card>

  <Card title="Activity Log" icon="clock" href="/architecture/log/activity-log">
    See session-level user activity across the platform
  </Card>

  <Card title="Usage" icon="chart-line" href="/architecture/usage">
    See query volume, performance, and cost metrics for this asset
  </Card>
</CardGroup>
