This plugin for Jenkins pulls Test Automation data from Dynatrace AppMon and displays it through charts and tables on the project and build level.
Release 2.1.0 adds support for Jenkins Pipelines. Configuration and usage examples are described here.
- Download Latest Release
- Install from Jenkins Plugin Center
- Jenkins Plugin on the Dynatrace Community
- Publishing on jenkins-ci.org
The recommended way of installing the plugin is by the Update Center (plugin directory). Navigate to Manage Jenkins -> Manage Plugins
page and switch to the Available
tab. Search for the "Dynatrace" keyword and install the plugin.
This procedure is meant for developers who want to install locally built plugin version.
- build the plugin from source using
mvn package
command - in Jenkins, go to
Manage Jenkins -> Manage Plugins
page - switch to the
Advanced
tab - upload the built plugin package from
target/dynatrace-dashboard.hpi
path in theUpload Plugin
section - restart Jenkins when the installation is complete
If you are using Jenkins 2.5 or higher, you need to enable the use of environment variables - see Jenkins 2.5+ build step execution failed with java.lang.NullPointerException
The global settings for the plugin are located under Manage Jenkins -> Configure System -> Dynatrace Application Monitoring
. The connection to the Dynatrace AppMon Server is configured in this section. The configured user needs to have the right credentials to be able to access the Test Automation REST API.
The advanced section enables you to set a delay before retrieving the test results from the server. Change this settings if you are not getting all the test results in Jenkins.
In the build configuration (<Project> -> Configure
), first enable Use Dynatrace AppMon to monitor tests in the Build Environment
tab and fill the required fields.
You can then choose one of two options to register Test Run:
- Option 1, when:
- you want an easy integration and don't want to adapt your build scripts too much
- you are OK with defining the version in Jenkins to register the Test Run
- Option 2, when:
- you don't mind using an additional plug-in in your Ant/Maven scripts
- you want to re-use the Ant/Maven version to register the Test Run
At the end of the build, add the Dynatrace AppMon post-build action to retrieve the test results. You can also decide if the test results will change the build status.
Passing Test Run id registered from Jenkins to Maven
Registering Test Run using Dynatrace Maven plugin
Passing Test Run id registered from Jenkins to Ant
Registering Test Run using Dynatrace Ant plugin
Passing Test Run id registered from Jenkins to NAnt
- Jenkins Plugin FAQ / Troubleshooting Guide
- Post any problems, questions or suggestions to the Dynatrace Community's Application Monitoring & UEM Forum.
- Continuous Delivery & Test Automation
- Capture Performance Data from Tests
- Integrate Dynatrace in Continuous Integration Builds
- Online Perf Clinic - Eclipse and Jenkins Integration
- Online Perf Clinic - Metrics-Driven Continuous Delivery with Dynatrace Test Automation
- Continuous Performance Validation in Continuous Integration Environments
- Software Quality Metrics for your Continuous Delivery Pipeline – Part I
- Software Quality Metrics for your Continuous Delivery Pipeline – Part II: Database
- Software Quality Metrics for your Continuous Delivery Pipeline – Part III – Logging
- Automated Performance Analysis for Web API Tests