Skip to content

Feature Guide Audit Log

Jump to bottom
fuomag9 edited this page Feb 27, 2026 · 1 revision

Feature Guide: Audit Log

Track configuration changes and user activity in Caddy Proxy Manager.

Table of Contents

  1. What the Audit Log Captures
  2. Search and Pagination
  3. How to Use It
  4. Troubleshooting

What the Audit Log Captures

Audit entries include:

  • Timestamp
  • User (or System)
  • Event summary

Typical events:

  • Proxy host create/update/delete
  • Access list changes
  • Certificate changes
  • Other administrative operations

Use the audit log to answer: who changed what and when.

Search and Pagination

The audit log now supports server-side filtering and paging.

  • Search box filters by event summary, action, and entity type
  • Results are paginated on the server
  • Default page size: 50
  • URL params are used for state:
    • search: current search text
    • page: current page number

Search resets to page 1 automatically when the query changes.

How to Use It

  1. Open Audit Log.
  2. Enter text in Search audit log... to narrow results.
  3. Use pagination controls to browse older/newer pages.
  4. Share a filtered view by copying the URL.

Example URL:

/audit-log?search=proxy&page=2

Troubleshooting

No results found

Checks:

  1. Clear search text and retry
  2. Ensure there is recent activity in the system
  3. Verify you are on page 1 after changing search terms

Unexpected user shown as System

Some operations are intentionally system-generated and are not linked to a human user ID.

Related Documentation

Need help? Open an issue with the query used and expected event details.

Clone this wiki locally