JavaMelody Grails Plugin

  • Tags : performance, monitoring
  • Latest : 1.44
  • Last Updated: 19 May 2013
  • Grails version : 2.0 > *
15 votes

2% of Grails users

Dependency : 
compile ":grails-melody:1.44"

Documentation Source Issues

Summary

Integrate JavaMelody Monitoring into grails application.

Installation

grails install-plugin grails-melody

Or download from javamelody to your local file system, such as D:/plugins, and run

grails install-plugin "D:/plugins/grails-grails-melody-<version>.zip"

The plugin will copy a GrailsMelodyConfig.groovy to your grails-app/conf directory. Basically you don't have to change this file to run grails melody plugin.

Link to Release notes of JavaMelody (and of JavaMelody Grails Plugin)

There are known issues, see here, here or here

Description

This plugin integrates JavaMelody system monitoring tool into grails application. When a grails application is installed with grails-melody plugin, you will be able to monitor the application at http://localhost:8080/<YourContext>/monitoring.

The goal of JavaMelody is to monitor Java or Java EE applications servers in QA and production environments. It is not a tool to simulate requests from users, it is a tool to measure and calculate statistics on real operation of an application depending on the usage of the application by users.

To install the plugin, click the download button at the top, then "grails install-plugin <zip file>".

A few things you might want to know:

  • grails-melody plugin overwrites original grails 'dataSource' bean in spring context with a JavaMelody datasource proxy.
  • grails-melody plugin uses groovy meta programming to intercept grails services method calls.
The plugin copies a GrailsMelodyConfig.groovy file into your project's grails-app/conf directory. All JavaMelody parameters described at http://code.google.com/p/javamelody/wiki/UserGuide#6._Optional_parameters can be configured in this file with 'javamelody.' prefix. For example, use 
javamelody.disabled = true
to disable the JavaMelody monitoring.

JavaMelody uses URIs to resolve HTTP requests. This means that 

/book/show/1 and 
/book/show/23

will resolve as different requests. While that's desirable in some cases, often you want the statistics to be gathered for the show action, irrespective of parameters. In that case, add the following configuration to GrailsMelodyConfig.groovy and the above URIs will show up as /book/show/$. 

javamelody.'http-transform-pattern' = '\\d+'  //filter out numbers from URI

Similar issue comes up for SQL monitoring - use a similar Regex to filter it. 

javamelody.'sql-transform-pattern' = '\\d+'