Timestamper1.8.8Minimum Jenkins requirement: 1.608ID: timestamper
Adds timestamps to the Console Output.
Compatible with Java 7 and above.
Enable timestamps within the "Build Environment" section of the build's configuration page.
To enable timestamps for multiple builds at once, use the Configuration Slicing Plugin version 1.32 or later.
Instructions: Pipeline Builds
Since Timestamper 1.8
Use the timestamps step to wrap the rest of the pipeline script.
Since Timestamper 1.7
Prior to Timestamper 1.8, timestamps can only be recorded within a node.
- The timestamp format can be configured via the Configure System page.
- There is a panel on the left-hand side of the console page which allows either the system clock time or the elapsed time to be displayed.
- The time zone used to display the timestamps can be configured by setting a system parameter as described here: Change time zone.
Scripts can read the timestamps from the /timestamps URL of each build.
By default, display the elapsed time in seconds with three places after the decimal point.
Display the system clock time and append the line from the log.
Display the elapsed time and append the line from the log.
Display both the system clock time and the elapsed time.
Display the current time on the Jenkins master.
Supported query parameters:
- time (since 1.8)
Display the system clock time. Accepts the JDK SimpleDateFormat format.
The time zone and locale of the Jenkins server will be used, unless they are configured with the timeZone and locale query parameters.
- elapsed (since 1.8)
Display the elapsed time since the start of the build. Accepts the commons-lang DurationFormatUtils format.
- precision (since 1.3.2)
Display the elapsed time in seconds, with a certain number of places after the decimal point. Accepts a number of decimal places or values such as seconds and milliseconds.
- appendLog (since 1.8)
Display the console log line after the timestamp.
- startLine (since 1.8)
Display the timestamps starting from a certain line. Accepts a positive integer to start at that line, or a negative integer to start that many lines back from the end.
- endLine (since 1.8)
Display the timestamps ending at a certain line. Accepts a positive integer to finish at that line, or a negative integer to finish that many lines back from the end.
- timeZone (since 1.8)
Time zone used when displaying the system clock time. Accepts the JDK TimeZone ID format.
- locale (since 1.8)
Select the locale to use when displaying the system clock time. Accepts a locale in the format recognised by commons-lang LocaleUtils.toLocale.
- currentTime (since 1.8.8)
Display the current time on the Jenkins master instead of reading timestamps from the build.
Reading the timestamps directly from the file system is not recommended, because the format may change.
Since Timestamper 1.8
Other plugins can add a dependency on the Timestamper plugin, and then use the TimestamperAPI.read method to retrieve the timestamps.
The read method accepts any query string that can be passed to the /timestamps URL.
New releases may take a few hours to appear in the update center.
- Improve performance when generating logs for a pipeline build. (JENKINS-40762) (pull request #20)
Contributed by Edwin Flores
- Can now retrieve the current time from the /timestamps URL. (JENKINS-21687)
- Reverted changes made under JENKINS-34019 because they clash with custom Jenkins themes. (JENKINS-38390)
The timestamps are no longer affected by styles applied by the AnsiColor plugin. (JENKINS-34019)(reverted in next release 1.8.7)
- Console page settings were not appearing for some users. (JENKINS-38085)
- Prevent unnecessary warning messages from being logged with Timestamper 1.8.5 installed. (JENKINS-38098)
- Performance: Read from end of log file for finished build (pull request #18)
Contributed by Akbashev Alexander
- Improve error reporting when invalid parameters are passed to the /timestamps URL.
- Requires Java 7 or later.
- When reading the log file, handle escape characters that do not form part of a console note. (JENKINS-36103)
- Allow running behind an HTTPS proxy. (JENKINS-35315)
- Prevent warning messages when workflow-step-api is not installed. (JENKINS-35375)
- Make the workflow-step-api dependency optional.
- Custom pipeline step for recording timestamps. (JENKINS-30142)
- Display a link to the raw console output including timestamps. (JENKINS-26794)
- New query parameters recognised by the /timestamps URL: time, elapsed, appendLog, startLine, endLine, timeZone, locale.
- Java API for retrieving timestamps from other plugins. (JENKINS-21213)
- The elapsed time is measured from the actual build start time, rather than the scheduled start time.
- Persist the chosen timestamp display settings. This was broken since 1.7.2. (JENKINS-32074)
- Change cookie path from '/' to the root URL of Jenkins (JENKINS-29899)
Contributed by Kiyoshi Ohgishi
- Display the console page settings within the side panel with the other actions. (JENKINS-28948)
- Support for newer Jenkins to display the settings in the console page. (JENKINS-29361)
- Timestamps now appear during pipeline builds. (pull request #13)
Contributed by Jesse Glick
- Requires Jenkins 1.608.
- Retain the selection to use the browser's time zone when not using "system" time. (pull request #14) (pull request #15)
Contributed by Sebastian Schuberth
- Add an option to use the browser's time zone. (pull request #11)
Contributed by michael1010
- Japanese translations. (pull request #12)
Contributed by Pei-Tang Huang
- Allow clicking on the text labels next to the radio buttons. (JENKINS-27054)
Contributed by Paul Fee
- Fix encoding problem with the German translation of the plugin description. (JENKINS-26206)
- Reduce size of the X-ConsoleAnnotator HTTP header. (JENKINS-23867)
The header size may have caused problems depending on how your web container is configured.
- Fix incompatibility with Jenkins 1.572 or later. (JENKINS-23867) (JENKINS-23943) (pull request #9)
Contributed by Geoff Cummings
- Allow the time zone for the timestamps to be configured. (JENKINS-22586)
- Further German translations. (pull request #8)
Contributed by phoenix384
- German translations. (pull request #6) (pull request #7)
Contributed by phoenix384
- Declare the licence in the POM file. (pull request #5)
Contributed by Tom Van Eyck
- Implemented a work-around for servers that do not reliably report the elapsed time. (JENKINS-19778)
- Support for gzipped build logs.
- Requires Java 6 or later.
- Requires Jenkins 1.520.
- Fix minor incompatibility with Publish Over SSH Plugin. (JENKINS-19193)
- Update the DurationFormatUtils URL in the help messages. (pull request #4)
Contributed by Bananeweizen
- Display timestamps correctly when viewing the truncated console log. (JENKINS-17779)
Contributed by Kohsuke Kawaguchi
- Prevent another NPE being thrown when the slave is taken offline during a build. (JENKINS-16778) (pull request #3)
Contributed by jdewinne
- Traditional Chinese translations. (pull request #2)
Contributed by Pei-Tang Huang
- Workaround a bug in Jenkins which causes a VM crash. (JENKINS-16528)
- Prevent an NPE being thrown when the slave is taken offline during a build. (JENKINS-16778)
- Support for Internet Explorer 8. (JENKINS-16598)
- Prevent NPE when the servlet mapping is "/". (JENKINS-16438)
- Can choose to display either the system clock time, the elapsed time since the build started, or no timestamps at all. (JENKINS-14931)
- The elapsed time format can be configured.
- The timestamp data now requires less disk space and does not clutter the build log file. (JENKINS-14932)
If you use a script to read the timestamp data directly from the build log file, you will need to either:
(a) Modify the script to read from the /timestamps URL instead (recommended) OR
(b) Provide the -Dtimestamper-consolenotes=true VM argument when starting Jenkins to use the old format.
- Scripts can read timestamps from the /timestamps URL of each build.
- Requires Jenkins 1.461.
- Can configure an empty timestamp format.
- The timestamp format is configurable. (pull request #1)
Contributed by Frederik Fromm
- Requires Jenkins 1.450.
- Built from github repository with new Jenkins infrastructure. No behavioural changes.
- Timestamps no longer interfere with the Ant target highlighting.
- More robust implementation; prevents errors that could arise for some build configurations. (JENKINS-7112)
- Requires Jenkins 1.374.
- Fix incompatibility with Mercurial Plugin. (JENKINS-7111)
- Initial release.
- Requires Jenkins 1.349.