Monitoring

Monitoring plugin: Monitoring of the performance of Jenkins itself with JavaMelody.

Open the report (or http://yourhost/monitoring) after installation.

Author : Emeric Vernat (evernat at free.fr)

License ASL

• Charts of memory, cpu, system load average, http response times by day, week, month, year or custom period
• Statistics of http requests with mean response times, mean cpu times, mean response size by request and by day, week, month, year or custom period
• Errors and logs
• Current http requests
• Threads
• Heap histogram (instances and sizes by class)
• Http sessions
• Process list of OS
• MBeans
• Actions for GC, heap dump and invalidate session(s)
• Report in html or pdf
• In English, German, French, Portuguese, Italian, Czech, Ukrainian or Chinese
• Jenkins security
• For Jenkins slaves:
  • The report for the nodes is available at http://yourhost/monitoring/nodes
  • Charts aggregated for all nodes of memory, cpu, system load average, number of running builds, build queue length, build times by period
  • Detailed statistics of the build times and of the build steps by period
  • Threads, process list and MBeans for each nodes
  • Heap histogram aggregated for all nodes
• For each individual node (each node in http://yourhost/computer), reports and actions are available from the "Monitoring" page in the contextual menu or in the detail of the node:
  • Threads, process list, MBeans of that node only
  • Heap histogram of that node
  • Actions for GC, heap dump
• And more...

Online help of JavaMelody

Some Monitoring scripts can be executed using the Jenkins Script Console. The "Monitoring" plugin can be installed by point and click in the plugin manager of a Jenkins server, or it can be downloaded from http://mirrors.jenkins-ci.org/plugins/monitoring/.

You can contribute translations on this website.

See Releases

Canceled

• improved: The javamelody parameter http-transform-pattern is already used in the plugin, in order to limit disk IO and disk space usage for the statistics and RRD graphs of http requests. If that's not enough, some RRD files of graphs for http requests will now be automatically deleted everyday at midnight to limit the disk space used by RRD files under 20 MB. You may configure that limit with the javamelody parameter max-rrd-disk-usage-mb (20 by default). And old statistics and graphs are automatically deleted like before. (553b323)
• added: As an external API, dump of graphs values as XML or as TXT, for the choosen period or for all periods (d11e6a8). See doc.
• added: Links to Last value, Dump XML, Dump TXT below the zoomed graphics (3967ea2).
• added: if using Tomcat, display sources of Tomcat's classes from stack-traces like for the webapp's dependencies (9907e93).

• improved: in the http sessions, identify the new MS Edge browser as Edg instead of Chrome (304819f).
• optimized: when displaying the report, lazy load images in "Other charts" (cb18db5).
• clarify that statistics in reports starts at midnight (in the server's time zone), for example "1 day since midnight" (#897).

• fix JENKINS-60433: JEP-200 error on HsErrPid.
• fix #871, thanks to Vicente Rossello Jaume: In the optional collect server, each current request already displayed once is not displayed anymore after refresh.
• Look further to display the remote user in the current requests. And add sessionId attribute in the current requests for the External API. (PR 873, thanks to Eugene Kortov)
• fix #884, CircularReferenceException in External API with JSON for current requests.
• added: graph of Usable disk space next to Free disk space in "Other charts" (the usable disk space may be lower than the free disk space, #875).
• added: if the monitoring of a Jenkins server is added in the optional collect server, the monitoring of Jenkins nodes including builds are automatically added at the same time (ee06c01).

• After the JavaMelody real case 1, the real case 2 is an the investigation of a Java application with some very slow screens, with detailed explanation on monitoring metrics, statistics and found issues. And the real case 3 on the investigation of why dozen of users are working extra-hours and of other issues. #JavaMelodyRealCase
• added a graph in /monitoring/nodes of the sum of waiting durations in seconds of the builds in the build queue, next to the graph of the build queue length (efa4d03)
• moved documentation from wiki to github
• added new Prometheus metrics in .../monitoring?format=prometheus: used non-heap memory, used buffered memory, used physical memory, used swap space, loaded classes count (a704562).

• fix JENKINS-58419: No redirect after login in the CAS plugin since 1.78.0.
• fix JENKINS-58388, broken 'report' link in Available and Updated tabs of plugin manager.
• fix #843: when using Tomcat, Tomcat info is not available anymore since Tomcat 8.5.35 and Tomcat 9.0.13.
• fix #847: When downloading more than 2GB, assertionError may occur.

• Improved the rendering of the management links in the Administer page (JENKINS-57373).
  Note that the link on "Monitoring of memory, cpu, http requests and more in Jenkins master." goes to the "/monitoring" page.
  And the link on "You can also view the monitoring of builds, build queue and Jenkins nodes." goes to the "/monitoring/nodes" page.
• added: display an alert at the top of the monitoring page when there is an exception while collecting data, in order to make easier to fix basic technical issues in javamelody (a7a8b26). For example, IOException: No space left on device.
• fix to still flush the response when no content in FilterServletResponseWrapper.flushBuffer() (#836)
• added: Czech translations (2d85a88, thanks to Lukáš Karabec)
• improved: missing German translations (c19539b, thanks to Michael Dobrovnik)
• To contribute in your own language, join the translation project at https://poeditor.com/join/project/QIaCp4bThS.

• improved: better aggregation of http requests. The javamelody parameter used by default in this plugin is now -Djavamelody.http-transform-pattern=/\d+/|(?<=/static/|/adjuncts/|/bound/)[\w\-]+|(?<=/ws/|/user/|/testReport/|/javadoc/|/site/|/violations/file/|/cobertura/).+|(?<=/job/).+(?=/descriptorByName/).
• added: Italian translations (ffc028f, thanks to Gianluca Maiorino)
• added: Ukrainian translations (073bc6d, thanks to Yevgen Lasman)
• To contribute in your own language, join the translation project at https://poeditor.com/join/project/QIaCp4bThS.
• added: ability to upload heap dump files to AWS S3 (PR 810, thanks to Salah Qasem).
  To enable the upload of heap dump files to AWS S3:
  1. add a parameter heap-dump-s3-bucketname with the S3 bucket name, in system properties. For example -Djavamelody.heap-dump-s3-bucketname=mybucket in your jenkins.xml file. And restart.
  2. Download this aws-s3-library plugin and install it with the Advanced tab of the Plugin manager in Jenkins.
  3. You also need to provide AWS credentials and AWS region as AWS as environnement variables or system properties or credentials or config files or Amazon services, see doc (scroll down if the target page does not scroll to the right chapter).

• You can now contribute translations for javamelody by using a dedicated website at POEditor. You may contribute some "untranslated" labels for German and Portuguese or you may contribute new translations for Spanish, Italian or your own language. Join the translation project at https://poeditor.com/join/project/QIaCp4bThS
• fix for Prometheus integration: exclude metrics which have no sense (javamelody_log_duration_millis, javamelody_log_errors_count, javamelody_error_errors_count) and metrics for statistics which are not displayed in the reports (e1db7c5, c0f34a2)
• fix #806 for Prometheus integration again: it was printed '<?>' instead of NaN, for 'lastValue' on Java 8 and before.

• Fix #794 Compatibility with Google App Engine using Java 8.
• Fix #779 When using JSVC to launch Tomcat, InternalError: errno: 13 error: Unable to open directory /proc/self/fd
• Enhanced: added X-Frame-Options: SAMEORIGIN in the reports.
• CSRF protection is automatically enabled in the plugin, if CSRF protection is enabled in Jenkins. (Note that a restart is needed if changed in Jenkins.)

Added the Offline viewer tool for some degraded cases:

• If ever you don't have access to the online reports of javamelody on the running server,
• or if you want to view the reports but the server is no longer running,
• then the offline viewer may be for you. See doc

• It is a recommended upgrade for security to fix a XML External Entity (XXE) processing vulnerability. CVE-ID is CVE-2018-15531. Thanks to mounsurf & huanying for reporting the vulnerability. But note that Jenkins uses the Woodstox parser so it is currently safe from this XXE vulnerability.
• Fix warning logs about serializing anonymous classes (issue 768).
• fix: do not require Log4J when sending metrics to InfluxDB or Datadog.
• added: native calendar widget to choose dates for a custom period (84a1d63, with help from my colleague Fabien at KleeGroup)

• Compatibility with JDK 9: -Djdk.attach.allowAttachSelf=true is no longer required to have heap histogram and fix the display of source for a JDK class.

• Compatibility with JDK 9: fix heap dump and heap histogram, display again the graphs of cpu, opened files and physical memory. Note: to have the memory histogram in JDK 9 or later, add -Djdk.attach.allowAttachSelf=true in the java command line.

• Fix "no token found" with Prometheus integration for a Windows server (e47b11b)

• Enhancement: After generating a heap dump, zip it to reduce its size (98cb8bc)

• Added: The mean number of allocated Kilobytes per request is now displayed in the stats, next to the mean cpu per request. It is the memory used in the heap per request and which will have to be cleaned by the Garbage Collector later. And when more memory is used per request, more cpu will be used by the GC. As an example, 1 Gb allocated in a request, without a good reason, is probably a problem. (33fe61d)

• Added: when crash logs (hs_err_pid*.log files) are found, display them in the system actions (5ebb28e)

• Added: in the zoomed charts, display of the 95th percentile line. It shows what would be the maximum on the period if 5% of the highest values (short peaks) were excluded (9f7acba)

• Fix rare issue: ArithmeticException: / by zero in JRobin RRD files (JENKINS-51590).

• Removed the prometheus-include-last-value javamelody parameter and replaced it by the includeLastValue http parameter (08aacb2, see doc). So, in the improbable case that you used prometheus-include-last-value for Prometheus integration, change your scrape_config to:

    params:
      format: ['prometheus']
      includeLastValue: ['true']
  

• Fix #735: NPE when there are no executors.
• Fix #737 for StatsD integration.
• Fix #731: When using CloudWatch, Cloudwatch metric upload can't handle more then 20 items (with help from marcrelation).
• Fix #668: RrdException: Invalid timestamps specified in some particular case when using custom period.

• Added JEP-200 exclusions when using monitoring with slaves (PR #6 thanks to Jesse Glick)
• Note that Jenkins core includes the monitoring classes in its whitelist for the monitoring plugin 1.68.0 or later, but Jenkins servers using the monitoring plugin 1.67 or older need to upgrade the plugin (JENKINS-50280).
• Fix #700 for Prometheus integration (with help from Stefan Penndorf).
• Fix #701 for Datadog integration (PR #702, thanks to bluegaspode).
• Fix #718: NPE when displaying the webapp dependencies in some particular case.
• improved: Warn in the reports if multiple instances use the same storage directory (#692)
• improved: If the application-name parameter is defined, use it when publishing metrics to InfluxDB, Graphite, StatsD, CloudWatch or Datadog instead of the context path (#694)
• added: When using the reports by mail, a new javamelody parameter mail-subject-prefix can be used to configure the subject of the mail notification. For example, in a Tomcat context file: <Parameter name='javamelody.mail-subject-prefix' value='Production environment JavaMelody reports for {0}' override='false'/> (PR #710, thanks to vkpandey82)
• added: In the External API, the url monitoring?part=lastValue&format=json now returns all the last values by names. (The url monitoring?part=lastValue&graph=usedMemory already returns the last value of a single graph by name.)

• added: integration with Prometheus: Metrics are already displayed in the monitoring reports. You can also scrape the same metrics from Prometheus at the frequency you wish for advanced visualizations, if you have a Prometheus server installed (PR #682 & PR #684, thanks to slynn1324). See doc.
  Note : If Jenkins security is enabled, the system property -Djavamelody.plugin-authentication-disabled=true can be added to the Jenkins server in order to disable authentication of the monitoring page in the Monitoring plugin and to allow Prometheus to scrape metrics.
• added integration with StatsD: Metrics are already displayed in the charts of the monitoring reports. As an extra, you can also publish the same metrics to StatsD, if you have a StatsD daemon installed. To enable sending the metrics, add a parameter statsd-address with hostname:port of the StatsD daemon, in system properties. For example -Djavamelody.statsd-address=11.22.33.44:8125 in your jenkins.xml file, see doc. (92aeffe)
• fix #681: upgrade prototype.js, effects.js and slider.js

• remove the slf4j-api dependency from the plugin to avoid potential conflicts with the same dependency in jenkins core.

• In the Jenkins plugin, fix NPE when using CloudWatch or Graphite (3e2b872).
• In the Jenkins plugin with FreeBSD, fix JENKINS-45963: if the collect fails for one slave, continue with the others
• added integration with InfluxDB: Metrics are already displayed in the charts of the monitoring reports. Like integrations with Graphite and AWS CloudWatch, you can also publish the same metrics to InfluxDB for advanced visualizations, if you have an InfluxDB server installed. The parameter is influxdb-url, see doc. (f7c8503)
• added integration with Datadog: Like for InfluxDB, you can also publish the same metrics to Datadog for advanced visualizations. The parameter is datadog-api-key, see doc. (239aa4e)

• improved (Brazilian) Portuguese translation (PR #642, thanks to Sandro Giacomozzi).
• added a monitoring script to display stats of builds and build steps having a mean time greater than the severe threshold. See the script.
• fix #638: When using scripts and alerts to monitor an application, ClassNotFoundException in Jenkins if the monitored webapp is using Ehcache or Quartz jobs.
• Internal classes moved: Many internal classes, which were not public and all in the net.bull.javamelody package, are now moved to net.bull.javamelody.internal.* packages.
• added: In the list of threads, add an action to send an interrupt signal to a thread. The thread can test Thread.currentThread().isInterrupted() to stop itself. (7977f2b)
• added: PDF link in the threads page (b356132)
• added integration with Graphite: Metrics are already displayed in the charts of the monitoring reports. As an extra, you can also publish the same metrics to Graphite for advanced visualizations, if you have a Graphite server installed. Metrics will be sent once per minute (default value of the resolution-seconds parameter) and Graphite will allow custom visualizations in itself or in Grafana. The names of metrics in Graphite are like javamelody.appContext.hostName.metricName, so you will be able to aggregate a metric using wildcards.
  To enable sending the metrics, add a parameter graphite-address with hostname:port of the Graphite server, in system properties. For example -Djavamelody.graphite-address=11.22.33.44:2003 in your jenkins.xml file. (ce94787)
• added integration with AWS CloudWatch: Like for Graphite, you can also publish the same metrics to AWS CloudWatch for custom visualizations and mail or autoscaling alarms, if you have AWS EC2 server instance(s) with detailed monitoring in AWS CloudWatch. Metrics will be sent once per minute (default value of the resolution-seconds parameter) and CloudWatch will allow custom visualizations and mail or auto-scaling alarms. The names of metrics in CloudWatch are like javamelody.metricName. Metrics also include application and hostname as dimensions, so you will be able to filter metrics based on those dimensions. Note that there is a pricing for CloudWatch metrics (it is supposed that about 25 custom metrics should mean about $10 per month per EC2 instance). (e65d605)
  To enable sending the metrics:
  1. add a parameter cloudwatch-namespace with the CloudWatch namespace, in system properties. For example -Djavamelody.cloudwatch-namespace=MyCompany/MyAppDomain in your jenkins.xml file (the namespaces starting with AWS/ are reserved for AWS products). And restart.
  2. Download this aws-cloudwatch-library plugin and install it with the Advanced tab of the Plugin manager in Jenkins.
  3. You also need to provide AWS credentials and AWS region as AWS as environnement variables or system properties or credentials or config files or Amazon services, see doc.

• fix JENKINS-44241: Real User Monitoring (RUM) in v1.66.0 does not work when enabled, for URLs ending with '/'.

• fix #617: Charts of http/sql stats can not be viewed after restarting the application (with help from goldyliang).
• added: Display the number of http sessions and sessions mean size before the list of sessions, when there are more than 20 (PR #629, thanks to Aleksandr Mashchenko).
• improved: When displaying Java sources from stack-traces, locate more sources by reading Maven pom.xml of Jenkins and of the other dependencies.
• added: Display webapp dependencies in a new page, accessed by a link in the System informations details, and include detailed name, website url, Maven groupId:artifactId:version and license of each dependency, based on Maven pom.xml files. (e7607c1)
• added: The version of Jenkins is displayed at the top of the report and a drop-down list of versions next to "Customized" period allows to display the report for the period of each version deployed, to compare between them for example. (d61e65f, based on an idea by dhartford).
• added: Real User Monitoring (RUM). It allows to measure the experience from the end user perspective, by monitoring times in the browser for each html page until it is displayed and ready to be used (b85652a).
• The Real User Monitoring works by injecting on the fly a Boomerang javascript at the end of html pages, just before the </body> end tag, which sends data back to the monitoring in your server. Then in the detailed monitoring report of http requests for html pages, times and percentages are displayed for Network, Server execution, DOM processing and Page rendering, to compare which ones contribute to a good or bad end user experience. The Real User Monitoring does not add a noticeable overhead on the server, but the javascript adds a simple http(s) call for each html page, which may add a small overhead on the client browser.
• This Real User Monitoring is not enabled by default. To enable it, add the system property "-Djavamelody.rum-enabled=true" in your jenkins.xml file.

• added: configuration to list Jenkins maven public repository next to ~/.m2/repository and Maven central, to be able to display Jenkins and plugins sources from stack-traces.

• fix JENKINS-42112, HTTP user session is reported as "anonymous" when using anything but AbstractPasswordBasedSecurityRealm (like Google login plugin or Cloudbees Operations Center).
• fix compatibility with Java 9. (PR #609 for issue #556, thanks to James Pether Sörling)
• improved: make easier the selection of the stack-trace text in the tooltips of the threads list (736cf0e)
• added: pdf report in the detail page of a request. (28e2474)
• added: links to view java source from errors and threads stack-traces. (e5263bf)

• Source from the JDK and source from artifacts built by Maven and available in Maven central can be viewed. So if your server uses a JRE and not a JDK, source from the JDK are not available. And note that many artifacts available in Maven central were not built by Maven, for example Tomcat libraries, so sources of those artifacts can't be located.
• added: if the javamelody parameter -Djavamelody.jmx-expose-enabled=true is set (in the jenkins.xml file), then javamelody mbeans are available with aggregated statistics data about requests. The javamelody mbeans can be read with the MBeans screen in 'System actions' of the monitoring report (http://jenkinsserver:8080/monitoring?part=mbeans) or using JMX with the JConsole of the JDK. (PR #591 thanks to Alexey Pushkin)

• doc added: Summary of javamelody parameters to extend the javamelody user's guide.

1.64.0

• added: check for updated version of javamelody. If a new version is available, a message is now displayed at the top of the report to notify about the new version. For that, javamelody pings the server javamelody.org. And to better understand javamelody users, anonymous data such as java version and OS is sent to that server at the same time. An example of the data sent is: uniqueId="3d117c04b914c78ddbaf14818c404c8e88c6e56f", serverInfo="jetty/9.2.z-SNAPSHOT", javamelodyVersion="1.63.0", applicationType="Jenkins", javaVersion="Java(TM) SE Runtime Environment, 1.8.0_111-b14", jvmVersion="Java HotSpot(TM) 64-Bit Server VM, 25.111-b14, mixed mode", maxMemory="1024", availableProcessors="4", os="Windows 7, Service Pack 1, amd64/64", databases="", countersUsed="http|error|log", parametersUsed="log", featuresUsed="pdf", locale="fr_FR", usersMean=1, collectorApplications=-1.
• Usage stats based on the anonymous data will be publicly available at http://javamelody.org/usage/stats for applications using JavaMelody v1.63 or later (including Jenkins using the Monitoring plugin) and able to contact the server.
• You may disable the update check with the javamelody parameter "update-check-disabled=true" in system properties. If you want to, add the system property "-Djavamelody.update-check-disabled=true" in the jenkins.xml file.
• The online demo of javamelody is finally back. To see it, you can play a bit with this app (written by Benjamin Durand some years ago) to be sure to have some data in http and sql statistics, then open the monitoring page to explore the reports.

• fix XSS (reported by Omar El Mandour)

• fix XSS (reported by Dallas Kaman, Praetorian Group)

• Fix XSS in graph page (PR 555, thanks to Tim Helmstedt)
• fix JENKINS-34794 Jenkins sometimes doesn't start because of transient NPE (thanks to Félix Belzunce Arcos)
• improved: JENKINS-34736 Migrate to 2.9 parent pom (thanks to Armando Fernández)
• added system property "csrf-protection-enabled" to enable protection against CSRF on actions such as run GC, invalidate sessions, kill thread by id ... (Not enabled by default since an attacker would need to know about javamelody in Jenkins and about its URLs and would need to force an administrator to access the monitoring and even in this case, the attacker certainly can't make Jenkins unvailable and can't steal data or anything.) To enable this protection, add the system property "-Djavamelody.csrf-protection-enabled=true" in the jenkins.xml file.
• Limit error messages to 1000 characters and error stack-traces to 50000 characters, to avoid high memory consumption when log messages are very long (PR 550, thanks to Zdenek Henek)

• fix username in the list of http sessions (d111126)
• fix issue 533: IllegalArgumentException during metrics update (JENKINS-33050)
• fix issue 532: do not flush a closed output stream.
• improved: wrap very long http queries without whitespace, in order to fit into the screen and to avoid horizontal scrollbar (3a88a75)
• added: display the client's browser and OS in the list of http sessions (6d89f42)
• added: Support Log4J 2 since v2.4.1 like Log4J (068139d)
• added: Show used memory in dialog after manual GC (issue 522)

• fix JENKINS-23442, ClassCircularityError: java/util/logging/LogRecord (0ad60da)
• Upgraded mininum Jenkins version to 1.580.1
• replace use of deprecated Jenkins api
• fix from PR 505 and PR 507: German translations (thanks to mawulf)
• fix issue 492: incompatibility of the release v1.57.0 (isAsyncStarted) with servlet api 2.5 (when using mvn hpi:run in development).
• added: 2 new graphs are displayed in "Other charts", below the main charts: "% System CPU" and "Used buffered memory" (5029404).
  • % System CPU is the CPU usage for the whole system (not just the JVM), between 0 and 100%.
  • Used buffered memory is the memory used, either by direct buffers allocated outside of the garbage-collected heap, using ByteBuffer.allocateDirect, or by mapped buffers created by mapping a region of a file into memory, using FileChannel.map.

• fix: check if async before flushing the response (ee87b4b thanks to Mark Thomas)
• fix: used/max file descriptor counts are not displayed in oracle java 8 (c04ef79 thanks to Colin Ingarfield)
• Jenkins plugin: scripts examples updated to get data from slaves in Jenkins Monitoring Scripts, below the scripts for Jenkins master.
• improved: An api page is now available in the monitoring with links to the ExternalAPI. The path of the page in your Jenkins is "monitoring?resource=help/api.html".
• added: it's now easy to write scripts to get monitoring data from a monitored webapp and to send alerts based on thresholds, using Jenkins for Continuous Monitoring. See the documentation.

• The JavaMelody project is migrated from GoogleCode (https://code.google.com/p/javamelody) to GitHub. The new project home page is: https://github.com/javamelody/javamelody/wiki
• The monitoring plugin for Jenkins does not move and is at https://github.com/jenkinsci/monitoring-plugin

• fix issue 477: In the processes list, CPU and Command are sometimes in the wrong column
• added: MULTILINE & DOTALL flags for transform-patterns regexps (issue 474, thanks to Michal Bergmann).

• fix issue 453: Chinese translation for heap dump (thanks to chuxuebao)
• fix issue 436: implement Servlet 3.1 new methods (JavaEE 7), in FilterServletOutputStream and others
• fix issue 455: HTTP-401 / WWW-Authenticate wrongly reported as HTTP error

• fix: Monitoring reports of a slave didn't work if its name contains a space.
• fix issue 440: Not able to start Desktop version.

• fix: in v1.52.0 with Tomcat, graphs of bytes received/sent and of Tomcat active threads were not displayed anymore in "Other charts" (revision 3908).
• fix issue 439: Display Linux version in "System informations", and not "Linux unknown"
• improved: Portuguese translation (revision 3885, thanks to Fernando Boaglio)
• added: new system property "javamelody.sampling-included-packages" for a white list in cpu hotspots, instead of using the "javamelody.sampling-excluded-packages" system property (issue 424, thanks to alf.hogemark)

• fix security issues. See Jenkins security advisory.

• fix: for Maven type jobs on recent Jenkins versions, builds of Maven modules are displayed as always running in the /monitoring/nodes page
• fix: the logout action in the menu did not work in the /monitoring/nodes page

• Upgraded mininum Jenkins version to 1.509.3
• added: display of build steps and their durations, in the detail of each build statistics in the "/monitoring/nodes" page. Example:

• added: The system property "javamelody.nodes-monitoring-disabled" can be used to disable the periodic monitoring of slaves. Either at startup, for example "-Djavamelody.nodes-monitoring-disabled=true" in the jenkins.xml file, or even at runtime. Disabling periodic monitoring of slaves can help against issues, if there are Jenkins slaves and if the communication with slaves is too unstable in the Jenkins remoting.
• improved: reduce the number of RRD files created in some conditions, by not creating a RRD file of mean times if a request is called only once (revision 3836). Otherwise, obsolete RRD files are automatically deleted after 3 months like before.
• added: links "View in a new page" below the tables of threads and of current requests (revision 3839). For example when Jenkins is under load, the new pages make it easy to refresh at will the details of threads or of the current requests to see if states change or not, without refreshing all the main page.
• added: logout action in the menu on the right of the main report (revision 3859)
• fixed JENKINS-21357 Node monitoring action: Use the specific computer's sidepanel instead of Jenkins default page. But the actions on the left sidepanel may be broken because of JENKINS-23963.

• fix: when using java 8, cpu graph was not displayed
• Drop Java 5 support (revision 3795)
• Optimized desktop UI startup time, by downloading desktop app and caching locally (revision 3762)
• improved: in a graph detail, a checkbox can now hide maximum values in the graph, so that average values are better displayed when much lower than the maximum (issue 368)
• added: PID in the heap dump file name (revision 3773)

• Fix icons and links on some Jenkins servers in the new Monitoring page of individual nodes (JENKINS-20935)
• fix issue issue 370: work around ConcurrentModificationException during Tomcat startup (which is a Tomcat bug)
• fix issue issue 386: IllegalArgumentException: No enum const class ..., in Turkish
• improved: In the US, depending on the browser's language or on the javamelody parameter "locale", the paper size is now Letter in the US, instead of A4 like in the other countries. (revision 3679, thanks to Dennis)
• improved css styles: font finally fixed to Arial/Helvetica (revision 3718).
• added: Menu. A floating button is available on the right of the main report to drag a menu in or out. The menu displays the list of chapters in the report and allows to jump easily between them (revision 3705).
• added: Custom reports. Links to custom reports can be included in the floating menu described above.
  For that, add a system property named "javamelody.custom-reports". In the value of this system property, put the list of names of the custom reports separated with commas. Then for each custom report, add a system property with the same name and its path as value. By default, the following properties are already defined:
  -Djavamelody.custom-reports=JenkinsInfo,AboutMonitoring
  -Djavamelody.JenkinsInfo=/systemInfo
  -Djavamelody.AboutMonitoring=https://wiki.jenkins-ci.org/display/JENKINS/Monitoring

• added: For each individual node (each slave in http://yourhost/computer), reports and actions are available from the "Monitoring" page in the contextual menu or in the detail of the node:
  • Threads, process list, MBeans of that node only
  • Heap histogram of that node
  • Actions for GC, heap dump
  • (JENKINS-20935, with help from Oleg Nenashev)
• improved: When I call the "Invalidate http sessions" action, invalidate all sessions except mine (I can still invalidate my session individually after that)
• improved: In the list of http sessions, a bullet shows which one is my own session, if I have a session
• improved css styles with the come back of shadows in Firefox and with hovers for images, ~_(see) _(JavaMelody\ Demo)~ (revision 3614)

• fix JENKINS-20352: HTTP session count is high, since Jenkins v1.535 (revision 3569)
• fix issue 354: With the java update 1.7_u45, the Desktop app does not start

• fix issue 339: "One day" memory leak
• fix issue 346: XSS through X-Forwarded-For header spoofing
• fix issue 232: Use the path of -XX:HeapDumpPath=/tmp if defined, for the directory of heap dump files (otherwise use the temp directory of the server as before)
• added: detection of cpu hotspots can be enabled (issue 149, with some ideas from Cédric Lime).
  • In the monitoring reports, the new Hotspots screen displays CPU hotspots in executed methods for all the JVM. Like javamelody, the overhead of hotspots is low: it is based on sampling of stack-traces of threads, without instrumentation. And like javamelody, it is made to be always active if enabled. (It is currently not enabled by default. It may be enabled by default in the future.) Two parameters can be defined as system properties in the jenkins.xml file:
  • "javamelody.sampling-seconds" to enable the sampling and to define its period. A period of 10 seconds can be recommended to have the lowest overhead, but then a few hours may be needed to have significant results for a webapp under real use. If you don't mind having a bit more overhead or want a result faster in test, you can use a value of 1 or 0.1 in second for this parameter.
  • "javamelody.sampling-excluded-packages" to change the list of the excluded packages ("java,sun,com.sun,javax,org.apache,org.hibernate,oracle,org.postgresql,org.eclipse" by default)

• fix JENKINS-17757 IllegalStateException: Timer already cancelled from NodesCollector.scheduleCollectNow
• use a timeout for the monitoring of slaves, when a slave is online but does not respond
• fix NPE when manually purging the obsolete monitoring files of slaves

• added: button to kill a thread from the current requests (issue issue 302)
• added: button to donate in the html reports, to better inform users of this possibility

• fix: it is currently useless to display the sql hits for the current requests
• fix: better aggregation of http requests in the statistics, for URLs /adjuncts/... and /$stapler/bound/... (also reduces the disk space used to store data)
• fix issue 289, JENKINS-15529: NoClassDefFoundError: com/sun/management/OperatingSystemMXBean, in JBoss AS 7 without configuration of modules
• page added: Some can be executed using the Jenkins Script Console.

• fix issue 270: French Canadians can't choose a customized period
• fix: in the current requests, use the chosen period to display the statistics of mean times, besides the elapsed times
• added: PDF report of the current requests
• added: optional parameter "locale" to fix the locale of the reports, whatever the language in the browser (issue 271, thanks to xiukongtiao). You can add, for example, the system property -Djavamelody.locale=en_US

• fix issue 262 NullPointerException in MonitoringFilter.doFilter(), when the webapp is undeployed and after a timeout
• added: New alternative User Interface for the monitoring reports with a Rich Desktop Application. Highlights :
  • All reports and data like in the web UI
  • Exports to PDF, XML and JSON formats, even if the monitored application does not have the dependencies to do the same in the web UI
  • Tabs to view different reports
  • Columns of tables may be sorted, resized and moved
  • Exports with right-click for all tabular data to CSV, PDF, RTF, HTML, XML, JSON formats
  • Shortcuts, such as F5
  • Started in one-click with the "Desktop" link at the top of the web UI. The required libraries are downloaded automatically from ~_(googlecode)~ github on the first launch.
  • Uses JavaWebStart and requires JRE 1.7 on the client
  • This new UI may be an alternative to the web UI for advanced users or for exports

• fix issue 252 Add XSS protection
• fix issue 255 exception while collecting data java.io.FileNotFoundException: Could not open ....rrd existent

• fix issue 14050, also for the monitoring reports of Nodes.
• added in the external API: XML and JSON exports of MBeans, and of JNDI tree given a JNDI context path. Documentation is here. For example: MBeans and JNDI.

• fix issue 14050, also when security is enabled in Jenkins: Unreadable HTML response for the monitoring reports. Compression of the monitoring reports is now disabled in the plugin and the reports will be compressed by Jenkins starting with v1.470.

• fix issue 14050, but only when security is not enabled in Jenkins: Unreadable HTML response for the monitoring reports

• fix issue 207: Incompatibility with servlet api 2.4 (Tomcat 5.5) in Monitoring plugin 1.36.0
• added: Reduce the possibility of storage overload by deleting automatically the obsolete RRD files (which were not updated for the last 3 months), and which were for requests which do not exist anymore. Note: the size of existing RRD files is fixed for ever and old .ser.gz files are already automatically deleted after a year.
• added: Display the disk usage of the storage at the bottom of the report

• JavaMelody is used inside the Monitoring plugin. Thanks to CloudBees Jenkins CI, nightly build, javadoc and sources of JavaMelody are available.
  ~(And\ there\ is\ a\ public\ demo\ of\ JavaMelody.\ It\ is\ based\ on\ the\ latest\ source\ in\ trunk\ and\ is\ continuously\ deployed.\ It\ is\ currently\ not\ a\ demo\ in\ Jenkins,\ but\ instead\ in\ an\ application\ with\ GWT,\ services\ and\ SQL.)~
  ~(First,\ you\ can\ play\ with\ this\ quick\ and\ dirty) _(GWT\ application) (to\ have\ some\ data\ (thanks\ Benjamin))~
  ~(Then\ you\ can\ view\ the\ charts\ and\ the\ statistics\ in\ the) _(monitoring\ reports) _((no\ password))~

• Other notes:
  • fix blocking issue 194: The jrobin v1.5.9 artifacts are now available in the Maven central repository as you can see here. The external (and currently unreachable) repository in the javamelody pom is now useless and removed.
  • fix issue 201: Unable to render MBeans tree when some JMX-retrieval exception occurs
    added: if there are deadlocked threads in the JVM, print a warning message with the names of the deadlocked threads at the top of threads dump, like in the html and pdf reports (revision 2678)
  • This version requires a Servlet 2.5 container (fixed in 1.37.0)

• fix issue 178: Since v1.32, "Nb of http sessions" is 0 and "View http sessions" is always empty.
• added: graphic of "Build queue length" in the monitoring of nodes, next to the graphic of "Running builds" (done in Jenkins Hackathon, with help from Kohsuke Kawaguchi)
• added: optional parameter (-Djavamelody.dns-lookups-disabled=true) to allow disabling of dns lookups with InetAddress.getLocalHost() to prevent long hangs on startup/shutdown in some particular environments (issue 181, thanks to r6squeegee)

• Minor bugfixes such as fonts in the PDF reports for Chinese people, when the first PDF report was made for non Chinese people

• fix issue 11293 Monitoring plugin not installed because of NoClassDefFoundError: org.slf4j.ILoggerFactory on IBM J9 JVM (rev 40073)

• fix issue 151: a Java 1.6 dependency was introduced in 1.32.0 (NoSuchFieldError: ROOT)

• fix issue 141: exception while collecting data java.io.IOException: Read failed, file xyz not mapped for I/O (after out of disk space)
• added: Chinese translation, and fix display of Chinese characters in the JRobin graphics and in the PDF reports (issue 150)
• added: Action "Generate a heap dump" added for IBM JDK like for Oracle JDK, patch by David Karlsen in the javamelody users' group
• added: Add link "Dump threads as text" below the list of threads
• added: Provide an url (monitoring?action=mail_test) to test sending a pdf report by mail (issue 145).

• fix issue 128: Clean the shutdown process
• To display the username in the list of http sessions, look at ACEGI_SECURITY_LAST_USERNAME if getRemoteUser() was null.

• fix issue 116: MBeans overview does not work with java 1.5
• fix issue 117: Sorting of numbers is based on String comparison in German
• fix issue 122: Average number of requests per minutes seems to be wrong, with a single day in a custom period
• fix issue 124: Start date removed from the text at the top of the monitoring page, except if the "All" period is selected.

• fix issue 106: a few HTTP hits are lost in the statistics for the first hit(s) on new requests (no impact on statistics once requests are known)

• fix issue 99: NullPointerException when displaying the list of process on AIX

• added: pdf report of MBeans

• fix issue 8344 (ClassNotFoundException: net.bull.javamelody.SessionListener)
• added: Portuguese Brazil translation, including the online help, thanks to Luiz Gonzaga da Mata and Renan Oliveira da Cunha. This translation is the default for all Portuguese people. The first language in the browser settings should be Portuguese (pt) or Portuguese/Brazil (pt-br) to use it. The online help in Portuguese Brazil is also available.
• added: in the nodes report, chart of the number of the running builds by period

• fix some issues in the monitoring of Jenkins nodes when the operating systems of the nodes are heterogeneous
• fix issue 80: Memory histogram should be supported on Mac OS X
• added: if JRockit, display the JRockit specific MBeans
• added: pdf reports of http sessions and of heap histogram

• fix issue 74: "View OS Processes" does not work on MAC OS X Server

• added: In the system actions, new view "MBeans" with the values and the descriptions of the attributes. (MBeans contain configuration and low-level data on the application server and on the JVM). The values are viewable but not writable and operations can not be performed.

• added: Monitoring of the Jenkins nodes (slaves in general) similar to the monitoring of the Jenkins master.

  If the monitoring of the Jenkins master is available at http://localhost:8080/monitoring then the monitoring of the Jenkins nodes is available at http://localhost:8080/monitoring/nodes.

  The monitoring of the Jenkins nodes includes:

  • Aggregated "used memory" chart, aggregated "% cpu" chart (between 0 and 100) for day, week, month, year or a custom period.
  • Chart of the build times over time for the selected period
  • Other aggregated charts: % GC, threads count, loaded classes count, system load average, open file descriptors count and more for the selected period
  • Statistics of the build times for the selected period
  • Running builds with time elapsed
  • Threads informations for each node including name, state, stack-trace and an action to kill any thread
  • Heap histogram aggregated for all nodes
  • Current system informations for each node
  • MBeans for each node
  • Last values in charts and MBeans values. For example, the following URLs can be used: 1 and 2 (the plugin-authentication-disabled parameter could be used)
  • Process informations for each node
  • Actions to execute the GC or to generate a heap dump on each node

• Due to the current infrastructure changes for the maven2-repository in java.net, the "Monitoring" plugin 1.24.0 was not in the plugin manager.

• fix issue 66: Since tomcat 6.0.21 and when tomcat based authentication is used, session count is false and there is a possible memory leak for invalidated http sessions in v1.22.0. This is because of the changes for tomcat enhancement 45255. To tomcat experts: Isn't an http session supposed to die first before being able to born a second time?

• fix: Maximum values in statistics could be incorrect
• added major feature: graphic of the number of sessions and details on http sessions with the link in "System informations" (this is emulated without httpsessionlistener, because httpsessionlistener can't be used in Jenkins plugins)
• added: If Jenkins security is enabled, the system property -Djavamelody.plugin-authentication-disabled=true can be added to a Jenkins server in order to disable authentication of the monitoring page in the Monitoring plugin and to be able to add the server to a javamelody centralized collect server. (A system property like -Djavamelody.allowed-addr-pattern=127\.0\.0\.1 can also be added with the ip address of the collect server)

• fix to display the list of http sessions when Tomcat throws an exception "Session already invalidated"
• fix to display the list of process when using Windows in Germany
• added: If Tomcat or JBoss, new graphics in "Other charts" for the number of active http and ajp threads in the server, the number of bytes received per minute and the number of bytes sent per minute by the server.

• added: German translation thanks to Ewald Arnold. We would like to have feedback here.
• fix: In the html display of the current requests, put back the complete http request with query parameters and values, like it was displayed before v1.17.0

• fix NumberFormatException requesting process information.
• fix (removed) jndi link in Winstone.
• added debugging logs.

• other minor bugs fixed.

• some minor bugs fixed.

• change to reduce disk usage: Some common http requests are now aggregated in statistics, for example on build numbers.

The javamelody.http-transform-pattern parameter has now the default value of

/\d+/|/site/.+|avadoc/.+|/ws/.+|obertura/.+|estReport/.+|iolations/file/.+|/user/.+|/static/\w+/

and all matches in http URLs will be replaced by "$". Note that it is possible on each Jenkins server to change the value of this parameter with a system property -Djavamelody.http-transform-pattern=xxx in the java command line.

• change to reduce disk usage: Graphics in http errors and in errors logs are no longer displayed

• fix: There was an InternalError on ubuntu or debian using the tomcat package with jsvc

• added: remember the last selected period (with a persistent cookie in the browser)
• added: UI option to display graphs and statistics for custom periods, via fields of start and end dates of period to display

• added: New charts "Threads count", "Loaded classes count", "Used non heap memory", "Used physical memory", "Used swap space" (displayed with the new link "Other charts")
• added: Button to kill a java thread
• added: parameters can now be specified in environment variables like in system properties or webapp context
• added: new parameter "monitoring-path" to change the url "/monitoring" of the report to "/admin/monitoring" for example
• added: new parameter "mail-periods" to change the period of mail reports from weekly to daily or monthly or a combination of the 3
• added: display the version of JavaMelody at the bottom of the html and pdf reports
• added: display of "ajax GET" or "ajax POST" in http requests names for ajax requests

• English: For people outside US, UK and France, default language is now the default locale of the server or English.

• Fix: The "Monitoring" link in "/manage" page did not work when Jenkins was in a servlet context (not in the root context of the server).
• JavaMelody fix: someone had an exception in report on Solaris 10 (getPID)

• Removed jdbc graphs as there is no database in Jenkins,
• Removed sessions graph, values and links as the javamelody SessionListener can't be registered without modifying web.xml
• Added a link in "/manage" page
• Added checkPermission to check authentication if configured

• Initial

Translations for other languages such as Spanish are welcomed.

To contribute in your own language, join the translation project at https://poeditor.com/join/project/QIaCp4bThS.

or see in English: https://github.com/javamelody/javamelody/blob/master/javamelody-core/src/main/resources/net/bull/javamelody/resource/translations.properties
the same in French: https://github.com/javamelody/javamelody/blob/master/javamelody-core/src/main/resources/net/bull/javamelody/resource/translations_fr.properties

Use maven commands "mvn hpi:run" or "mvn package" like for all Jenkins plugins

http://wiki.jenkins-ci.org/display/JENKINS/Plugin+tutorial