A Jenkins plugin for monitoring Jenkins with Sematext.

Jenkins Sematext Dashboard

Note: The Jenkins CI plugin page for this plugin references this documentation.


Sematext App Creation

To be able to see your Jenkins metrics you just need to create Sematext Account and Sematext Jenkins App if you didn't do this already.

Sematext Agent Installation

To be able to see your Infrastructure and Jenkins JVM metrics simply install the Sematext Agent. It's open-sourced on Github and you can customize the Jenkins integration to collect data you want and then build custom dashboards using that data.

Plugin Installation

This plugin requires Java 8 or newer.

This plugin can be installed from the Update Center (found at Manage Jenkins -> Manage Plugins) in your Jenkins installation:

  1. Select the Available tab, search for Sematext, and select the checkbox next to Sematext Plugin.
  2. Install the plugin by using one of the two install buttons at the bottom of the screen.
  3. To verify the plugin is installed, search for Sematext Plugin on the Installed tab.

Continue below for configuration.

Plugin Configuration

To configure your Sematext Plugin, navigate to the Manage Jenkins -> Configure System page in your Jenkins installation. Once there, scroll down to find the Sematext Plugin section:

Jenkins Sematext Plugin UI

Select Region to house your data

  1. Select the radio button with Sematext Region which you will use to house your data. Which Region you specify here depends on the Region in which you created the Sematext Jenkins App - US or EU.
  2. (advanced) Paste your Receiver URL in the Sematext Jenkins App Receiver URL. You can find the Receiver URL in the integration instructions for your Jenkins App in Sematext. Test your Receiver URL by using the Test URL button.
  3. Paste your Monitoring App Token, also found in the integration instructions for your Jenkins App in Sematext, in the Sematext Jenkins App Token textbox on the Jenkins configuration screen.
  4. Test your Sematext Jenkins App Token by using the Test App Token button on the Jenkins configuration screen directly below the App Token textbox.
  5. Save your configuration.

Data collected

This plugin collects the following Jenkins metrics. More metrics are collected by the Sematext Agent. See Jenkins integration docs for the full list of Jenkins metrics:


Metric Name Description Tags
jenkins.runs.success The count of success job runs.,,,
jenkins.runs.unstable The count of unstable job runs.,,,
jenkins.runs.failure The count of failure job runs.,,,
jenkins.runs.not_built The count of not build job runs.,,,
jenkins.runs.aborted The count of aborted job runs.,,, The count of jobs.,,, The count at which jobs are scheduled. If a job is already in the queue and an identical request for scheduling the job is received then Jenkins will coalesce the two requests. This metric gives a reasonably pure measure of the load requirements of the Jenkins master as it is unaffected by the number of executors available to the system.,,, The count of queued jobs.,,, The count at which jobs in the build queue enter the blocked state.,,, The count at which jobs in the build queue enter the buildable state.,,, The count at which jobs enter the quiet period.,,, The amount of time jobs spend in execution state.,,, The total time jobs spend in the build queue.,,, The amount of time jobs in the build queue enter spend in blocked state.,,, The amount of time jobs in the build queue enter spend in buildable state.,,, The total amount of time that jobs spend in their quiet period.,,, The time jobs spend from entering the build queue to completing building.,,,

Issue Tracking

GitHub's built-in issue tracking system is used to track all issues relating to this plugin: jenkinsci/sematext-plugin/issues.


See the

How to contribute code

First of all and most importantly, thank you for sharing.

Checkout the contributing guidelines before you submit an issue or a pull request.