Introduce reportTestTimestamp option and include timestamp for test sets and test cases by kevinnammour · Pull Request #3261 · apache/maven-surefire

kevinnammour · 2026-02-14T19:15:13Z

New feature, improvement proposal

Issue
Enhacement issue: Add Test Start Timestamp to Surefire XML Reports #3249

Summary

Introduce an explicit test timestamp field in XML reports at both the testsuite and testcase levels. This enhancement will allow each test suite and individual test case to record the precise processing time of execution.

The addition of test timestamps makes it easier to correlate test execution events with external, time-based system metrics such as CPU usage, memory consumption, I/O activity, JVM metrics, and other system-level monitoring data.

The timestamp:

Represent the exact processing time of execution for each test suite and test case
Use ISO‑8601 format (UTC) for interoperability
Only shown when reportTestTimestamp is set to true

Motivation & Use Cases
This makes it easier to correlate test execution with time-based external signals, such as:

CPU usage
memory consumption
I/O pressure
JVM metrics
system-level monitoring data

Report Example

<testsuite
    name="com.example.MyTest"
    timestamp="2026-01-29T06:41:12.345Z"
    time="12.345">
<testcase
    name="shouldProcessData"
    classname="com.example.MyTest"
    timestamp="2026-01-29T06:41:15.123Z"
    time="0.456">
.......

Following this checklist to help us incorporate your contribution quickly and easily:

Each commit in the pull request should have a meaningful subject line and body.
Write a pull request description that is detailed enough to understand what the pull request does, how, and why.
Run mvn clean install to make sure basic checks pass. A more thorough check will
be performed on your pull request automatically.
You have run the integration tests successfully (mvn -Prun-its clean install).

If your pull request is about ~20 lines of code you don't need to sign an Individual Contributor License Agreement if you are unsure please ask on the developers list.

To make clear that you license your contribution under the Apache License Version 2.0, January 2004 you have to acknowledge this by using the following check-box.

I hereby declare this contribution to be licenced under the Apache License Version 2.0, January 2004
In any other case, please file an Apache Individual Contributor License Agreement.

…XML reports

kevinnammour · 2026-02-14T23:24:00Z

Hi @olamy, this is the PR we discussed a couple of weeks ago about the test timestamp reporting, please take a look when ur free.

elharo

Sounds good, but major new features should start with an issue, not a PR

elharo

are any user doc updates required for this?

...efire-common/src/main/java/org/apache/maven/plugin/surefire/report/StatelessXmlReporter.java

kevinnammour · 2026-02-23T13:28:28Z

Sounds good, but major new features should start with an issue, not a PR

Hi @elharo, this enhancement was reported in this issue: #3249 through which we were invited to open a PR in case we couldn't rely on the custom reporters.

elharo · 2026-02-23T13:47:44Z

Thanks. You need to include the issue in the PR description.

aghoussaini · 2026-02-23T23:41:13Z

Can you add a "how to use" section? @kevinnammour

...in/java/org/apache/maven/plugin/surefire/extensions/junit5/JUnit5Xml30StatelessReporter.java

olamy

LGTM thanks

… inline toIsoInstant logic

kevinnammour · 2026-02-24T10:48:10Z

Can you add a "how to use" section? @kevinnammour

Hello, it can be activated through the reportTestTimestamp config flag; and the parameter docs are automatically generated from the javadoc through the site goal, so no need for manual doc updates.

...efire-common/src/main/java/org/apache/maven/plugin/surefire/report/StatelessXmlReporter.java

maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/report/TestSetStats.java

surefire-its/src/test/resources/enable-timestamp-element/src/test/java/TestA.java

…ehavior in dummy tests

...ava/org/apache/maven/plugin/surefire/extensions/DefaultStatelessReportMojoConfiguration.java

kevinnammour · 2026-02-25T06:39:04Z

Thanks guys, let me know if there's anything else needed from my side.

olamy · 2026-03-02T09:33:54Z

@kevinnammour I was on my way merging it but we probably need to update the xsd files? https://github.com/apache/maven-surefire/blob/master/maven-surefire-plugin/src/site/resources/xsd/surefire-test-report.xsd

Can you do it now or in a follow-up PR? because I will merge a big PR today so I wanted to merge yours first and resolve conflicts rather than force you to do it.
Please let me know

