{"id":22280981,"url":"https://github.com/jenkinsci/audit-trail-plugin","last_synced_at":"2025-04-07T10:25:29.597Z","repository":{"id":1231209,"uuid":"1163429","full_name":"jenkinsci/audit-trail-plugin","owner":"jenkinsci","description":"Jenkins audit-trail plugin","archived":false,"fork":false,"pushed_at":"2025-03-26T14:47:53.000Z","size":620,"stargazers_count":23,"open_issues_count":5,"forks_count":50,"subscribers_count":97,"default_branch":"master","last_synced_at":"2025-03-31T09:09:38.152Z","etag":null,"topics":["administrative-monitor","audit","logging"],"latest_commit_sha":null,"homepage":"https://plugins.jenkins.io/audit-trail/","language":"Java","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jenkinsci.png","metadata":{"files":{"readme":"README.adoc","changelog":"CHANGELOG.adoc","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2010-12-13T05:25:45.000Z","updated_at":"2025-03-26T14:47:58.000Z","dependencies_parsed_at":"2024-12-03T16:11:31.966Z","dependency_job_id":"865d0027-aea1-40a3-9a80-3fcc1f61896f","html_url":"https://github.com/jenkinsci/audit-trail-plugin","commit_stats":null,"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Faudit-trail-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Faudit-trail-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Faudit-trail-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Faudit-trail-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jenkinsci","download_url":"https://codeload.github.com/jenkinsci/audit-trail-plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247633620,"owners_count":20970353,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["administrative-monitor","audit","logging"],"created_at":"2024-12-03T16:11:21.084Z","updated_at":"2025-04-07T10:25:29.557Z","avatar_url":"https://github.com/jenkinsci.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"= Audit Trail Plugin\n\nimage:https://img.shields.io/jenkins/plugin/v/audit-trail.svg[link=https://plugins.jenkins.io/audit-trail]\nimage:https://img.shields.io/github/release/jenkinsci/audit-trail-plugin.svg?label=changelog[link=https://github.com/jenkinsci/audit-trail-plugin/releases/latest]\nimage:https://img.shields.io/jenkins/plugin/i/audit-trail.svg?color=blue[https://plugins.jenkins.io/audit-trail]\n\nThis plugin keeps a log of who performed particular Jenkins operations, such as configuring jobs.\n\nThis plugin adds an _Audit Trail_ section in the main Jenkins configuration page.\nOn this page, you can configure log destination and settings\n(eg file size and number of rotating log files), and a URI pattern for\nrequests to be logged.\nThe default options select most actions with\nsignificant effect such as creating/configuring/deleting jobs and views\nor delete/save-forever/start a build.\nThe log is sent to the target as configured (writen to disk, to console, sent to Elastic Search or Syslog).\n\nAlso see the\nhttps://wiki.jenkins.io/display/JENKINS/JobConfigHistory+Plugin[JobConfigHistory\nPlugin] for recording actual changes made to job configurations.\n\n== Logger Configuration\n\n=== File logger\n\nOutput audit logs in rolling files.\n\nimage:docs/images/jenkins-audit-trail-file-logger.png[image,width=400]\n\nThe file logger relies on `java.util.logging.FileHandler` and can use\npatterns to describe the log file location as documented\nhttp://docs.oracle.com/javase/7/docs/api/java/util/logging/FileHandler.html[here]\n(`+%h+`, `+%g+`...).\n\nA separator can be set for the file logger in case further parsing of the file is done.\nDefault separator is a space.\n\n=== Syslog logger\n\nSend audit logs to a Syslog server.\n\nimage:docs/images/jenkins-audit-trail-syslog-logger.png[image,width=400]\n\nimage:docs/images/jenkins-audit-trail-syslog-logger-advanced.png[image,width=400]\n\n=== Console logger\n\nOutput audit logs in `stdout` or `stderr`.\nPrimarily intended for debugging purpose.\n\nimage:docs/images/jenkins-audit-trail-console-logger.png[image,width=400]\n\n=== Elastic Search logger\n\nSend audit logs to an Elastic Search server\n\nimage:docs/images/jenkins-audit-trail-elastic-search-logger.png[image,width=400]\n\n== Other configuration\n\n=== Log build triggers\n\nWill log the cause of a build. Defaults to true.\n\n=== Log credential users\n\nWill log usage of credentials as long as they are consumed through the https://plugins.jenkins.io/credentials/[Credentials plugin].\nDefaults to true.\n\n=== About the client IP-address appearing in the logs\n====\nThe plugin uses a method that cannot guarantee that the actual IP of the client is captured.\nhttps://javaee.github.io/javaee-spec/javadocs/javax/servlet/ServletRequest.html#getRemoteAddr--[More details]\nBe aware of this limitation, especially if your instance is configured behind a reverse proxy.\nFor getting client IP-address correctly it's required to set HTTP-header *X-Forwarded-For* on the reverse proxy side.\nAlso follow these https://www.jenkins.io/doc/book/system-administration/reverse-proxy-configuration-troubleshooting/[recommendations] in order to get round this limitation.\n====\n\n== Changelog\nifdef::env-github,env-browser[:outfilesuffix: .adoc]\n\nFrom version 2.5 on, changelog is automatically generated using\nhttps://github.com/toolmantim/release-drafter[release-drafter]. See\ndirectly\nthe https://github.com/jenkinsci/audit-trail-plugin/releases[GitHub\nrelease page for the plugin].\n\nFor older releases, have a look to the \u003c\u003cCHANGELOG#,archive\u003e\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Faudit-trail-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjenkinsci%2Faudit-trail-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Faudit-trail-plugin/lists"}