Grails Audit Logging Plugin
The Grails Audit Logging plugin for Grails 3.x adds generic event based Audit Logging to a Grails project and also adds support to domain models for hooking into the GORM events system.
- For Grails 3.x release documentation, see Plugin Documentation
- For Grails 3.x snapshot documentation, see Snapshot Plugin Documentation
- For Grails 2.x documentation, see Grails Plugin Page
Supported Grails versions
- Grails > 3.3: (master branch)
- Grails 3.0.x-3.2.x: 2.x_maintenance branch
- Grails 2.x: 1.x_maintenance branch
Grails 3.2 limitations
If you use Grails 3.2 up to version 3.2.9, you possibly receive a circular dependency exception caused by a bug in gorm-data-mapper. E.g. this can happen if you use the audit-logging plugin and the database-migration plugin and try to perform dbm-update. See grails-database-migration#127 for details. Either use GORM > 6.0.9 when released, or disable the auditLogging plugin before performing runCommands.
Versions 1.1.0 (Grails 2.x) and 2.0.0 (Grails 3.x) are the first versions with audit-quickstart command support.
Therefore, you need to perform "grails audit-quickstart <package> <DomainClass>" after installing this plugin's version(s) and later. See issue #13
With this, you get a AuditLog domain class in your project which is fully under your control. The domain name is registered in your application.groovy with key "grails.plugins.auditLog.auditDomainClassName".
grails audit-quickstart org.example.myproject MyAuditLogEvent
See GitHub Issues
Pull requests are highly appreciated and welcome!
Please add integration tests for new features to the audit-test application.
Special thanks to all the contributors to the project (in alphabetical order):
Aaron Long Aldrin Andrey Zhuchkov Ankur Tripathi Burt Beckwith Dennie de Lange Dhiraj Mahapatro Elmar Kretzer Fernando Cambarieri Graeme Rocher Jorge Aguilera Juergen Baumann Madhava Jay Matthew A Stewart Paul Taylor Sebastien Arbogast Shawn Hartsock Tom Crossland Project lead: Robert Oschwald
Continuous Integration Server
YourKit is kindly supporting Grails open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: YourKit Java Profiler and YourKit .NET Profiler.