1 /*******************************************************************************
2 * Copyright (c) 2009 Ericsson
4 * All rights reserved. This program and the accompanying materials are
5 * made available under the terms of the Eclipse Public License v1.0 which
6 * accompanies this distribution, and is available at
7 * http://www.eclipse.org/legal/epl-v10.html
10 * Yann N. Dauphin (dhaemon@gmail.com) - Implementation
11 * Francois Chouinard (fchouinard@gmail.com) - Initial API
12 *******************************************************************************/
14 package org
.eclipse
.linuxtools
.lttng
.ui
.views
.statistics
;
16 import java
.text
.DecimalFormat
;
17 import java
.util
.Arrays
;
18 import java
.util
.HashSet
;
21 import org
.eclipse
.jface
.viewers
.ColumnLabelProvider
;
22 import org
.eclipse
.jface
.viewers
.ITreeContentProvider
;
23 import org
.eclipse
.jface
.viewers
.TreeViewer
;
24 import org
.eclipse
.jface
.viewers
.TreeViewerColumn
;
25 import org
.eclipse
.jface
.viewers
.Viewer
;
26 import org
.eclipse
.jface
.viewers
.ViewerComparator
;
27 import org
.eclipse
.linuxtools
.lttng
.control
.LttngCoreProviderFactory
;
28 import org
.eclipse
.linuxtools
.lttng
.request
.ILttngSyntEventRequest
;
29 import org
.eclipse
.linuxtools
.lttng
.state
.evProcessor
.AbsEventToHandlerResolver
;
30 import org
.eclipse
.linuxtools
.lttng
.ui
.TraceDebug
;
31 import org
.eclipse
.linuxtools
.lttng
.ui
.model
.trange
.ItemContainer
;
32 import org
.eclipse
.linuxtools
.lttng
.ui
.views
.common
.AbsTimeUpdateView
;
33 import org
.eclipse
.linuxtools
.lttng
.ui
.views
.common
.ParamsUpdater
;
34 import org
.eclipse
.linuxtools
.lttng
.ui
.views
.statistics
.evProcessor
.StatsTimeCountHandlerFactory
;
35 import org
.eclipse
.linuxtools
.lttng
.ui
.views
.statistics
.model
.StatisticsTreeNode
;
36 import org
.eclipse
.linuxtools
.lttng
.ui
.views
.statistics
.model
.StatisticsTreeRootFactory
;
37 import org
.eclipse
.linuxtools
.tmf
.event
.TmfEvent
;
38 import org
.eclipse
.linuxtools
.tmf
.event
.TmfTimeRange
;
39 import org
.eclipse
.linuxtools
.tmf
.experiment
.TmfExperiment
;
40 import org
.eclipse
.linuxtools
.tmf
.request
.ITmfDataRequest
.ExecutionType
;
41 import org
.eclipse
.linuxtools
.tmf
.signal
.TmfExperimentSelectedSignal
;
42 import org
.eclipse
.linuxtools
.tmf
.signal
.TmfSignalHandler
;
43 import org
.eclipse
.linuxtools
.tmf
.trace
.ITmfTrace
;
44 import org
.eclipse
.linuxtools
.tmf
.ui
.viewers
.timeAnalysis
.model
.ITmfTimeAnalysisEntry
;
45 import org
.eclipse
.swt
.SWT
;
46 import org
.eclipse
.swt
.events
.SelectionAdapter
;
47 import org
.eclipse
.swt
.events
.SelectionEvent
;
48 import org
.eclipse
.swt
.graphics
.Color
;
49 import org
.eclipse
.swt
.graphics
.Cursor
;
50 import org
.eclipse
.swt
.graphics
.Image
;
51 import org
.eclipse
.swt
.layout
.FillLayout
;
52 import org
.eclipse
.swt
.widgets
.Composite
;
53 import org
.eclipse
.swt
.widgets
.Display
;
54 import org
.eclipse
.swt
.widgets
.Event
;
55 import org
.eclipse
.swt
.widgets
.Listener
;
56 import org
.eclipse
.ui
.ISharedImages
;
57 import org
.eclipse
.ui
.PlatformUI
;
60 * <b><u>StatisticsView</u></b>
62 * The Statistics View displays statistics for traces.
64 * It is implemented according to the MVC pattern. - The model is a
65 * StatisticsTreeNode built by the State Manager. - The view is built with a
66 * TreeViewer. - The controller that keeps model and view synchronised is an
67 * observer of the model.
69 public class StatisticsView
extends AbsTimeUpdateView
{
70 public static final String ID
= "org.eclipse.linuxtools.lttng.ui.views.statistics"; //$NON-NLS-1$
71 private TreeViewer treeViewer
;
74 private final String LEVEL_COLUMN
= "Level";
75 private final String EVENTS_COUNT_COLUMN
= "Number of Events";
76 private final String CPU_TIME_COLUMN
= "CPU Time";
77 private final String CUMULATIVE_CPU_TIME_COLUMN
= "Cumulative CPU Time";
78 private final String ELAPSED_TIME_COLUMN
= "Elapsed Time";
80 // Table column tooltips
81 private final String LEVEL_COLUMN_TIP
= "Level at which statistics apply.";
82 private final String EVENTS_COUNT_COLUMN_TIP
= "Total amount of events that are tied to given resource.";
83 private final String CPU_TIME_COLUMN_TIP
= "Total amount of time the CPU was used excluding wait times(I/O, etc.) at that level.";
84 private final String CUMULATIVE_CPU_TIME_COLUMN_TIP
= "Total amount of time between the first and last event excluding wait times in a level.";
85 private final String ELAPSED_TIME_COLUMN_TIP
= "Total amount of time the CPU was used including wait times(I/O, etc.) at that level.";
87 // Level for which statistics should not be displayed.
88 private Set
<String
> folderLevels
= new HashSet
<String
>(Arrays
89 .asList(new String
[] { "Event Types", "Modes", "Submodes", "CPUs",
90 "Processes", "Functions" }));
92 // Levels for which sub-levels should not contain time-related statistics.
93 private Set
<String
> levelsWithEmptyTime
= new HashSet
<String
>(Arrays
94 .asList(new String
[] { "Event Types" }));
96 private DecimalFormat decimalFormat
= new DecimalFormat("0.#########");
97 private Cursor fwaitCursor
= null;
99 private static final Long STATS_INPUT_CHANGED_REFRESH
= 5000L;
101 // Used to draw bar charts in columns.
102 private interface ColumnPercentageProvider
{
103 public double getPercentage(StatisticsTreeNode node
);
107 * Contains all the information necessary to build a column of the table.
109 private class ColumnData
{
110 // Name of the column.
111 public final String header
;
112 // Width of the column.
113 public final int width
;
114 // Alignment of the column.
115 public final int alignment
;
116 // Tooltip of the column.
117 public final String tooltip
;
118 // Adapts a StatisticsTreeNode into the content of it's corresponding
119 // cell for that column.
120 public final ColumnLabelProvider labelProvider
;
121 // Used to sort elements of this column. Can be null.
122 public final ViewerComparator comparator
;
123 // Used to draw bar charts in this column. Can be null.
124 public final ColumnPercentageProvider percentageProvider
;
126 public ColumnData(String h
, int w
, int a
, String t
,
127 ColumnLabelProvider l
, ViewerComparator c
,
128 ColumnPercentageProvider p
) {
135 percentageProvider
= p
;
139 // List that will be used to create the table.
140 private ColumnData
[] columnDataList
= new ColumnData
[] {
141 new ColumnData(LEVEL_COLUMN
, 200, SWT
.LEFT
, LEVEL_COLUMN_TIP
,
142 new ColumnLabelProvider() {
144 public String
getText(Object element
) {
145 return ((StatisticsTreeNode
) element
).getKey();
149 public Image
getImage(Object element
) {
150 StatisticsTreeNode node
= (StatisticsTreeNode
) element
;
151 if (folderLevels
.contains(node
.getKey())) {
152 return PlatformUI
.getWorkbench()
153 .getSharedImages().getImage(
154 ISharedImages
.IMG_OBJ_FOLDER
);
156 return PlatformUI
.getWorkbench()
157 .getSharedImages().getImage(
158 ISharedImages
.IMG_OBJ_ELEMENT
);
161 }, new ViewerComparator() {
163 public int compare(Viewer viewer
, Object e1
, Object e2
) {
164 StatisticsTreeNode n1
= (StatisticsTreeNode
) e1
;
165 StatisticsTreeNode n2
= (StatisticsTreeNode
) e2
;
167 return n1
.getKey().compareTo(n2
.getKey());
170 new ColumnData(EVENTS_COUNT_COLUMN
, 125, SWT
.LEFT
,
171 EVENTS_COUNT_COLUMN_TIP
, new ColumnLabelProvider() {
173 public String
getText(Object element
) {
174 StatisticsTreeNode node
= (StatisticsTreeNode
) element
;
175 if (!folderLevels
.contains(node
.getKey())) {
176 return Long
.toString(node
.getValue().nbEvents
);
178 return ""; //$NON-NLS-1$
181 }, new ViewerComparator() {
183 public int compare(Viewer viewer
, Object e1
, Object e2
) {
184 StatisticsTreeNode n1
= (StatisticsTreeNode
) e1
;
185 StatisticsTreeNode n2
= (StatisticsTreeNode
) e2
;
187 return (int) (n1
.getValue().nbEvents
- n2
188 .getValue().nbEvents
);
190 }, new ColumnPercentageProvider() {
192 public double getPercentage(StatisticsTreeNode node
) {
193 StatisticsTreeNode parent
= node
;
195 parent
= parent
.getParent();
196 } while (parent
!= null
197 && parent
.getValue().nbEvents
== 0);
199 if (parent
== null) {
202 return (double) node
.getValue().nbEvents
203 / parent
.getValue().nbEvents
;
207 new ColumnData(CPU_TIME_COLUMN
, 125, SWT
.LEFT
, CPU_TIME_COLUMN_TIP
,
208 new ColumnLabelProvider() {
210 public String
getText(Object element
) {
211 StatisticsTreeNode node
= (StatisticsTreeNode
) element
;
213 if (folderLevels
.contains(node
.getKey())) {
214 return ""; //$NON-NLS-1$
215 } else if (node
.getParent() != null
216 && levelsWithEmptyTime
.contains(node
217 .getParent().getKey())) {
218 return ""; //$NON-NLS-1$
221 .format(node
.getValue().cpuTime
226 new ColumnData(CUMULATIVE_CPU_TIME_COLUMN
, 155, SWT
.LEFT
,
227 CUMULATIVE_CPU_TIME_COLUMN_TIP
, new ColumnLabelProvider() {
229 public String
getText(Object element
) {
230 StatisticsTreeNode node
= (StatisticsTreeNode
) element
;
231 if (folderLevels
.contains(node
.getKey())) {
232 return ""; //$NON-NLS-1$
233 } else if (node
.getParent() != null
234 && levelsWithEmptyTime
.contains(node
235 .getParent().getKey())) {
236 return ""; //$NON-NLS-1$
239 .format(node
.getValue().cumulativeCpuTime
244 new ColumnData(ELAPSED_TIME_COLUMN
, 100, SWT
.LEFT
,
245 ELAPSED_TIME_COLUMN_TIP
, new ColumnLabelProvider() {
247 public String
getText(Object element
) {
248 StatisticsTreeNode node
= (StatisticsTreeNode
) element
;
249 if (folderLevels
.contains(node
.getKey())) {
250 return ""; //$NON-NLS-1$
251 } else if (node
.getParent() != null
252 && levelsWithEmptyTime
.contains(node
253 .getParent().getKey())) {
254 return ""; //$NON-NLS-1$
257 .format(node
.getValue().elapsedTime
264 * Adapter TreeViewers can use to interact with StatisticsTreeNode objects.
266 * @see org.eclipse.jface.viewers.ITreeContentProvider
268 class TreeContentProvider
implements ITreeContentProvider
{
273 * org.eclipse.jface.viewers.ITreeContentProvider#getChildren(java.lang
277 public Object
[] getChildren(Object parentElement
) {
278 return ((StatisticsTreeNode
) parentElement
).getChildren().toArray();
285 * org.eclipse.jface.viewers.ITreeContentProvider#getParent(java.lang
289 public Object
getParent(Object element
) {
290 return ((StatisticsTreeNode
) element
).getParent();
297 * org.eclipse.jface.viewers.ITreeContentProvider#hasChildren(java.lang
301 public boolean hasChildren(Object element
) {
302 return ((StatisticsTreeNode
) element
).hasChildren();
309 * org.eclipse.jface.viewers.IStructuredContentProvider#getElements(
313 public Object
[] getElements(Object inputElement
) {
314 return getChildren(inputElement
);
320 * @see org.eclipse.jface.viewers.IContentProvider#dispose()
323 public void dispose() {
330 * org.eclipse.jface.viewers.IContentProvider#inputChanged(org.eclipse
331 * .jface.viewers.Viewer, java.lang.Object, java.lang.Object)
335 public void inputChanged(Viewer viewer
, Object oldInput
, Object newInput
) {
339 public StatisticsView(String viewName
) {
343 private static final String STATISTICS_VIEW
= "StatisticsView"; //$NON-NLS-1$
344 public StatisticsView() {
345 this(STATISTICS_VIEW
);
352 * org.eclipse.ui.part.WorkbenchPart#createPartControl(org.eclipse.swt.widgets
356 public void createPartControl(Composite parent
) {
357 parent
.setLayout(new FillLayout());
359 treeViewer
= new TreeViewer(parent
, SWT
.BORDER
| SWT
.H_SCROLL
361 treeViewer
.setContentProvider(new TreeContentProvider());
362 treeViewer
.getTree().setHeaderVisible(true);
363 treeViewer
.setUseHashlookup(true);
365 for (final ColumnData columnData
: columnDataList
) {
366 final TreeViewerColumn treeColumn
= new TreeViewerColumn(
367 treeViewer
, columnData
.alignment
);
368 treeColumn
.getColumn().setText(columnData
.header
);
369 treeColumn
.getColumn().setWidth(columnData
.width
);
370 treeColumn
.getColumn().setToolTipText(columnData
.tooltip
);
371 if (columnData
.comparator
!= null) {
372 treeColumn
.getColumn().addSelectionListener(
373 new SelectionAdapter() {
375 public void widgetSelected(SelectionEvent e
) {
376 if (treeViewer
.getTree().getSortDirection() == SWT
.UP
377 || treeViewer
.getTree().getSortColumn() != treeColumn
380 .setComparator(columnData
.comparator
);
381 treeViewer
.getTree().setSortDirection(
385 .setComparator(new ViewerComparator() {
389 Object e1
, Object e2
) {
391 * columnData
.comparator
398 treeViewer
.getTree().setSortDirection(
401 treeViewer
.getTree().setSortColumn(
402 treeColumn
.getColumn());
406 treeColumn
.setLabelProvider(columnData
.labelProvider
);
409 // Handler that will draw the bar charts.
410 treeViewer
.getTree().addListener(SWT
.EraseItem
, new Listener() {
413 public void handleEvent(Event event
) {
414 if (columnDataList
[event
.index
].percentageProvider
!= null) {
415 StatisticsTreeNode node
= (StatisticsTreeNode
) event
.item
418 double percentage
= columnDataList
[event
.index
].percentageProvider
419 .getPercentage(node
);
420 if (percentage
== 0) {
424 if ((event
.detail
& SWT
.SELECTED
) > 0) {
425 Color oldForeground
= event
.gc
.getForeground();
426 event
.gc
.setForeground(event
.item
.getDisplay()
427 .getSystemColor(SWT
.COLOR_LIST_SELECTION
));
428 event
.gc
.fillRectangle(event
.x
, event
.y
, event
.width
,
430 event
.gc
.setForeground(oldForeground
);
431 event
.detail
&= ~SWT
.SELECTED
;
434 int barWidth
= (int) ((treeViewer
.getTree().getColumn(1)
435 .getWidth() - 8) * percentage
);
436 int oldAlpha
= event
.gc
.getAlpha();
437 Color oldForeground
= event
.gc
.getForeground();
438 Color oldBackground
= event
.gc
.getBackground();
439 event
.gc
.setAlpha(64);
440 event
.gc
.setForeground(event
.item
.getDisplay()
441 .getSystemColor(SWT
.COLOR_BLUE
));
442 event
.gc
.setBackground(event
.item
.getDisplay()
443 .getSystemColor(SWT
.COLOR_LIST_BACKGROUND
));
444 event
.gc
.fillGradientRectangle(event
.x
, event
.y
, barWidth
,
446 event
.gc
.drawRectangle(event
.x
, event
.y
, barWidth
,
448 event
.gc
.setForeground(oldForeground
);
449 event
.gc
.setBackground(oldBackground
);
450 event
.gc
.setAlpha(oldAlpha
);
451 event
.detail
&= ~SWT
.BACKGROUND
;
456 treeViewer
.setComparator(columnDataList
[0].comparator
);
457 treeViewer
.getTree().setSortColumn(treeViewer
.getTree().getColumn(0));
458 treeViewer
.getTree().setSortDirection(SWT
.DOWN
);
460 // Read current data if any available
461 TmfExperiment
<?
> experiment
= TmfExperiment
.getCurrentExperiment();
462 if (experiment
!= null) {
463 requestData(experiment
);
465 TraceDebug
.debug("No selected experiment information available"); //$NON-NLS-1$
470 public void dispose() {
472 if (fwaitCursor
!= null) {
473 fwaitCursor
.dispose();
477 StatisticsTreeRootFactory
.removeAll();
483 * @see org.eclipse.ui.part.WorkbenchPart#setFocus()
486 public void setFocus() {
487 treeViewer
.getTree().setFocus();
493 * @see org.eclipse.linuxtools.lttng.ui.views.common.AbsTimeUpdateView#getInputChangedRefresh()
496 protected Long
getInputChangedRefresh() {
497 return STATS_INPUT_CHANGED_REFRESH
;
504 public AbsEventToHandlerResolver
getEventProcessor() {
505 return StatsTimeCountHandlerFactory
.getInstance();
512 * org.eclipse.linuxtools.lttng.ui.views.common.AbsTimeUpdateView#waitCursor
516 protected void waitCursor(final boolean waitInd
) {
517 if ((treeViewer
== null) || (treeViewer
.getTree().isDisposed())) {
521 Display display
= treeViewer
.getControl().getDisplay();
522 if (fwaitCursor
== null) {
523 fwaitCursor
= new Cursor(display
, SWT
.CURSOR_WAIT
);
526 // Perform the updates on the UI thread
527 display
.asyncExec(new Runnable() {
530 if ((treeViewer
!= null) && (!treeViewer
.getTree().isDisposed())) {
531 Cursor cursor
= null; /* indicates default */
533 cursor
= fwaitCursor
;
535 treeViewer
.getControl().setCursor(cursor
);
542 public void ModelUpdatePrep(TmfTimeRange timeRange
, boolean clearAllData
) {
543 Object input
= treeViewer
.getInput();
544 if ((input
!= null) && (input
instanceof StatisticsTreeNode
) && (!treeViewer
.getTree().isDisposed())) {
545 ((StatisticsTreeNode
) input
).reset();
546 treeViewer
.getTree().getDisplay().asyncExec(new Runnable() {
550 if (!treeViewer
.getTree().isDisposed())
551 treeViewer
.refresh();
558 public void modelInputChanged(ILttngSyntEventRequest request
, boolean complete
) {
559 // Ignore update if disposed
560 if (treeViewer
.getTree().isDisposed()) return;
562 treeViewer
.getTree().getDisplay().asyncExec(new Runnable() {
566 if (!treeViewer
.getTree().isDisposed())
567 treeViewer
.refresh();
575 * @see org.eclipse.linuxtools.lttng.ui.views.common.AbsTimeUpdateView#
577 * (org.eclipse.linuxtools.lttng.request.ILttngSyntEventRequest)
580 public void modelIncomplete(ILttngSyntEventRequest request
) {
581 Object input
= treeViewer
.getInput();
582 if (input
!= null && input
instanceof StatisticsTreeNode
) {
583 // The data from this experiment is invalid and shall be removed to
584 // refresh upon next selection
585 String name
= request
.getExperimentName();
586 StatisticsTreeRootFactory
.removeStatTreeRoot(name
);
594 public void experimentSelected(TmfExperimentSelectedSignal
<?
extends TmfEvent
> signal
) {
595 if (signal
!= null) {
596 TmfExperiment
<?
> experiment
= signal
.getExperiment();
597 String experimentName
= experiment
.getName();
599 if (StatisticsTreeRootFactory
.containsTreeRoot(experimentName
)) {
600 // The experiment root is already present
601 StatisticsTreeNode experimentTreeNode
= StatisticsTreeRootFactory
.getStatTreeRoot(experimentName
);
603 ITmfTrace
[] traces
= experiment
.getTraces();
605 // check if there is partial data loaded in the experiment
606 int numTraces
= experiment
.getTraces().length
;
607 int numNodeTraces
= experimentTreeNode
.getNbChildren();
609 if (numTraces
== numNodeTraces
) {
611 // Detect if the experiment contains the same traces as when
612 // previously selected
613 for (int i
= 0; i
< numTraces
; i
++) {
614 String traceName
= traces
[i
].getName();
615 if (!experimentTreeNode
.containsChild(traceName
)) {
622 // no need to reload data, all traces are already loaded
623 treeViewer
.setInput(experimentTreeNode
);
629 // if the data is not available or has changed, reload it
630 requestData(experiment
);
637 private void requestData(TmfExperiment
<?
> experiment
) {
638 if (experiment
!= null) {
639 StatisticsTreeNode treeModelRoot
= StatisticsTreeRootFactory
.getStatTreeRoot(experiment
.getName());
641 // if the model has contents, clear to start over
642 if (treeModelRoot
.hasChildren()) {
643 treeModelRoot
.reset();
646 // set input to a clean data model
647 treeViewer
.setInput(treeModelRoot
);
648 TmfTimeRange experimentTRange
= experiment
.getTimeRange();
650 // send the initial request, to start filling up model
651 dataRequest(experimentTRange
, experimentTRange
, true, ExecutionType
.BACKGROUND
);
653 TraceDebug
.debug("No selected experiment information available"); //$NON-NLS-1$
661 * org.eclipse.linuxtools.lttng.ui.views.common.AbsTimeUpdateView#displayModel
662 * (org.eclipse.linuxtools.tmf.ui.viewers.timeAnalysis.model.
663 * ITmfTimeAnalysisEntry[], long, long, boolean, long, long,
667 protected void displayModel(ITmfTimeAnalysisEntry
[] items
, long startBoundTime
, long endBoundTime
,
668 boolean updateTimeBounds
, long startVisibleWindow
, long endVisibleWindow
, Object source
) {
669 // No applicable to statistics view
675 * @see org.eclipse.linuxtools.lttng.ui.views.common.AbsTimeUpdateView#
679 protected ParamsUpdater
getParamsUpdater() {
680 // Not applicable to statistics view
685 protected ItemContainer
<?
> getItemContainer() {
686 // Not applicable to statistics view
692 * @see org.eclipse.linuxtools.lttng.ui.views.common.AbsTimeUpdateView#getProviderId()
695 protected int getProviderId() {
696 return LttngCoreProviderFactory
.STATISTICS_LTTNG_SYTH_EVENT_PROVIDER
;