Introduction

LesliAudit is the official audit trail and analytics engine for the Lesli Framework.

It records account activity and provides administrators with searchable operational history and usage insights.

Features

• Account activity and audit logs
• Request and navigation history
• Request, device, and authenticated-user analytics
• Direct account and authenticated-user request counters
• Configurable batched data retention
• Normalized browser, platform, and device categories
• Detailed views for investigating recorded activity

Activity logs are explicit append-only business or security events. They are separate from request analytics: user requests are grouped counters, while user journals are individual normalized HTTP request events.

Try LesliAudit

• Try the online demo
• Run the Docker demo

Quick Start

Requirements

• Ruby 3.x and Rails ~> 8.1
• A Rails application with Lesli ~> 5.1.0
• SQLite by default, or PostgreSQL when preferred by the host application

Install LesliAudit

Add the engine to the host Rails application and prepare its database:

bundle add lesli_audit
bin/rails lesli:db:prepare

Mount the engine

Applications using Lesli's standard router mount LesliAudit automatically at /audit:

# config/routes.rb
Rails.application.routes.draw do
    Lesli::Router.mount(self)
end

If the application does not use the standard Lesli router, mount the engine directly:

# config/routes.rb
Rails.application.routes.draw do
    mount LesliAudit::Engine => "/audit"
end

Start Rails and visit http://127.0.0.1:3000/audit:

bin/rails server

Development

Clone LesliAudit into the host application's engines directory:

cd RailsApp
mkdir -p engines
git clone https://github.com/LesliTech/LesliAudit.git engines/LesliAudit

Reference the local engine from the host application's Gemfile:

gem "lesli_audit", path: "engines/LesliAudit"

Install dependencies, prepare the host database, and start Rails:

bundle install
bin/rails lesli:db:prepare
bin/rails server

Tests

From a complete Lesli development workspace, run the engine test suite from the LesliAudit directory:

cd engines/LesliAudit
bin/rails test

Documentation

• Lesli website
• Documentation
• Architecture and data policy
• Configuration
• Request analytics
• Activity events
• Operational tasks
• Database
• Frontend development
• Release notes
• Issue tracker
• Source code

Community

• X: @LesliTech
• [email protected]
• https://www.lesli.tech

License

Copyright (c) 2026, Lesli Technologies, S. A.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

The complete license text is available in the license file.

The Open-Source SaaS Development Framework for Ruby on Rails.