1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!--
(c) Copyright 2010 Aconex. All rights reserved.
(c) Copyright 2000-2004 Silicon Graphics Inc. All rights reserved.
Permission is granted to copy, distribute, and/or modify this document
under the terms of the Creative Commons Attribution-Share Alike, Version
3.0 or any later version published by the Creative Commons Corp. A copy
of the license is available at
http://creativecommons.org/licenses/by-sa/3.0/us/ .
-->
<HTML>
<HEAD>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta http-equiv="content-style-type" content="text/css">
<link href="pcpdoc.css" rel="stylesheet" type="text/css">
<link href="images/pcp.ico" rel="icon" type="image/ico">
<TITLE>Performance Visualisation with pmview</TITLE>
</HEAD>
<BODY LANG="en-AU" TEXT="#000060" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR> <TD WIDTH=64 HEIGHT=64><FONT COLOR="#000080"><A HREF="http://pcp.io/"><IMG SRC="images/pcpicon.png" NAME="pmcharticon" ALIGN=TOP WIDTH=64 HEIGHT=64 BORDER=0></A></FONT></TD>
<TD WIDTH=1><P> </P></TD>
<TD WIDTH=500><P VALIGN=MIDDLE ALIGN=LEFT><A HREF="index.html"><FONT COLOR="#cc0000">Home</FONT></A> · <A HREF="lab.pmchart.html"><FONT COLOR="#cc0000">Charts</FONT></A> · <A HREF="timecontrol.html"><FONT COLOR="#cc0000">Time Control</FONT></A></P></TD>
</TR>
</TABLE>
<H1 ALIGN=CENTER STYLE="margin-top: 0.48cm; margin-bottom: 0.32cm"><FONT SIZE=7>Performance Visualisation with <I>pmview</I></FONT></H1>
<TABLE WIDTH=15% BORDER=0 CELLPADDING=5 CELLSPACING=10 ALIGN=RIGHT>
<TR><TD BGCOLOR="#e2e2e2"><IMG SRC="images/system-search.png" WIDTH=16 HEIGHT=16 BORDER=0> <I>Tools</I><BR><PRE>
pmview
mpvis
osvis
dkvis
pmafm
pmtime
pmchart
</PRE></TD></TR>
</TABLE>
<P><B>Note:</B> The open source version of <I>pmview</I> is currently under development, and is <B>not</B> yet shipped as part of PCP GUI, but is available for experimental use in the development source tree.</P>
<P>Visual tools take advantage of common cognitive skills, especially for visual pattern matching and scene change discrimination.
The motivation for visualization of performance data is very similar to that used for engineering visualization, visual simulation, and database mining through visualization - visually rich representations of complex data sets are powerful aids to understanding and detection of unexpected relationships.</P>
<UL>
<LI>
<A HREF="#realtime">Live monitoring and user interface concepts</A>
<LI>
<A HREF="#archive">Retrospective monitoring and tool drill-down</A>
<LI>
<A HREF="#vis">The "vis" tools</A>
<LI>
<A HREF="#simple">Simple scene construction</A>
</UL>
<TABLE WIDTH=50% BORDER=0 CELLPADDING=10 CELLSPACING=20>
<TR><TD BGCOLOR="#e2e2e2" WIDTH=70%><BR><IMG SRC="images/stepfwd_on.png" WIDTH=16 HEIGHT=16 BORDER=0> Extract the PCP archives and configuration files we will use in this tutorial into the current working directory:
<PRE><B>
$ . /etc/pcp.env
$ tar xzf $PCP_DEMOS_DIR/tutorials/pmview.tar.gz
</B></PRE>
</TD></TR>
</TABLE>
<P>For an explanation of Performance Co-Pilot terms and acronyms, consult
the <A HREF="glossary.html">PCP glossary</A>.</P>
<P><BR></P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 BGCOLOR="#e2e2e2">
<TR><TD WIDTH=100% BGCOLOR="#081c59"><P ALIGN=LEFT><FONT SIZE=5 COLOR="#ffffff"><B><A NAME="realtime">Live monitoring and user interface concepts</A></B></FONT></P></TD></TR>
</TABLE>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR> <TD WIDTH=568><P VALIGN=MIDDLE ALIGN=RIGHT><CENTER><BR><IMG ALIGN=RIGHT SRC="images/mpvis.png" BORDER=0></CENTER></P></TD>
<TD WIDTH=10></TD>
<TD><TABLE WIDTH=100% BORDER=0 CELLPADDING=10 CELLSPACING=20>
<TR><TD BGCOLOR="#e2e2e2" WIDTH=70%><BR><IMG SRC="images/stepfwd_on.png" WIDTH=16 HEIGHT=16 BORDER=0> The <I>mpvis</I> command monitors the CPU utilization for each CPU:<BR>
<PRE><B>
$ mpvis
</B></PRE>
<UL>
<LI> Move the cursor over each block in the scene. Take time to read the
(changed) text box above the 3D scene and understand what it is telling
you. In particular, identify the source of the metric, the name of the
metric, the instance of the metric, the current value ... can you
explain what "millisec / second" really means?
<LI> Click the left mouse over one block in the scene. How is this
different?
<LI> Click on the "Live" button or Ctrl-T or <B><I>Options ->
Show Time Control</I></B> from the menu bar. In the <B>PCP Live Time
Control</B> dialog, experiment with changing the update <B><I>Interval</I></B>
(this is the interval at which new metric values are fetched from <I>pmcd</I>).
<LI> Quit with <B><I>File -> Quit</I></B> or Ctrl-Q.
</UL>
</TD></TR>
</TABLE></TD>
</TABLE>
<P><BR></P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 BGCOLOR="#e2e2e2">
<TR><TD WIDTH=100% BGCOLOR="#081c59"><P ALIGN=LEFT><FONT SIZE=5 COLOR="#ffffff"><B><A NAME="archive">Retrospective monitoring and tool drill-down</A></B></FONT></P></TD></TR>
</TABLE>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR><TD><TABLE WIDTH=100% BORDER=0 CELLPADDING=10 CELLSPACING=20>
<TD BGCOLOR="#e2e2e2" WIDTH=70%><BR><IMG SRC="images/stepfwd_on.png" WIDTH=16 HEIGHT=16 BORDER=0> The <I>dkvis</I> command monitors the per-disk I/O activity:<BR>
<PRE><B>
$ dkvis -a pmie/babylon.perdisk
</B></PRE>
<UL>
<LI> In the <I>dkvis</I> window (above the top left-hand corner of the
scene) change the <B><I>Scale</I></B> to be 5 using either the
thumbwheel or the text box to the right of the thumbwheel.
<LI> In the associated <B>PCP Archive Time Control</B> dialog, changing
the update <B><I>Interval</I></B> to 2 minutes (remember to Enter
after you have changed the <B><I>Interval</I></B> text box).
<LI> Double click the <B><I>Play</I></B> button. When the replay
finished, drag the slider in the <B>PCP Archive Time Control</B>
dialog back to near the middle of the range and release the
slider.
<LI> Back in the <I>dkvis</I> window, move the cursor over each block in
the scene. Take time to read the (changed) text box above the 3D scene
and understand what it's telling you. In particular, identify the
source of the metric, the name of the metric, the instance of the
metric, the current value ... can you explain what "count /
second" really means?
<LI> Select all of the blocks for controller <B>dks1</B> (use
"Shift-select" to do multiple selections), and then <B><I>Launch -> pmchart</I></B>
from the main menu. In the pmchart window use <B><I>File -> Open View</I></B>
from the menu bar to add the <B>LoadAvg</B> view.
This is a "drill-down" example.
<LI> Use the <B>PCP Archive Time Control</B> dialog again - this time
notice that you're controlling movement through both <I>dkvis</I>
and <I>pmchart</I> using the same time control window (that's
because <I>pmchart</I> was launched from <I>dkvis</I>).
<LI> Quit from <I>dkvis</I>. Notice that <I>pmchart</I> and the <I>pmtime</I>
dialog remain. Quit from <I>pmchart</I>.
</UL>
</TD></TABLE>
</TD>
<TD WIDTH=10></TD>
<TD WIDTH=486><P VALIGN=MIDDLE ALIGN=RIGHT><CENTER><BR><IMG ALIGN=RIGHT SRC="images/dkvis.png" BORDER=0></CENTER></P></TD>
</TR>
</TABLE>
<P><BR></P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 BGCOLOR="#e2e2e2">
<TR><TD WIDTH=100% BGCOLOR="#081c59"><P ALIGN=LEFT><FONT SIZE=5 COLOR="#ffffff"><B><A NAME="vis">The "vis" tools</A></B></FONT></P></TD></TR>
</TABLE>
<P> Try some of the other "vis" tools. All of these are
"front-ends" to <I>pmview</I> as shown in this diagram:</P>
<CENTER>
<IMG SRC="images/pmview.flow.png" ALIGN="MIDDLE" WIDTH="444" HEIGHT="227">
</CENTER>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=10 CELLSPACING=20>
<TR><TD BGCOLOR="#e2e2e2" WIDTH=70%><BR><IMG SRC="images/stepfwd_on.png" WIDTH=16 HEIGHT=16 BORDER=0> In a command shell enter:<BR>
<PRE><B>
$ osvis
</B></PRE>
Move the cursor over each baseplane for more information. Now enter:
<PRE><B>
$ pmafm pmie/godzillaweb.folio replay
</B></PRE>
<I>pmafm</I> is a folio manager which allows you to work with a folio of archives for
many visualisation tools; in this case, with the folio <TT>godzillaweb</TT>.
</TD></TR>
</TABLE>
<P><BR></P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 BGCOLOR="#e2e2e2">
<TR><TD WIDTH=100% BGCOLOR="#081c59"><P ALIGN=LEFT><FONT SIZE=5 COLOR="#ffffff"><B><A NAME="simple">Simple scene construction</A></B></FONT></P></TD></TR>
</TABLE>
<P>The text file <A HREF="pmview/example.view">pmview/example.view</A>
specifies a <I>pmview</I> configuration having one baseplane with
one bar containing three metrics (5, 10, and 15 minute load averages),
and separate bars for each of the disk read and write metrics.
<TABLE WIDTH=100% BORDER=0 CELLPADDING=10 CELLSPACING=20>
<TR><TD BGCOLOR="#e2e2e2" WIDTH=70%><BR><IMG SRC="images/stepfwd_on.png" WIDTH=16 HEIGHT=16 BORDER=0> To display this scene, run:<BR>
<PRE><B>
$ pmview < pmie/example.view
</B></PRE>
An a learning exercise, copy <I>example.view</I> and modify the configuration so
that instead of having the disk metrics as two separate blocks (bars), they
appear as a single stacked bar showing both metrics, one on top of the other.
</TD></TR>
</TABLE>
<H4>Hints</H4>
<UL>
<LI>
The <I>osvis</I> tool we saw earlier uses stacked bars for memory
and CPU utilization.
<LI>
The configuration generated by <B>any</B> <I>pmview </I>front-end
script can be viewed using a <B>-V</B> option to the front-end
tool, and a <B>-C</B> option means quit after generating the
configuration (do not launch <I>pmview</I>). So the following may
be helpful:
<PRE>
<I> </I><B>$</B><I> </I>osvis -V -C<I> </I>
</PRE>
<LI>
The <I>pmview(1)</I> man page describes the <I>pmview </I>configuration
format in detail. Look for the <B><TT>_stack</TT></B> object.
</UL>
<P><BR></P>
<HR>
<CENTER>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR> <TD WIDTH=50%><P>Copyright © 2007-2010 <A HREF="http://www.aconex.com/"><FONT COLOR="#000060">Aconex</FONT></A><BR>Copyright © 2000-2004 <A HREF="http://www.sgi.com/"><FONT COLOR="#000060">Silicon Graphics Inc</FONT></P></TD>
<TD WIDTH=50%><P ALIGN=RIGHT><A HREF="http://pcp.io/"><FONT COLOR="#000060">PCP Site</FONT></A><BR>Copyright © 2012-2014 <A HREF="http://www.redhat.com/"><FONT COLOR="#000060">Red Hat</FONT></P></TD> </TR>
</TABLE>
</CENTER>
</BODY>
</HTML>
|
