db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync/*
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync * Sample of performance API usage, written in Java.
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync *
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * Don't forget to run VBOX webserver
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * with 'vboxwebsrv -t 1000' command, to calm down watchdog thread.
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync *
5c65eaa08f2ec993a19c9bef6e5463918e40e0ebvboxsync * Copyright (C) 2008-2010 Oracle Corporation
d49b73f15b22afbcca4b0335bd8d0aef2c891a78vboxsync *
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * The following license applies to this file only:
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync *
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * Permission is hereby granted, free of charge, to any person
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * obtaining a copy of this software and associated documentation
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * files (the "Software"), to deal in the Software without
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * restriction, including without limitation the rights to use,
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * copy, modify, merge, publish, distribute, sublicense, and/or
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * sell copies of the Software, and to permit persons to whom the
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * Software is furnished to do so, subject to the following conditions:
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync *
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * The above copyright notice and this permission notice shall be
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * included in all copies or substantial portions of the Software.
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync *
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync * OTHER DEALINGS IN THE SOFTWARE.
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync */
98bfcb808aa93fe8b532eb38da1f15a795a85f6dvboxsyncimport com.sun.xml.ws.commons.virtualbox{VBOX_API_SUFFIX}.*;
98bfcb808aa93fe8b532eb38da1f15a795a85f6dvboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsyncimport java.util.*;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsyncimport javax.xml.ws.Holder;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsyncclass PerformanceData
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync{
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public String name;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public IUnknown object;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public String unit;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public Long scale;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public Long sequenceNumber;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public List<Long> samples;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public String getFormattedSamples()
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync String out = "[";
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync String separator = "";
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync if (scale != 1)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync for (Long sample : samples)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync out += separator + (sample.doubleValue() / scale) + " " + unit;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync separator = ", ";
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync else
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync for (Long sample : samples)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync out += separator + sample.toString() + " " + unit;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync separator = ", ";
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync out += "]";
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync return out;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync}
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsyncclass PerformanceCollector
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync{
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync private IVirtualBox _vbox;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync private IPerformanceCollector _collector;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public PerformanceCollector(IVirtualBox vbox)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync _vbox = vbox;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync _collector = vbox.getPerformanceCollector();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public void cleanup()
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync _collector.releaseRemote();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public List<IPerformanceMetric> setup(List<String> metricNames, List<IUnknown> objects, Long period, Long samples)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync return _collector.setupMetrics(metricNames, objects, period, samples);
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public List<IPerformanceMetric> enable(List<String> metricNames, List<IUnknown> objects)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync return _collector.enableMetrics(metricNames, objects);
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public List<IPerformanceMetric> disable(List<String> metricNames, List<IUnknown> objects)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync return _collector.disableMetrics(metricNames, objects);
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public List<PerformanceData> query(List<String> filterMetrics, List<IUnknown> filterObjects)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync Holder<List<String>> names = new Holder<List<String>>();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync Holder<List<IUnknown>> objects = new Holder<List<IUnknown>>();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync Holder<List<String>> units = new Holder<List<String>>();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync Holder<List<Long>> scales = new Holder<List<Long>>();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync Holder<List<Long>> sequenceNumbers = new Holder<List<Long>>();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync Holder<List<Long>> indices = new Holder<List<Long>>();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync Holder<List<Long>> lengths = new Holder<List<Long>>();
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync List<Integer> values =
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync _collector.queryMetricsData(filterMetrics, filterObjects,
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync names, objects, units, scales, sequenceNumbers, indices, lengths);
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync List<PerformanceData> data = new ArrayList<PerformanceData>(names.value.size());
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync for (int i = 0; i < names.value.size(); i++)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync PerformanceData singleMetricData = new PerformanceData();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync singleMetricData.name = names.value.get(i);
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync singleMetricData.object = objects.value.get(i);
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync singleMetricData.unit = units.value.get(i);
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync singleMetricData.scale = scales.value.get(i);
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync singleMetricData.sequenceNumber = sequenceNumbers.value.get(i);
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync List<Long> samples = new ArrayList<Long>(lengths.value.get(i).intValue());
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync for (int j = 0; j < lengths.value.get(i); j++)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync samples.add(values.get(indices.value.get(i).intValue() + j).longValue());
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync singleMetricData.samples = samples;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync data.add(singleMetricData);
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync return data;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync}
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsyncpublic class metrictest implements Runnable
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync{
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync IVirtualBox vbox;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync IWebsessionManager mgr;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync PerformanceCollector perf;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public metrictest()
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
06bff36cb61120e53cf4de70b75f3417697f0151vboxsync mgr = new IWebsessionManager("http://localhost:18083/");
06bff36cb61120e53cf4de70b75f3417697f0151vboxsync vbox = mgr.logon("test", "test");
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync System.out.println("Initialized connection to VirtualBox version " + vbox.getVersion());
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync perf = new PerformanceCollector(vbox);
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync private String getObjectName(IUnknown object)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync try
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync String machineName = object.getRemoteWSPort().iMachineGetName(object.getRef());
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync return machineName;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync } catch (Exception e)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync return new String("host");
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public void setup()
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync perf.setup(Arrays.asList(new String[]{"*"}),
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync new ArrayList<IUnknown>(),
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync new Long(1), new Long(5));
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public void collect()
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync try
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync List<IUnknown> allObjects = new ArrayList<IUnknown>();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync List<PerformanceData> metricData = perf.query(Arrays.asList(new String[]{"*"}),
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync allObjects);
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync for (PerformanceData md : metricData)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync System.out.println("(" + getObjectName(md.object) + ") " +
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync md.name + " " + md.getFormattedSamples());
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync catch (Exception e)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync e.printStackTrace();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public void run()
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync // Clean up
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync try
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync if (perf != null)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync perf.cleanup();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync perf = null;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync if (vbox != null)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync mgr.logoff(vbox);
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync vbox = null;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync mgr = null;
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync System.out.println("Logged off.");
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync catch (Exception e)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync e.printStackTrace();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
c1ca21ba335f4d6a24c34cb6fa07fa8e5ac55cc7vboxsync
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync public static void main(String[] args) throws InterruptedException
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync metrictest c = new metrictest();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync // Add a shutdown handle to clean up
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync Runtime.getRuntime().addShutdownHook(new Thread(c));
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync // Start metric collection
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync c.setup();
ad27e1d5e48ca41245120c331cc88b50464813cevboxsync // Obtain and print out stats continuously until ctrl-C is pressed
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync while (true)
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync {
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync Thread.sleep(1000); // Sleep for a second
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync c.collect();
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync }
db3dbd0ed7eb69f804a8921fa23a1267ea01f46evboxsync}