1 /*
2 * Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 */
23
24 /*
25 * Results of running the JstatGcTool ("jstat -gc <pid>")
26 *
27 * Output example:
28 * (S0C S1C S0U S1U EC EU OC OU MC MU CCSC CCSU YGC YGCT FGC FGCT GCT
29 * 512.0 512.0 32.0 0.0 288768.0 168160.6 83968.0 288.1 4864.0 2820.3 512.0 279.7 18510 1559.208 0 0.000 1559.208
30 *
31 * Output description:
32 * S0C Current survivor space 0 capacity (KB).
33 * S1C Current survivor space 1 capacity (KB).
34 * S0U Survivor space 0 utilization (KB).
35 * S1U Survivor space 1 utilization (KB).
36 * EC Current eden space capacity (KB).
37 * EU Eden space utilization (KB).
38 * OC Current old space capacity (KB).
39 * OU Old space utilization (KB).
40 * MC Current metaspace capacity (KB).
41 * MU Metaspace utilization (KB).
42 * CCSC Compressed Class Space capacity
43 * CCSU Compressed Class Space utilization
44 * YGC Number of young generation GC Events.
45 * YGCT Young generation garbage collection time.
46 * FGC Number of full GC events.
47 * FGCT Full garbage collection time.
48 * GCT Total garbage collection time.
49 *
50 */
51 package utils;
52
53 import common.ToolResults;
54
55 public class JstatGcResults extends JstatResults {
56
57 public JstatGcResults(ToolResults rawResults) {
58 super(rawResults);
59 }
60
61 /**
62 * Checks the overall consistency of the results reported by the tool
63 */
64 public void assertConsistency() {
65
66 assertThat(getExitCode() == 0, "Unexpected exit code: " + getExitCode());
67
68 float OC = getFloatValue("OC");
69 float OU = getFloatValue("OU");
70 assertThat(OU <= OC, "OU > OC (utilization > capacity)");
71
72 float MC = getFloatValue("MC");
73 float MU = getFloatValue("MU");
74 assertThat(MU <= MC, "MU > MC (utilization > capacity)");
75
76 float CCSC = getFloatValue("CCSC");
77 float CCSU = getFloatValue("CCSU");
78 assertThat(CCSU <= CCSC, "CCSU > CCSC (utilization > capacity)");
79
80 float S0C = getFloatValue("S0C");
81 float S0U = getFloatValue("S0U");
82 assertThat(S0U <= S0C, "S0U > S0C (utilization > capacity)");
83
84 float S1C = getFloatValue("S1C");
85 float S1U = getFloatValue("S1U");
86 assertThat(S1U <= S1C, "S1U > S1C (utilization > capacity)");
87
88 float EC = getFloatValue("EC");
89 float EU = getFloatValue("EU");
90 assertThat(EU <= EC, "EU > EC (utilization > capacity)");
91
92 int YGC = getIntValue("YGC");
93 float YGCT = getFloatValue("YGCT");
94 assertThat(YGCT >= 0, "Incorrect time value for YGCT");
95 if (YGC > 0) {
96 assertThat(YGCT > 0, "Number of young generation GC Events is " + YGC + ", but YGCT is 0");
97 }
98
99 float GCT = getFloatValue("GCT");
100 assertThat(GCT >= 0, "Incorrect time value for GCT");
101 assertThat(GCT >= YGCT, "GCT < YGCT (total garbage collection time < young generation garbage collection time)");
102
103 int FGC = getIntValue("FGC");
104 float FGCT = getFloatValue("FGCT");
105 assertThat(FGCT >= 0, "Incorrect time value for FGCT");
106 if (FGC > 0) {
107 assertThat(FGCT > 0, "Number of full GC events is " + FGC + ", but FGCT is 0");
108 }
109
110 assertThat(GCT >= FGCT, "GCT < YGCT (total garbage collection time < full generation garbage collection time)");
111
112 assertThat(checkFloatIsSum(GCT, YGCT, FGCT), "GCT != (YGCT + FGCT) " + "(GCT = " + GCT + ", YGCT = " + YGCT
113 + ", FGCT = " + FGCT + ", (YCGT + FGCT) = " + (YGCT + FGCT) + ")");
114 }
115
116 private static final float FLOAT_COMPARISON_TOLERANCE = 0.0011f;
117
118 private static boolean checkFloatIsSum(float sum, float... floats) {
119 for (float f : floats) {
120 sum -= f;
121 }
122
123 return Math.abs(sum) <= FLOAT_COMPARISON_TOLERANCE;
124 }
125
126 private void assertThat(boolean b, String message) {
127 if (!b) {
128 throw new RuntimeException(message);
129 }
130 }
131
132 }