mirror of
https://github.com/supabase/supabase.git
synced 2026-10-05 17:35:10 +03:00
docs(auth): clarify audit logs storage options and configuration (#48852)
## Summary - Clarify that external log storage is the default - Explain that Postgres database storage is optional - Fix grammar and typos - Improve admonition messaging to be more actionable - Simplify toggle step wording for clarity Slack thread with team-auth: https://supabase.slack.com/archives/C022071RB2L/p1785945149999009 <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Documentation** * Clarified that audit logs are stored in external log storage by default. * Documented optional database storage in `auth.audit_log_entries`. * Added instructions for enabling or disabling database storage with the “Write audit logs to the database” toggle. * Noted that enabling database storage incurs additional database storage costs. <!-- end of auto-generated comment: release notes by coderabbit.ai -->
This commit is contained in:
1 parent
124ff77ad0
commit
18c26bf933
1 file changed
+6
-12
@@ -18,25 +18,19 @@ Supabase auth audit logs automatically capture all authentication events includi
|
||||
|
||||
## Storage options
|
||||
|
||||
By default, audit logs are stored in two places:
|
||||
Audit logs are stored in:
|
||||
|
||||
1. **Your project's Postgres database** - Stored in the `auth.audit_log_entries` table, searchable via SQL but uses database storage
|
||||
2. **External log storage** - Cost-efficient storage accessible through the dashboard
|
||||
- **External log storage** - Cost-efficient storage accessible through the dashboard
|
||||
- **Postgres database** (optional) - Stored in the `auth.audit_log_entries` table, searchable via SQL, but uses additional database storage
|
||||
|
||||
You can disable Postgres storage to reduce database storage costs while keeping the external log storage.
|
||||
You can enable or disable Postgres database storage to optimize your costs.
|
||||
|
||||
### Configuring audit log storage
|
||||
|
||||
1. Navigate to your project’s dashboard
|
||||
2. Go to **Authentication**
|
||||
3. Find the **Audit Logs** under **Configuration** section
|
||||
4. Toggle on "Disable writing auth audit logs to project database" to disable database storage
|
||||
|
||||
<Admonition type="note">
|
||||
|
||||
Disabling Postgres storage reduces your database storage costs. Audit logs will still be available through the dashboard.
|
||||
|
||||
</Admonition>
|
||||
3. Find the **Audit Logs** under the **Configuration** section
|
||||
4. Toggle "Write audit logs to the database" on to enable or off to disable database storage
|
||||
|
||||
## Log format
|
||||
|
||||
|
||||
Reference in new issue
Block a user