Skip to content
Merged
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 54 additions & 0 deletions content/4.auth/8.activity-log.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
---
description: Learn to audit user activity and enforce accountability using the activity log.
---

# Activity Log

<!-- TODO: Image -->

The activity log module provides a collective timeline of all data-changing actions taken within your project. It is accessed via the notifications tray of the sidebar. The page shares the filtering and search with the [Collection Page](/data-modeling/collections).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The page shares the filtering and search with the Collection Page

Really struggled to read this - took me a few times. Worth revision?


::callout{type="warning" url="/auth/creating-users" title="External Changes"}

Read more about creating users.

Directus can only track the events which actually pass through its platform. Therefore, any changes made to the database
directly are not tracked.

::
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What's going on here? I think line 13 needs removing?


## View an Activity Log Item

<!-- TODO: ![Activity Log Default Fields](https://cdn.directus.io/docs/v9/configuration/activity-log/activity-log-20220816/activity-log-default-fields-20220816A.webp) -->

Click on any item in the activity log and a side drawer will open, displaying its logged details. The following information
is stored for each item:

- **User** — The user that performed the action.
- **Action** — The specific action taken (e.g., Create, Update, Delete, Comment, or Login).
- **TimeStamp** — The timestamp of when the action was performed.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure TimeStamp is capitalized like this

- **IP Address** — The IP address of the device from which the action was performed.
- **User Agent** — The description of the browser that was used to perform the action.
- **Collection** — The Collection affected by the action.
- **Item** — The ID of the item affected.
- **Comment** — The comment left by the user (when applicable).

## Filter by Activity

<!-- TODO: <video title="Filter by Activity" autoplay playsinline muted loop controls>
<source src="https://cdn.directus.io/docs/v9/configuration/activity-log/activity-log-20220816/filter-by-activity-20220817A.mp4" type="video/mp4" />
</video> -->

In addition to the filter and display functionality inherited from the
[Collection Page](/data-modeling/collections), you can also filter items by activity from the
navigation bar.

## Modify an Activity

<!-- <video title="Filter by Activity" autoplay playsinline muted loop controls>
<source src="https://cdn.directus.io/docs/v9/configuration/activity-log/activity-log-20220816/modify-an-activity-20220817A.mp4" type="video/mp4" />
</video> -->

To ensure proper accountability, system collections are read only by design. However, users with an Admin role have
the ability to reopen, view, and modify an item's values in activities from non-system collections (where the name does
not begin with `directus_`).