Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
Go to start of metadata

Plugin Information

View Audit Trail on the plugin site for more information.

Keep a log of who performed particular Jenkins operations, such as configuring jobs.
This plugin adds an Audit Trail section in the main Jenkins configuration page. Here you can configure log location and settings (file size and number of rotating log files), and a URI pattern for requests to be logged. The default options select most actions with significant effect such as creating/configuring/deleting jobs and views or delete/save-forever/start a build. The log is written to disk as configured and recent entries can also be viewed in the Manage / System Log section.
Also see the JobConfigHistory Plugin for recording actual changes made to job configurations.


File logger

Output audit logs in rolling files.

The file logger relies on java.util.logging.FileHandler and can use patterns to describe the log file location as documented here (%h, %g...).

Syslog logger

Send audit logs to a Syslog server.

Configuration screen

Advanced configuration screen

Console logger

Output audit logs in stdout or stderr. Primarily intended for debugging purpose.


From version 2.5 on, changelog is automatically generated using release-drafter. See directly the GitHub release page for the plugin.

Older releases

Version 2.4 (11 Jan 2019)
  • Log file logger for Audit trail plugin leaks open file descriptors (JENKINS-44129)
  • Fixes default date format to show time (JENKINS-55376)
Version 2.3 (28 May 2018)
  • Jenkins minimal version bumped to 2.60.3
  • Add a log prefix feature
  • Fix JEP-200 issue in ConsoleAuditLogger (JENKINS-51331)
Version 2.2 (26 Aug 2015)
  • Add stop, restart, prepare for shutdown as default filter (JENKINS-19669)
  • Added project enable/disable to default pattern
  • Added millis to the File audit logger message (JENKINS-29159)
Version 2.1 (16-Sept-2014)
  • Add audit message with build start time, duration, node and cause 
Version 2.0 (23-April-2014)
  • Major refactoring to support multiple outputs
  • Add Syslog output
  • Add Console output
Version 1.8 (31-May-2013)
  • Fixed security vulnerability.
Version 1.7 (3-Aug-2011)
Version 1.6 (24-Feb-2011)
  • Rerelease 1.5 to properly set required Jenkins version.
Version 1.5 (15-Feb-2011)
  • Set a default value for log location.
  • Translation update (German)
Version 1.4 (21-Nov-2009)
  • For queue item URLs, add URL for that item's job in the log entry.
  • Update uses of deprecated APIs
Version 1.3 (3-Mar-2009)
  • Updated to work with Hudson 1.288 and higher. Use version 1.2 for older Hudson versions.
  • Fix so build triggers also appear in Manage / System Log section.
Version 1.2 (13-Feb-2009)
  • Add option to log how each build is triggered (on Hudson 1.283 or higher; older versions just say "Started").
  • Add some more URI patterns to log by default.
Version 1.1 (16-Jan-2009)
  • Minor log setup fixes.
Version 1.0 (15-Jan-2009)
  • Initial release.


  1. Unknown User (msolnit)

    It would be great if the plug-in would just start off with a default location for the log file, e.g. HUDSON_HOME/audit_trail or something.  I don't imagine very many people would ever need to modify it, and it would eliminate the need to learn how j.u.l.FileHandler patters work (personally I had never used one before).

    1. Unknown User (ssbarnea)

      I totally agree with that, default config should be what most users will want.

      1. Unknown User (mindless)

        Added in v1.5

  2. Unknown User (tonvoon)

    Can I request that a disable/enable project is also logged via this plugin?

    1. Unknown User (mindless)

      Please use http://issues.jenkins-ci.org/ for bug reports and feature requests. You can already edit the settings for this plugin and make it log other things, if you can figure out the URL patterns for those things.

    2. Unknown User (markvdbosch)

      I have used the Live HTTP headers plugin to get the correct URL pattern. Add the following pattern to the settings: enable and disable

  3. Unknown User (fmerrow)

    I find it odd that even at "all" this plugin doesn't track Shutdown Request or Shutdown Cancel.

    This seems to me to be an important omission.


    1. Unknown User (mindless)

      Please use http://issues.jenkins-ci.org/ for bug reports and feature requests. You can already edit the settings for this plugin and make it log other things, if you can figure out the URL patterns for those things.

  4. Unknown User (nux)

    How do I configure what actions are logged? Where do I find log levels documentation? Can I only log one action - e.g. when builds are run?

  5. Unknown User (ajaydwarkani@gmail.com)

    How can I create individual logs to see details on each log type such as I need a log just for deleted jobs, another log for added jobs etc.

    Appreciate your help,


  6. Unknown User (walterk82)

    Does anyone know why the common Jenkins plugin information section times-out on this page?  It is working for other plug-in pages.

  7. Unknown User (arseniy_)

    May I specify environment variables in Log Location for File logger?

    For example:


  8. Unknown User (brantone)

    Is it me, or is the file logging of this somewhat flakey? Doesn't create any files until I add a logger, then it starts to actually output to files, and continue to do so after it's removed.

    Also doesn't seem to create the required folder

  9. Unknown User (gotviserion)

    I have the plugin installed and File logger configured to a specific location on the Server.  I had a situation where all the users were removed/deleted from the Global roles list.  When we tried to login we were getting Overall Read Permission denied error.  Later I went and added myself to the Global Admin role in config.xml and added back all the users.  I couldn't find a log related to this issue anywhere in any of the Jenkins logs.  Will this plugin capture what configuration was changes or the addition and removal of any users?