> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/org/activity-log.md).

# Activity Log

See who created, updated, or deleted data in your organization and when, review member login records, and export logs to Excel for audit retention.

The <mark style="color:blue;">Activity Log</mark> records every creation, update, and deletion of data in your organization, as well as member logins. Each record includes the operation time, the member who performed it, the source IP address, and the changes made. Organization administrators can use it to trace who changed an AI assistant's settings and when; security auditors can export records for a selected period to Excel for audit retention.

{% hint style="info" %}
A notice at the top of the page states, "The activity log uses scheduled synchronization. Data is updated every 10 minutes." Operations you have just completed may take up to about 10 minutes to appear in the list and exported files.
{% endhint %}

## Who Can Use It <a href="#who-can-use" id="who-can-use"></a>

* A role must have <mark style="color:blue;">Activity Log Permission</mark> under <mark style="color:blue;">Organization Permissions</mark> to see <mark style="color:blue;">Activity Log</mark> in <mark style="color:blue;">Organization Settings</mark>. Exporting and <mark style="color:blue;">Export Records</mark> use the same permission.
* Roles with the parent <mark style="color:blue;">Organization Permissions</mark> also receive <mark style="color:blue;">Activity Log Permission</mark>.
* Organization owners have this permission by default.

For instructions on configuring permissions, see [Role and Permission Management](/maiagent-user-guide/en/org/roles/role-permission.md).

## How to Access It <a href="#how-to-access" id="how-to-access"></a>

In the left menu, click <mark style="color:blue;">Organization Settings</mark> → <mark style="color:blue;">Activity Log</mark>.

## Recorded Events <a href="#what-is-recorded" id="what-is-recorded"></a>

Each record shows an "Operation Type" and a "Resource Type." For example, an operation type of "Update" and a resource type of "AI Assistant" indicate that a member changed an AI assistant's settings.

### Operation Types <a href="#operation-types" id="operation-types"></a>

| Operation Type                          | When It Is Recorded                                                                                                       |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">Create</mark> | Data is created, such as an AI assistant, knowledge base, or role                                                         |
| <mark style="color:blue;">Update</mark> | The contents or settings of existing data are changed                                                                     |
| <mark style="color:blue;">Delete</mark> | Data is deleted                                                                                                           |
| <mark style="color:blue;">Login</mark>  | A member logs in to the admin console and enters this organization, or switches to this organization in the admin console |

The activity log records only operations that change data and logins. Simply opening a page or viewing data does not create a record.

### Resource Types <a href="#resource-types" id="resource-types"></a>

The resource type identifies the kind of data involved in an operation. The filter dropdown lists only resource types that have actually appeared in this organization. Common types include:

| Category                   | Resource Types                                                                                                                            |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| AI assistants              | AI assistant, AI assistant tool, AI assistant connector, AI assistant skill, AI assistant knowledge base                                  |
| Knowledge bases            | Knowledge base, knowledge base file, knowledge base file tag, FAQ, FAQ tag                                                                |
| Conversations and contacts | Conversation platform, contact, contact conversation platform                                                                             |
| Organization and members   | Organization, member, member time-off period, login record                                                                                |
| Roles                      | Role, role member, role permission, role AI assistant, role knowledge base, role conversation platform, role database, role available LLM |
| Tools and data             | Tool, connector, skill, SQL database, service account                                                                                     |

## Viewing and Filtering Records <a href="#view-and-filter" id="view-and-filter"></a>

The list is sorted from newest to oldest. The columns are described below:

| Column                                               | Description                                                                                                                         |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">Operation Timestamp</mark> | The time the event occurred, displayed in the browser's time zone                                                                   |
| <mark style="color:blue;">User</mark>                | The name and Email of the member who performed the operation; left blank for system events with no associated member                |
| <mark style="color:blue;">Resource Type</mark>       | The kind of data involved in the operation                                                                                          |
| <mark style="color:blue;">Operation Type</mark>      | Create, update, delete, or login, shown in different colors                                                                         |
| <mark style="color:blue;">Details</mark>             | For "Update" events, lists changes as "Field: New value" (up to 300 characters; hover to view the full text); other events show "-" |
| <mark style="color:blue;">IP Address</mark>          | The source IP address of the operation                                                                                              |

