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

# Activity Logs

> Learn how to track and monitor system change history.

## Who is this guide for?

This guide is for anyone monitoring system activity with an **Admin** account.

* You want to see who changed what and when
* You want to trace the cause when a problem occurs
* You want to understand how the system is being used

***

## Before you begin

<Note>
  The following requirements must be met:

  * Access to the A2 admin console (**Admin** role)
  * Log view permission (Audit Log read)
</Note>

***

## What are activity logs?

All data changes made on the A2 platform are recorded automatically.

```mermaid theme={null}
flowchart LR
    A[User performs an action] --> B[Data changes]
    B --> C[Activity log recorded automatically]
    C --> D[Admin views/analyzes]
```

### Recorded information

| Field | English | Description |
| - | - | - |
| **Event type** | Event Type | What kind of action (create, update, delete) |
| **Actor** | Actor | Who performed it (email) |
| **Timestamp** | Timestamp | When it was performed |
| **Target** | Target | Which data was changed |
| **Old value** | Old Value | State before the change |
| **New value** | New Value | State after the change |

***

## Viewing activity logs

### View all logs

1. Go to the **Logs** menu.
2. Recent activity logs are displayed.

### Search with filters

Quickly find only the logs you need.

| Filter | English | Description | Example |
| - | - | - | - |
| **Event type** | Event Type | Search for specific actions only | Campaign updated |
| **Actor** | Actor | Search for a specific user's actions only | [user@example.com](mailto:user@example.com) |
| **Period** | Period | Search for actions within a specific period | 2024-03-01 \~ 2024-03-31 |

***

## Understanding event types

### Event naming convention

Event names use the **\_** format.

| Action | English | Meaning |
| - | - | - |
| **Create** | insert | New data was created |
| **Update** | update | Existing data was changed |
| **Delete** | delete | Data was deleted |

### Key events

<Tabs>
  <Tab title="Users">
    | Event | Description |
    | - | - |
    | User created | A new account was created |
    | User updated | User information was changed |
    | User deleted | An account was deleted |
  </Tab>

  <Tab title="Campaigns">
    | Event | Description |
    | - | - |
    | Campaign created | A new campaign was created |
    | Campaign updated | Campaign information was changed |
    | Campaign deleted | A campaign was deleted |
  </Tab>

  <Tab title="Placements">
    | Event | Description |
    | - | - |
    | Placement created | A new placement was created |
    | Placement updated | Placement information was changed |
    | Placement deleted | A placement was deleted |
  </Tab>

  <Tab title="Allocations">
    | Event | Description |
    | - | - |
    | Allocation created | A new allocation was created |
    | Allocation updated | Allocation status was changed (approved, rejected, etc.) |
    | Allocation deleted | An allocation was deleted |
  </Tab>

  <Tab title="Payments">
    | Event | Description |
    | - | - |
    | Payment created | A new payment occurred |
    | Payment updated | Payment status was changed (refund, etc.) |
  </Tab>
</Tabs>

***

## Checking change details

Click a log to compare the **old and new values**.

### Example: Campaign update

| Field | Old | New |
| - | - | - |
| **Status** | Preparing | Ready |
| **Daily Budget** | 50,000 KRW | 100,000 KRW |

### For create (Insert)

* **Old Value**: None (empty)
* **New**: The newly created data

### For delete (Delete)

* **Old Value**: The deleted data
* **New**: None (empty)

***

## Use cases

### Troubleshooting

Trace the change history when a problem occurs with a campaign.

1. Go to the **Logs** menu.
2. Set **Event type** to "Campaign updated".
3. Review the change history for that campaign.

### User activity audit

Review all activity by a specific user.

1. Go to the **Logs** menu.
2. Enter the user's email in the **Actor** filter.
3. Review all of that user's action history.

### Daily change summary

Review all changes made in the system during a day.

1. Go to the **Logs** menu.
2. Set the **Period** filter to today.
3. Review all changes made today.

***

## Log retention policy

### Retention period

| Item | Period |
| - | - |
| **All logs** | Retained indefinitely (default) |
| **Viewable at once** | Most recent 1,024 entries |

<Note>
  Activity logs are **read-only**. They cannot be edited or deleted, to preserve data integrity.
</Note>

### Optimizing query performance

Use filters when viewing large volumes of logs.

<Tip>
  Specifying a **date range** and **event type** significantly speeds up queries.
</Tip>

***

## View permissions

| Role | Permission |
| - | - |
| **Admin** | Can view all activity logs |
| **Retailer** | ❌ Cannot view |
| **Advertiser** | ❌ Cannot view |

<Warning>
  Only **Admins** can view activity logs. They contain sensitive system information, so manage them carefully.
</Warning>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Can I delete activity logs?">
    No. Activity logs cannot be deleted, to preserve **data integrity**. They are retained permanently for legal requirements and audit purposes.
  </Accordion>

  <Accordion title="Which actions are recorded in the logs?">
    All **create, update, and delete** operations in the database are recorded. However, view (read) operations are not recorded.
  </Accordion>

  <Accordion title="Viewing logs is slow">
    Use filters to narrow the search scope:

    1. Specify a **date range**
    2. Select an **event type**
    3. Specify an **actor**
  </Accordion>

  <Accordion title="Are API calls recorded in the logs too?">
    Currently, **only data change operations** are recorded. View (GET) requests made through the API are not recorded separately.
  </Accordion>

  <Accordion title="I want to see the history of a specific campaign only">
    There is currently no way to filter directly by campaign ID. Set **Event type** to "Campaign updated" and look for it in the list.
  </Accordion>

  <Accordion title="Can I export logs?">
    Log export is not currently available. If you need it, please contact your administrator separately.
  </Accordion>
</AccordionGroup>

***

## Wrapping up the admin guide

If you've made it this far, you've covered all of the A2 platform's admin features!

To review from the beginning: → [Admin guide overview](/guides/platform-admin/en/user-management)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.