View Javadoc
1   /**
2    * This file Copyright (c) 2013-2018 Magnolia International
3    * Ltd.  (http://www.magnolia-cms.com). All rights reserved.
4    *
5    *
6    * This file is dual-licensed under both the Magnolia
7    * Network Agreement and the GNU General Public License.
8    * You may elect to use one or the other of these licenses.
9    *
10   * This file is distributed in the hope that it will be
11   * useful, but AS-IS and WITHOUT ANY WARRANTY; without even the
12   * implied warranty of MERCHANTABILITY or FITNESS FOR A
13   * PARTICULAR PURPOSE, TITLE, or NONINFRINGEMENT.
14   * Redistribution, except as permitted by whichever of the GPL
15   * or MNA you select, is prohibited.
16   *
17   * 1. For the GPL license (GPL), you can redistribute and/or
18   * modify this file under the terms of the GNU General
19   * Public License, Version 3, as published by the Free Software
20   * Foundation.  You should have received a copy of the GNU
21   * General Public License, Version 3 along with this program;
22   * if not, write to the Free Software Foundation, Inc., 51
23   * Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
24   *
25   * 2. For the Magnolia Network Agreement (MNA), this file
26   * and the accompanying materials are made available under the
27   * terms of the MNA which accompanies this distribution, and
28   * is available at http://www.magnolia-cms.com/mna.html
29   *
30   * Any modifications to this file must keep this entire header
31   * intact.
32   *
33   */
34  package info.magnolia.monitoring;
35  
36  import org.slf4j.Logger;
37  import org.slf4j.LoggerFactory;
38  
39  import com.google.inject.Singleton;
40  
41  /**
42   * Allows to monitor the system.
43   */
44  @Singleton
45  public class SystemMonitor {
46  
47      public static final String MEMORY_LIMIT_IS_REACHED_STRING_FORMAT = "Your server is currently low on memory. %s. Please try again later or contact your administrator if this happens frequently.";
48  
49      public static final String MEMORY_VALUES_STRING_FORMAT = "Memory values: max = {}mb, total = {}mb, free = {}mb -> remaining = {}mb / thresholds = {}mb or {}%";
50  
51      public static final long BYTE_TO_MEGABYTE_FACTOR = 1024 * 1024;
52  
53      public static final int MEMORY_THRESHOLD_PERCENTAGE = 10;
54  
55      public static final int MEMORY_THRESHOLD_IN_MB = 50;
56  
57      private final static Logger log = LoggerFactory.getLogger(SystemMonitor.class);
58  
59      /**
60       * Evaluates whether the memory limit is reached. This is the case when system memory is absolutely below {@link #MEMORY_THRESHOLD_IN_MB} and relatively below {@link #MEMORY_THRESHOLD_PERCENTAGE}.
61       *
62       * @return whether the memory limit is reached or not.
63       */
64      public boolean isMemoryLimitReached() {
65          Runtime runtime = Runtime.getRuntime();
66          return isBelowAllThresholds(runtime.maxMemory() / BYTE_TO_MEGABYTE_FACTOR, runtime.totalMemory() / BYTE_TO_MEGABYTE_FACTOR, runtime.freeMemory() / BYTE_TO_MEGABYTE_FACTOR);
67      }
68  
69      /**
70       * @param maxMemoryInMb maximum amount the JVM can grow to
71       * @param totalMemoryInMb current size of the JVM
72       * @param freeMemoryInMb amount left of the current size
73       */
74      protected boolean isBelowAllThresholds(final long maxMemoryInMb, final long totalMemoryInMb, final long freeMemoryInMb) {
75  
76          final long remainingInMB = freeMemoryInMb + (maxMemoryInMb - totalMemoryInMb);
77          final boolean isLowerThanThresholdInMB = remainingInMB < MEMORY_THRESHOLD_IN_MB;
78          final boolean isLowerThanThresholdPercentage = (100 * remainingInMB / maxMemoryInMb) < MEMORY_THRESHOLD_PERCENTAGE;
79          final boolean isMemoryLimitReached = isLowerThanThresholdInMB && isLowerThanThresholdPercentage;
80  
81          log.debug(MEMORY_VALUES_STRING_FORMAT, maxMemoryInMb, totalMemoryInMb, freeMemoryInMb, remainingInMB, MEMORY_THRESHOLD_IN_MB, MEMORY_THRESHOLD_PERCENTAGE);
82  
83          if (isMemoryLimitReached) {
84              log.warn(MEMORY_VALUES_STRING_FORMAT, maxMemoryInMb, totalMemoryInMb, freeMemoryInMb, remainingInMB, MEMORY_THRESHOLD_IN_MB, MEMORY_THRESHOLD_PERCENTAGE);
85          }
86  
87          return isMemoryLimitReached;
88      }
89  }