### Filters <a href="#filters" id="filters"></a>

Four filters are available above the list. Changing any filter updates the list immediately:

* <mark style="color:blue;">Start Date</mark> / <mark style="color:blue;">End Date</mark>: Includes records on both the start and end dates.
* <mark style="color:blue;">Select User</mark>: Lists organization members' names and Email addresses; enter a keyword to search.
* <mark style="color:blue;">Select Resource Type</mark>: View changes to a specific kind of data, such as "Role."
* <mark style="color:blue;">Select Operation Type</mark>: Create, update, delete, or login.

Click <mark style="color:blue;">Reset Filters</mark> to clear all conditions at once.

### Viewing Event Details <a href="#event-detail" id="event-detail"></a>

Click the eye icon in the <mark style="color:blue;">Actions</mark> column at the far right of the list to open <mark style="color:blue;">Activity Log Details</mark>:

| Section                                              | Contents                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <mark style="color:blue;">Basic Information</mark>   | <mark style="color:blue;">Operation Timestamp</mark>, <mark style="color:blue;">Operation Type</mark> (shown as an English code, such as `UPDATE`), <mark style="color:blue;">Object Model</mark>, and <mark style="color:blue;">Object ID</mark>                                                                                                                                                                                                                                                                                          |
| <mark style="color:blue;">Context Information</mark> | <mark style="color:blue;">User</mark>, <mark style="color:blue;">Organization</mark>, <mark style="color:blue;">IP Address</mark>, <mark style="color:blue;">Request Method</mark>, and <mark style="color:blue;">API Path</mark>; login events instead show <mark style="color:blue;">User</mark>, <mark style="color:blue;">Organization</mark>, <mark style="color:blue;">IP Address</mark>, and <mark style="color:blue;">Login Method</mark> (the code identifying the account's authentication source, such as `maiagent` or `saml`) |
| <mark style="color:blue;">Change Details</mark>      | Shown only for "Update" events: lists each changed field (by its field code) with its <mark style="color:blue;">Old Value</mark> and <mark style="color:blue;">New Value</mark>                                                                                                                                                                                                                                                                                                                                                            |

## Exporting Activity Logs <a href="#export" id="export"></a>

Exports are processed in the background. After creating an export, you can continue using other pages. Once processing finishes, download the Excel file from <mark style="color:blue;">Export Records</mark>.

{% stepper %}
{% step %}

### Set the Export Scope <a href="#export-step-filter" id="export-step-filter"></a>

The export applies the current on-screen filters (date, user, resource type, and operation type). If no filters are set, it exports all records.
{% endstep %}

{% step %}

### Create an Export <a href="#export-step-create" id="export-step-create"></a>

Click <mark style="color:blue;">Export</mark> in the upper right (hover over the button to see "Maximum 50,000 records per export"). Once created successfully, the message "Export task created" appears.
{% endstep %}

{% step %}

### Download the File <a href="#export-step-download" id="export-step-download"></a>

Click <mark style="color:blue;">Export Records</mark> to open the export list. When the <mark style="color:blue;">Status</mark> changes to <mark style="color:blue;">Completed</mark>, click the <mark style="color:blue;">Download</mark> icon in that row to get the file.
{% endstep %}
{% endstepper %}

### Export Status <a href="#export-status" id="export-status"></a>

<mark style="color:blue;">Export Records</mark> lists the <mark style="color:blue;">Status</mark>, <mark style="color:blue;">Record Count</mark>, <mark style="color:blue;">File Size</mark>, <mark style="color:blue;">Processing Duration</mark>, <mark style="color:blue;">Created At</mark>, and <mark style="color:blue;">Completed At</mark> for each export. Use the refresh icon (<mark style="color:blue;">Refresh</mark>) in the upper right to update the list.

| Status                                      | Description                                                                                                                                                                                             |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">Pending</mark>    | The export has been created and is queued for processing                                                                                                                                                |
| <mark style="color:blue;">Processing</mark> | The file is being generated                                                                                                                                                                             |
| <mark style="color:blue;">Completed</mark>  | Ready to download                                                                                                                                                                                       |
| <mark style="color:blue;">Failed</mark>     | An error occurred during processing (the system automatically retries first), or processing has not finished within 2 hours; click <mark style="color:blue;">View Error Details</mark> to see the cause |

While you are on the <mark style="color:blue;">Export Records</mark> page, when an export you created finishes, the message "Export request completed. You can now download the file" appears, and an "Export Completed" browser notification is sent (browser notifications must be allowed). If the export fails, the message "Export request failed. Please view the error details" appears.

{% hint style="warning" %} <mark style="color:blue;">Export Records</mark> lists activity log exports for the entire organization, including exports created by other members. All members with <mark style="color:blue;">Activity Log Permission</mark> can view and download them. Exported files contain member Email addresses, IP addresses, and data contents. Store them according to your company's information security policies.
{% endhint %}

### Exported File Contents <a href="#export-file" id="export-file"></a>

* The format is Excel (`.xlsx`), and the filename is `events_export_<組織 ID>_<日期時間>.xlsx`.
* Each row contains one event, sorted from newest to oldest. If more than 50,000 records match the filters, only the latest 50,000 are included.
* Column names are in English. The main columns are:

| Column           | Contents                                                                                              |
| ---------------- | ----------------------------------------------------------------------------------------------------- |
| `ID`             | Event ID                                                                                              |
| `Timestamp`      | Event time in ISO 8601 UTC format (ending in `+00:00`)                                                |
| `User`           | Email of the member who performed the operation                                                       |
| `Resource Type`  | System code for the resource type, such as `chatbots.Chatbot`                                         |
| `Object ID`      | ID of the data involved in the operation                                                              |
| `Operation`      | Operation type code: `create`, `update`, `delete`, or `login`                                         |
| `Diff Preview`   | The complete contents of the data at the time of the event (JSON format); left blank for login events |
| `Request Method` | Request method, such as `POST` or `PATCH`                                                             |
| `Login Method`   | Authentication source code for login events                                                           |
| `IP Address`     | Source IP address                                                                                     |

## Data Retention <a href="#data-retention" id="data-retention"></a>

Activity logs only accumulate: the admin console provides no function to delete or edit them, and the system also blocks record deletion at the database level. Even organization owners cannot remove a record. Records are not automatically cleared over time. To retain data for a specific period, filter by date and export it.

## FAQ <a href="#faq" id="faq"></a>

### Why Can't I Find a Setting Change I Just Made in the Activity Log? <a href="#faq-not-yet-shown" id="faq-not-yet-shown"></a>

The activity log synchronizes every 10 minutes. Wait a little before refreshing. Exported files use the same data, so operations you have just completed also appear in exports only after synchronization.

### What If I Need to Export More Than 50,000 Records? <a href="#faq-over-export-limit" id="faq-over-export-limit"></a>

Each export is limited to 50,000 records. If the limit is exceeded, only the latest 50,000 are included. Narrow the date range (for example, export one month at a time) and export in batches.

### Why Do Exported Timestamps Differ from the Screen by Several Hours? <a href="#faq-timezone" id="faq-timezone"></a>

The exported `Timestamp` is in UTC, while the screen displays times in the browser's time zone. For example, for Taiwan time (UTC+8), add 8 hours to the exported timestamp to get the time shown on screen.

### What Should I Do If Exports Keep Failing? <a href="#faq-export-failed" id="faq-export-failed"></a>

In <mark style="color:blue;">Export Records</mark>, click <mark style="color:blue;">View Error Details</mark> to check the cause. Exports that have not finished within 2 hours are marked <mark style="color:blue;">Failed</mark>. Narrow the date range and export again. If failures continue, provide the error details to customer support for troubleshooting.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/org/activity-log.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.