{"id":21317,"date":"2015-07-01T16:05:41","date_gmt":"2015-07-01T10:35:41","guid":{"rendered":"http:\/\/www.tothenew.com\/blog\/?p=21317"},"modified":"2015-07-24T17:01:41","modified_gmt":"2015-07-24T11:31:41","slug":"externalize-and-reload-grails-log4j-configuration","status":"publish","type":"post","link":"https:\/\/www.tothenew.com\/blog\/externalize-and-reload-grails-log4j-configuration\/","title":{"rendered":"Externalize and reload grails Log4j configuration"},"content":{"rendered":"

In Grails 2.x and in some earlier versions<\/a>, the log4j configuration resides in grails-app\/conf\/Config.groovy<\/code>. We can modify log4j closure here to add new categories and tweak the log levels.<\/p>\n

In development environemnt any changes to log4j closure are loaded automatically without bouncing the application, but not when the application is running from a war.<\/p>\n

Our requirement is to have the ability to change log levels and add new categories at runtime.<\/p>\n

Depending upon whether we want to use closure based or xml based log4j configuration, we can choose any of the below approaches.<\/p>\n

1. Modify web.xml<\/span><\/h3>\n

While creating a war, grails generates web.xml for your application using template. To override the default web.xml, we need to override the template. Run grails install-templates<\/code> in order to do that. Add two new context-param in src\/templates\/war\/web.xml<\/code>.<\/p>\n

    \n
  1. log4jConfigLocation – holds the location of the log4 configuration file<\/li>\n
  2. log4jRefreshInterval – defines the refresh interval after which the log4j configuration should be updated<\/li>\n<\/ol>\n

    We are going to use the Log4jConfigListener<\/code> class of spring library instead of Grails log4jConfigListener as Grail\u2019s Log4jConfigListener expects the configuration inside the config.groovy file. Spring\u2019s Log4jConfigListener supports location and interval.<\/p>\n

    [code lang=”xml”]
    \n\t<!– log4j parameters –>
    \n <context-param>
    \n <param-name>log4jConfigLocation<\/param-name>
    \n <param-value>classpath:log4j.xml<\/param-value>
    \n <\/context-param><\/p>\n

    <context-param>
    \n <param-name>log4jRefreshInterval<\/param-name>
    \n <param-value>10000<\/param-value>
    \n <\/context-param><\/p>\n

    <!– Register Spring’s Log4jConfigListener–>
    \n <listener>
    \n <listener-class>org.springframework.web.util.Log4jConfigListener<\/listener-class>
    \n <\/listener>
    \n[\/code]<\/p>\n

    2. Using Bean Injection<\/span><\/h3>\n

    [code lang=”groovy”]
    \nimport org.springframework.beans.factory.config.MethodInvokingFactoryBean<\/p>\n

    beans = {
    \n\tlog4jConfigurer(MethodInvokingFactoryBean) {
    \n\t\ttargetClass = "org.springframework.util.Log4jConfigurer"
    \n\t\ttargetMethod = "initLogging"
    \n\t\targuments = ["classpath:log4j.xml", 10000]\/\/specify config location and refresh interval
    \n\t}
    \n}
    \n[\/code]<\/p>\n

    3. Custom approach<\/span><\/h3>\n

    In approach 1 & 2, we can use .xml or .properties file. But if you are a grails lover and would like to use the same closure based syntax to define loggers then we can do this. Benefit of this approach is that it can load configuration from multiple files.<\/p>\n

    Specify external configuration files in grails.config.locations<\/code> closure.<\/p>\n

    [code lang=”groovy”]
    \ngrails.config.locations = [
    \n\t\tDataSourceConfig,
    \n\t\tCommonConfig,
    \n\t\tRabbitMQConfig,
    \n\t\t"classpath:CommonLoggerConfig.groovy"
    \n\t\t"file:${userHome}\/.grailsConfigurations\/${appName}\/LoggerConfig.groovy"
    \n]
    \n[\/code]<\/p>\n

    Now we can write a job that will periodically check for the changes in config files and will reload log4j configuration, if there are any. It will first update the configuration object and then will re-configure the log4j.<\/p>\n

    Here we are using the quartz<\/code> api to do that. Create a new job ConfigurationReloaderJob.<\/p>\n

    [code lang=”groovy”]
    \nimport grails.util.Environment
    \nimport grails.util.Holders
    \nimport org.codehaus.groovy.grails.plugins.log4j.Log4jConfig<\/p>\n

    class ConfigurationReloaderJob {
    \n\tstatic triggers = {
    \n\t\t\/\/Start the job 5 minutes after the application starts up and execute after every 1 minute
    \n\t\tsimple name: "ConfigurationReloaderJob", startDelay: 5 * 60 * 1000l, repeatInterval: 1 * 60 * 1000l
    \n\t}<\/p>\n

    \t\/\/to store the hash of external config files
    \n\tprivate static Map<String, Integer> fileHashMap = [:]<\/p>\n

    \tdef execute() {
    \n\t\tConfigObject config = Holders.config
    \n\t\tList locations = config.grails.config.locations<\/p>\n

    \t\tint hashCode
    \n\t\tString text<\/p>\n

    \t\tlocations.findAll {
    \n\t\t\t\/\/find all the external file locations(contains classpath: or file: in their name)
    \n\t\t\treturn (it instanceof String || it instanceof GString) && (it.toString().contains("classpath:") || it.toString().contains("file:"))
    \n\t\t}.each {
    \n\t\t\tString filePath ->
    \n\t\t\t\ttry {
    \n\t\t\t\t\t\/\/read contents of file
    \n\t\t\t\t\ttext = Holders.applicationContext.getResource(filePath)?.file?.text
    \n\t\t\t\t} catch (FileNotFoundException ex) {
    \n\t\t\t\t\t\/\/ignore the exception if file not found on specified path
    \n\t\t\t\t\tlog.error("File not found: ${ex.message}")
    \n\t\t\t\t}<\/p>\n

    \t\t\t\t\/\/if file have data
    \n\t\t\t\tif (text) {
    \n\t\t\t\t\t\/\/calculate hashCode of text
    \n\t\t\t\t\thashCode = text.hashCode()
    \n\t\t\t\t\tif (!fileHashMap.containsKey(filePath) || fileHashMap.get(filePath) != hashCode) {
    \n\t\t\t\t\t\t\/\/Merger existing config with the text of file
    \n\t\t\t\t\t\tconfig = config.merge(new ConfigSlurper(Environment.current.name).parse(text))<\/p>\n

    \t\t\t\t\t\t\/\/reconfigure log4j
    \n\t\t\t\t\t\tLog4jConfig.initialize(config)<\/p>\n

    \t\t\t\t\t\tfileHashMap.put(filePath, hashCode)
    \n\t\t\t\t\t\tlog.debug("Log configuration updated successfully.")
    \n\t\t\t\t\t}
    \n\t\t\t\t}
    \n\t\t}
    \n\t}
    \n}
    \n[\/code]<\/p>\n

    Hooking into Grails Events<\/h4>\n

    As we are specifying that the configurations will be loaded from the classpath or system path, we will be hooking into the Grails events to make sure that the file is in the classpath. Create a file under scripts\/_Events.groovy and paste the code given below.<\/p>\n

    [code lang=”groovy”]
    \n\/\/Hook into war creation event
    \neventCreateWarStart = { warName, stagingDir ->
    \n ant.copy(todir: "${stagingDir}\/WEB-INF\/classes") {
    \n fileset(file: "${basedir}\/log4j.properties")
    \n }
    \n}<\/p>\n

    \/\/Hook into run-app event
    \neventRunAppStart = {
    \n ant.copy(todir:"${basedir}\/target\/classes") {
    \n fileset(file: "${basedir}\/log4j.properties")
    \n }
    \n}
    \n[\/code]<\/p>\n

    You can modify the above code to work with multiple files or to copy files at file system path as specified in grails.config.locations<\/code>.<\/p>\n

    Changes to config.groovy<\/h4>\n

    In grails-app\/conf\/config.groovy<\/code>, remove the log4j closure at the end of the file.<\/p>\n","protected":false},"excerpt":{"rendered":"

    In Grails 2.x and in some earlier versions, the log4j configuration resides in grails-app\/conf\/Config.groovy. We can modify log4j closure here to add new categories and tweak the log levels. In development environemnt any changes to log4j closure are loaded automatically without bouncing the application, but not when the application is running from a war. Our […]<\/p>\n","protected":false},"author":182,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"iawp_total_views":30},"categories":[7,1],"tags":[1886,207,4840,471,1889],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/21317"}],"collection":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/users\/182"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/comments?post=21317"}],"version-history":[{"count":0,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/21317\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/media?parent=21317"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/categories?post=21317"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/tags?post=21317"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}