View Javadoc

1   /**
2    * Licensed to the Apache Software Foundation (ASF) under one
3    * or more contributor license agreements.  See the NOTICE file
4    * distributed with this work for additional information
5    * regarding copyright ownership.  The ASF licenses this file
6    * to you under the Apache License, Version 2.0 (the
7    * "License"); you may not use this file except in compliance
8    * with the License.  You may obtain a copy of the License at
9    *
10   *     http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing, software
13   * distributed under the License is distributed on an "AS IS" BASIS,
14   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15   * See the License for the specific language governing permissions and
16   * limitations under the License.
17   */
18  
19  package org.apache.hadoop.metrics2.impl;
20  
21  import org.apache.commons.logging.Log;
22  import org.apache.commons.logging.LogFactory;
23  import org.apache.hadoop.metrics2.MetricsExecutor;
24  import org.apache.hadoop.metrics2.lib.DefaultMetricsSystem;
25  import org.apache.hadoop.metrics2.lib.MetricsExecutorImpl;
26  
27  import java.util.concurrent.ScheduledFuture;
28  import java.util.concurrent.TimeUnit;
29  
30  /**
31   * JMX caches the beans that have been exported; even after the values are removed from hadoop's
32   * metrics system the keys and old values will still remain.  This class stops and restarts the
33   * Hadoop metrics system, forcing JMX to clear the cache of exported metrics.
34   *
35   * This class need to be in the o.a.h.metrics2.impl namespace as many of the variables/calls used
36   * are package private.
37   */
38  @edu.umd.cs.findbugs.annotations.SuppressWarnings(
39      value="LI_LAZY_INIT_STATIC",
40      justification="Yeah, its weird but its what we want")
41  public class JmxCacheBuster {
42    private static final Log LOG = LogFactory.getLog(JmxCacheBuster.class);
43    private static Object lock = new Object();
44    private static ScheduledFuture fut = null;
45    private static MetricsExecutor executor = new MetricsExecutorImpl();
46  
47    /**
48     * For JMX to forget about all previously exported metrics.
49     */
50    public static void clearJmxCache() {
51  
52      //If there are more then 100 ms before the executor will run then everything should be merged.
53      if (fut == null || (!fut.isDone()  && fut.getDelay(TimeUnit.MILLISECONDS) > 100)) return;
54  
55      synchronized (lock) {
56        fut = executor.getExecutor().schedule(new JmxCacheBusterRunnable(), 5, TimeUnit.SECONDS);
57      }
58    }
59  
60    static class JmxCacheBusterRunnable implements Runnable {
61  
62      @Override
63      public void run() {
64        LOG.trace("Clearing JMX mbean cache.");
65  
66        // This is pretty extreme but it's the best way that
67        // I could find to get metrics to be removed.
68        try {
69          if (DefaultMetricsSystem.instance() != null ) {
70            DefaultMetricsSystem.instance().stop();
71            DefaultMetricsSystem.instance().start();
72          }
73  
74        }  catch (Exception exception )  {
75          LOG.debug("error clearing the jmx it appears the metrics system hasn't been started", exception);
76        }
77      }
78    }
79  }