Back to index...

	/*
	* Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
	*
	* This code is free software; you can redistribute it and/or modify it
	* under the terms of the GNU General Public License version 2 only, as
	* published by the Free Software Foundation. Oracle designates this
	* particular file as subject to the "Classpath" exception as provided
	* by Oracle in the LICENSE file that accompanied this code.
	*
	* This code is distributed in the hope that it will be useful, but WITHOUT
	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
	* version 2 for more details (a copy is included in the LICENSE file that
	* accompanied this code).
	*
	* You should have received a copy of the GNU General Public License version
	* 2 along with this work; if not, write to the Free Software Foundation,
	* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
	*
	* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
	* or visit www.oracle.com if you need additional information or have any
	* questions.
	*/

	package sun.tools.jstat;

	import java.util.*;
	import sun.jvmstat.monitor.*;
	import sun.jvmstat.monitor.event.*;

	/**
	* Application to output jvmstat statistics exported by a target Java
	* Virtual Machine. The jstat tool gets its inspiration from the suite
	* of 'stat' tools, such as vmstat, iostat, mpstat, etc., available in
	* various UNIX platforms.
	*
	* @author Brian Doherty
	* @since 1.5
	*/
	public class Jstat {
	private static Arguments arguments;

	public static void main(String[] args) {
	try {
	arguments = new Arguments(args);
	} catch (IllegalArgumentException e) {
	System.err.println(e.getMessage());
	Arguments.printUsage(System.err);
	System.exit(1);
	}

	if (arguments.isHelp()) {
	Arguments.printUsage(System.out);
	System.exit(0);
	}

	if (arguments.isOptions()) {
	OptionLister ol = new OptionLister(arguments.optionsSources());
	ol.print(System.out);
	System.exit(0);
	}

	try {
	if (arguments.isList()) {
	logNames();
	} else if (arguments.isSnap()) {
	logSnapShot();
	} else {
	logSamples();
	}
	} catch (MonitorException e) {
	if (e.getMessage() != null) {
	System.err.println(e.getMessage());
	} else {
	Throwable cause = e.getCause();
	if ((cause != null) && (cause.getMessage() != null)) {
	System.err.println(cause.getMessage());
	} else {
	e.printStackTrace();
	}
	}
	System.exit(1);
	}
	System.exit(0);
	}

	static void logNames() throws MonitorException {
	VmIdentifier vmId = arguments.vmId();
	int interval = arguments.sampleInterval();
	MonitoredHost monitoredHost = MonitoredHost.getMonitoredHost(vmId);
	MonitoredVm monitoredVm = monitoredHost.getMonitoredVm(vmId, interval);
	JStatLogger logger = new JStatLogger(monitoredVm);
	logger.printNames(arguments.counterNames(), arguments.comparator(),
	arguments.showUnsupported(), System.out);
	monitoredHost.detach(monitoredVm);
	}

	static void logSnapShot() throws MonitorException {
	VmIdentifier vmId = arguments.vmId();
	int interval = arguments.sampleInterval();
	MonitoredHost monitoredHost = MonitoredHost.getMonitoredHost(vmId);
	MonitoredVm monitoredVm = monitoredHost.getMonitoredVm(vmId, interval);
	JStatLogger logger = new JStatLogger(monitoredVm);
	logger.printSnapShot(arguments.counterNames(), arguments.comparator(),
	arguments.isVerbose(), arguments.showUnsupported(),
	System.out);
	monitoredHost.detach(monitoredVm);
	}

	static void logSamples() throws MonitorException {
	final VmIdentifier vmId = arguments.vmId();
	int interval = arguments.sampleInterval();
	final MonitoredHost monitoredHost =
	MonitoredHost.getMonitoredHost(vmId);
	MonitoredVm monitoredVm = monitoredHost.getMonitoredVm(vmId, interval);
	final JStatLogger logger = new JStatLogger(monitoredVm);
	OutputFormatter formatter = null;

	if (arguments.isSpecialOption()) {
	OptionFormat format = arguments.optionFormat();
	formatter = new OptionOutputFormatter(monitoredVm, format);
	} else {
	List<Monitor> logged = monitoredVm.findByPattern(arguments.counterNames());
	Collections.sort(logged, arguments.comparator());
	List<Monitor> constants = new ArrayList<Monitor>();

	for (Iterator i = logged.iterator(); i.hasNext(); /* empty */) {
	Monitor m = (Monitor)i.next();
	if (!(m.isSupported() \|\| arguments.showUnsupported())) {
	i.remove();
	continue;
	}
	if (m.getVariability() == Variability.CONSTANT) {
	i.remove();
	if (arguments.printConstants()) constants.add(m);
	} else if ((m.getUnits() == Units.STRING)
	&& !arguments.printStrings()) {
	i.remove();
	}
	}

	if (!constants.isEmpty()) {
	logger.printList(constants, arguments.isVerbose(),
	arguments.showUnsupported(), System.out);
	if (!logged.isEmpty()) {
	System.out.println();
	}
	}

	if (logged.isEmpty()) {
	monitoredHost.detach(monitoredVm);
	return;
	}

	formatter = new RawOutputFormatter(logged,
	arguments.printStrings());
	}

	// handle user termination requests by stopping sampling loops
	Runtime.getRuntime().addShutdownHook(new Thread() {
	public void run() {
	logger.stopLogging();
	}
	});

	// handle target termination events for targets other than ourself
	HostListener terminator = new HostListener() {
	public void vmStatusChanged(VmStatusChangeEvent ev) {
	Integer lvmid = new Integer(vmId.getLocalVmId());
	if (ev.getTerminated().contains(lvmid)) {
	logger.stopLogging();
	} else if (!ev.getActive().contains(lvmid)) {
	logger.stopLogging();
	}
	}

	public void disconnected(HostEvent ev) {
	if (monitoredHost == ev.getMonitoredHost()) {
	logger.stopLogging();
	}
	}
	};

	if (vmId.getLocalVmId() != 0) {
	monitoredHost.addHostListener(terminator);
	}

	logger.logSamples(formatter, arguments.headerRate(),
	arguments.sampleInterval(), arguments.sampleCount(),
	System.out);

	// detach from host events and from the monitored target jvm
	if (terminator != null) {
	monitoredHost.removeHostListener(terminator);
	}
	monitoredHost.detach(monitoredVm);
	}
	}

Back to index...