A Jenkins plugin that collects test results and job metrics from multiple Jenkins jobs and presents them in consolidated HTML reports, email notifications, and Grafana dashboards.
Test Results Aggregator is designed to be used as the last step in a CI/CD pipeline. It queries multiple Jenkins jobs via the Jenkins API, aggregates their test and coverage results, and produces unified reports for teams, products, or testing types.
| Framework | Jenkins Plugin |
|---|---|
| JUnit | junit |
| TestNG | testng-plugin |
| NUnit | nunit |
| Framework | Jenkins Plugin |
|---|---|
| JaCoCo | jacoco |
| HTML Report | Main View |
|---|---|
 |
 |
 |
 |
 |
 |
- Jenkins 2.426.3 or later
- Java 11 or later
- For email notifications: SMTP server configured via the Mailer plugin
- For Grafana integration: a running InfluxDB instance
All jobs being aggregated must publish their own test results (JUnit/TestNG/NUnit) and coverage results (JaCoCo) individually before this plugin can collect them.
Install via Jenkins Plugin Manager:
- Navigate to
Manage Jenkins→Manage Plugins→Available - Search for Test Results Aggregator
- Install and restart Jenkins
Navigate to Manage Jenkins → Configure System → scroll to Test Result Aggregator.
| Argument | Description |
|---|---|
| Jenkins Base URL | The HTTP address of your Jenkins instance, e.g. http://yourhost.yourdomain/jenkins/. Used to access the Jenkins API. |
| Jenkins Account Username | Username of the account used to access the Jenkins API and fetch job results. |
| Jenkins Account Password/Token | Password or API token for the account above. |
| Mail Notification From | Sender address for email notifications. Defaults to Jenkins. |
The plugin supports both FreeStyle and Pipeline job types.
stage("Report") {
testResultsAggregator jobs: [
[jobName: 'My CI Job1'],
[jobName: 'My CI Job2'],
[jobName: 'My CI Job3']
]
}
testResultsAggregator(
columns: 'Job, Build, Status, Percentage, Total, Pass, Fail',
recipientsList: 'nick@some.com,mairy@some.com',
outOfDateResults: '10',
sortresults: 'Job Name',
subject: 'Test Results',
jobs: [
[jobName: 'My CI Job1', jobFriendlyName: 'Job 1', groupName: 'TeamA'],
[jobName: 'My CI Job2', jobFriendlyName: 'Job 2', groupName: 'TeamA'],
[jobName: 'My CI Job3', groupName: 'TeamB'],
[jobName: 'My CI Job4', groupName: 'TeamB'],
[jobName: 'My CI Job6'],
[jobName: 'My CI Job7']
]
)
publishHTML(target: [
allowMissing: true,
alwaysLinkToLastBuild: true,
keepAll: true,
reportDir: "html",
reportFiles: 'index.html',
reportName: "Results"
])
testResultsAggregator(
ignoreDisabledJobs: true,
ignoreNotFoundJobs: true,
ignoreRunningJobs: false,
compareWithPreviousRun: true,
overrideJenkinsBaseURL: 'https://newjenkinsurl.com',
overrideAPIAccountUsername: 'myname',
overrideAPIAccountPassword: 'mypassword',
jobs: [
[jobName: 'My CI Job1', jobFriendlyName: 'Job 1', groupName: 'TeamA'],
[jobName: 'My CI Job2', jobFriendlyName: 'Job 2', groupName: 'TeamA']
]
)
testResultsAggregator(
ignoreDisabledJobs: true,
ignoreNotFoundJobs: true,
compareWithPreviousRun: true,
influxdbUrl: 'http://influxdbhost:8086',
influxdbToken: 'your-influxdb-token',
influxdbBucket: 'TestResultsAggregatorBucket',
influxdbOrg: 'MyOrg',
jobs: [
[jobName: 'My CI Job1', jobFriendlyName: 'Job 1', groupName: 'TeamA'],
[jobName: 'My CI Job2', jobFriendlyName: 'Job 2', groupName: 'TeamA'],
[jobName: 'My CI Job3', groupName: 'TeamB'],
[jobName: 'My CI Job4', groupName: 'TeamB']
]
)
| Field | Required | Description |
|---|---|---|
jobName |
Yes | Exact Jenkins job name. For jobs inside folders use folderName/jobName or folder1/folder2/jobName. |
jobFriendlyName |
No | Display name used in reports. Falls back to jobName if omitted. |
groupName |
No | Groups jobs in the report (e.g. by team, product, or test type). |
| Argument | Description |
|---|---|
columns |
Comma-separated list of columns to include. Possible values: Health, Job, Status, Percentage, Total, Pass, Fail, Skip, Commits, LastRun, Duration, Description, Packages, Files, Classes, Methods, Lines, Conditions, Sonar, Build |
recipientsList |
Comma-separated To recipients. Leave empty to skip email. Supports job variables, e.g. ${my_param}. |
recipientsListCC |
Comma-separated CC recipients. Supports job variables. |
recipientsListBCC |
Comma-separated BCC recipients. Supports job variables. |
recipientsListIgnored |
Recipients to notify about ignored jobs. |
subject |
Email subject prefix. Supports job and environment variables. |
beforebody |
Plain text or HTML to prepend to the email body. Supports job and environment variables. |
afterbody |
Plain text or HTML to append to the email body. Supports job and environment variables. |
theme |
Report/email theme. Options: light, dark |
sortresults |
Sort order for the report. Options: Job Name, Job Status, Total Tests, Pass Tests, Failed Tests, Skipped Tests, Percentage, Commits, Time Stamp, Duration, Build Number |
| Argument | Description |
|---|---|
outOfDateResults |
Mark jobs whose last result is older than X hours with red in the Last Run column. Leave blank to show timestamps without highlighting. |
compareWithPreviousRun |
Show deltas (+ / -) compared to the previous run for statuses, test counts, and coverage. Options: true / false |
ignoreAbortedJobs |
Exclude jobs with status ABORTED from the report. Options: true / false |
ignoreDisabledJobs |
Exclude jobs with status DISABLED from the report. Options: true / false |
ignoreNotFoundJobs |
Exclude jobs that could not be found. Options: true / false |
ignoreRunningJobs |
If true, report the previous result for currently running jobs and mark them with an asterisk. If false, report status as RUNNING. Options: true / false |
| Argument | Description |
|---|---|
overrideJenkinsBaseURL |
Override the Jenkins base URL set in Global Configuration. |
overrideAPIAccountUsername |
Override the API username set in Global Configuration. |
overrideAPIAccountPassword |
Override the API password/token set in Global Configuration. |
| Argument | Description |
|---|---|
influxdbUrl |
InfluxDB URL, e.g. http://influxdbhost:8086 |
influxdbToken |
InfluxDB access token |
influxdbBucket |
InfluxDB bucket name |
influxdbOrg |
InfluxDB organisation name |
A sample Grafana dashboard is provided in docs/grafana/Test Results Aggregator.json. Import it into your Grafana installation. The sample uses a bucket named TestResultsAggregatorBucket — update it to match your influxdbBucket value.
Requires an InfluxDB data source already configured in Grafana.
Full release history is on the GitHub Releases page.
| Version | Notes |
|---|---|
| 1.1.x | Requires Jenkins < 2.277 |
| 1.2.x | Requires Jenkins >= 2.277 |
| 2.x | Integrated with the Jenkins client library |
| 2.1.x | Java 11 support |
| 3.x | Grafana / InfluxDB integration added |