A.7. Visual Tracing (using PCP-GUI and pmchart)

Through the use of of the PCP-GUI package, you can use the pmchart graphical utility to plot performance metric values into graphs. The pmchart utility allows multiple charts to be displayed simultaneously, with metrics being sourced from one or more live hosts with alternative options to use metric data from PCP log archives as a source of historical data.
When you open pmchart, the PCP charts GUI displays. On the bottom of the display is the pmtime VCR-like controls. The start/pause button allows you to control the interval in which the metric data is polled and in the event that you are using historical data, the date and time for the metrics.
From the File -> New Chart option in the toolbar, you can select a metric from both the local machine and remote machines by specifying their host name or address and then selecting performance metrics from the remote hosts. Advanced configuration options include the ability to manually set the axis values for the chart and to manually choose the color of the plots.
There are multiple options to take images or record the views created in pmchart. You can save an image of the current view through the File -> Export option in the toolbar. Recording is made available by the Record -> Start option in the toolbar and these recordings can be stopped at a later time using Record -> Stop. After the recording has been terminated, the recorded metrics are archived to be viewed at a later date.
You can customize the pmchart interface to display the data from performance metrics in multiple ways, including line plot, bar graphs and utilization graphs. In pmchart, the main configuration file known as the “view” allows the metadata associated with one or more charts to be saved. This metadata describes all of the chart's aspects including the metrics used and the chart columns. You can create a custom “view” configuration which can be saved using File -> Save View and then loaded again at a later time. For more information about view configuration files and their syntax, see the pmchart(1) man page.
The following example pmchart view configuration describes a stacking chart graph showing the total number of glocks for the mounted GFS2 file system loop1 using the gfs2.glocks metric. We also have a plot graph underneath which plots the average latency for the glock grant, demote and queue requests for the same file system instance “loop1”.
#kmchart
version 1 

chart title "Total number of Glocks /loop1" style stacking antialiasing off
    plot legend "Shared"   metric gfs2.glocks.shared    instance "loop1"
    plot legend "Unlocked" metric gfs2.glocks.unlocked  instance "loop1"
    plot legend "Deferred" metric gfs2.glocks.deferred  instance "loop1"
    plot legend "Exclusive"metric gfs2.glocks.exclusive instance "loop1"

chart title "Average Glock Latency (usecs) /loop1" style plot antialiasing off
    plot legend "Demote" metric gfs2.latency.demote.all instance "loop1"
    plot legend "Grant"  metric gfs2.latency.grant.all  instance "loop1"
    plot legend "Queue"  metric gfs2.latency.queue.all  instance "loop1"