kevinnammour · 2026-03-02T09:56:20Z

@kevinnammour I was on my way merging it but we probably need to update the xsd files? https://github.com/apache/maven-surefire/blob/master/maven-surefire-plugin/src/site/resources/xsd/surefire-test-report.xsd

Can you do it now or in a follow-up PR? because I will merge a big PR today so I wanted to merge yours first and resolve conflicts rather than force you to do it.
Please let me know

I can do it now. Thanks.

…ets and test cases (apache#3261) * Introduce reportTestTimestamp option and include start timestamps in XML reports * Explicitly state deprecation reason of StatelessXmlReporter ctor, and inline toIsoInstant logic * Make test/testset startAt getters package private, and remove sleep behavior in dummy tests * Adapt surefire test report format to include timestamp field

olamy · 2026-03-02T11:15:25Z

@kevinnammour thanks for your work and your patience ;)

…ets and test cases (#3261) (#3302) * Introduce reportTestTimestamp option and include start timestamps in XML reports * Explicitly state deprecation reason of StatelessXmlReporter ctor, and inline toIsoInstant logic * Make test/testset startAt getters package private, and remove sleep behavior in dummy tests * Adapt surefire test report format to include timestamp field Co-authored-by: Kevin Nammour <[email protected]>

Introduce reportTestTimestamp option and include start timestamps in …

1293135

…XML reports

kevinnammour marked this pull request as ready for review February 14, 2026 19:22

kevinnammour mentioned this pull request Feb 18, 2026

Add Test Start Timestamp to Surefire XML Reports #3249

Closed

elharo reviewed Feb 22, 2026

View reviewed changes

...efire-common/src/main/java/org/apache/maven/plugin/surefire/report/StatelessXmlReporter.java Show resolved Hide resolved

...efire-common/src/main/java/org/apache/maven/plugin/surefire/report/StatelessXmlReporter.java Outdated Show resolved Hide resolved

olamy linked an issue Feb 24, 2026 that may be closed by this pull request

Add Test Start Timestamp to Surefire XML Reports #3249

Closed

olamy added the enhancement New feature or request label Feb 24, 2026

olamy added this to the 3.5.6 milestone Feb 24, 2026

olamy reviewed Feb 24, 2026

View reviewed changes

...in/java/org/apache/maven/plugin/surefire/extensions/junit5/JUnit5Xml30StatelessReporter.java Show resolved Hide resolved

olamy approved these changes Feb 24, 2026

View reviewed changes

Explicitly state deprecation reason of StatelessXmlReporter ctor, and…

bb73b64

… inline toIsoInstant logic

elharo requested changes Feb 24, 2026

View reviewed changes

...efire-common/src/main/java/org/apache/maven/plugin/surefire/report/StatelessXmlReporter.java Show resolved Hide resolved

elharo requested changes Feb 24, 2026

View reviewed changes

Make test/testset startAt getters package private, and remove sleep b…

4087475

…ehavior in dummy tests

elharo requested changes Feb 24, 2026

View reviewed changes

...ava/org/apache/maven/plugin/surefire/extensions/DefaultStatelessReportMojoConfiguration.java Show resolved Hide resolved

kevinnammour requested a review from elharo February 25, 2026 06:38

Adapt surefire test report format to include timestamp field

d6101b8

olamy self-assigned this Mar 2, 2026

olamy merged commit 0fba0ef into apache:master Mar 2, 2026
14 checks passed

Conversation

kevinnammour commented Feb 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

New feature, improvement proposal

Uh oh!

kevinnammour commented Feb 14, 2026

Uh oh!

elharo left a comment

Choose a reason for hiding this comment

Uh oh!

elharo left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

kevinnammour commented Feb 23, 2026

Uh oh!

elharo commented Feb 23, 2026

Uh oh!

aghoussaini commented Feb 23, 2026

Uh oh!

Uh oh!

olamy left a comment

Choose a reason for hiding this comment

Uh oh!

kevinnammour commented Feb 24, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

kevinnammour commented Feb 25, 2026

Uh oh!

olamy commented Mar 2, 2026

Uh oh!

kevinnammour commented Mar 2, 2026

Uh oh!

Uh oh!

olamy commented Mar 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

kevinnammour commented Feb 14, 2026 •

edited

Loading