HP XC System 3.x Software - Manual (Page 52)

In a cluster environment with a consolidated HPCPI database and synchronized epochs, you
might want to include or exclude the data from specific systems or nodes. To view data from
individual nodes, use the -hosts option to include or exclude the data from specific systems
or nodes. The syntax to include data from specific systems or nodes is as follows:
-hosts hostname[,hostname]...
The syntax to exclude data from specific systems or nodes is as follows:
-hosts all-hostname[,hostname]...
Where hostname is the name of the system or node.
Example
The following hpcpiprof command displays data from all systems in the database except node2
and node3:
% hpcpiprof -hosts all-node2,node3
Specifying Events to Display
By default, the HPCPI utilities display data for all events monitored. Many of the utilities display
a column of data for each event, and if hpcpid monitored a large number of events, it may be
difficult to read the output. You can use the -event option to specify a subset of events to
display. The syntax is as follows:
-event event_name[,event_name]...
-event all-event_name[,event_name]...
Where:
event_name[,event_name]...
Selects the event specified by event_name. You can specify additional event names delimited
by commas (,).
all-event_name[,event_name]...
Selects all events monitored except the event specified by event_name. You can specify
additional event names delimited by commas (,) to exclude multiple events.
Examples:
The following hpcpiprof command selects the events CPU_CYCLES and
PREDICATE_SQUASHED_RETIRED
:
% hpcpiprof -event CPU_CYCLES,PREDICATE_SQUASHED_RETIRED
The following hpcpiprof command selects all events except NOPS_RETIRED:
% hpcpiprof -event all-NOPS_RETIRED
Selecting Data by Label
By default, the hpcpiprof, hpcpilist, and hpcpitopcounts utilities search for data with
all labels. If there is no labeled data, the utilities display all data that meet the other selection
criteria. To select data with a specific label, use the -label option. The syntax is as follows:
-label label_name [-label label_name...]
Where label_name is the name of the label.
Extracting Data for a Process from Shared Image Metrics
The performance data associated with the label includes data attributed to code executed in a
shared image (such as a shared library or kernel routine) that was called from the process. In the
following example, the user used the hpcpictl label command to associate performance
52 Using HPCPI