showgauge

You can use the showgauge command to display performance output by triggering an existing gauge.

Syntax

Read syntax diagramSkip visual syntax diagram>>-perfcli-- --showgauge-- --gauge_name------------------------><

Parameters

gauge_name
Specifies the gauge name to be displayed.

Description

You can use the showgauge command to display performance output by triggering an existing gauge.

Return values

Performance Historical Gauges: Each gauge displays the following vital output for performance historical gauges.

Gauge Name
The user-defined name from task creation.
Description
The user-defined description.
Device
The device ID of the component that is displayed in the gauge. The device ID is the nickname or model-serial-manufacturer of the device.
Component level
The component level that is identified in task creation.
Component ID
The component ID identified during task creation.
Thresholds
The thresholds that are applied to the selected metrics.
Warning
The warning value.
Time
The time of last data collection for the device or device component ("Last Data Collection").

After the information above is listed, a table follows with this information:

Date
The date collection was taken.
Time
The time of collection.
metric_name
The name of the metric, for example, Average Cache Holding Time is the heading for this column, and the value of the metric is listed in the table. This represents the gauge type that you selected during the creation of the definition. [0..greatest value registered by the performance data]

The metric name is the same as the one selected during the creation of the gauge. The number of metric columns is the same as the number of metrics selected during creation of the gauge.

Performance Real Time Gauges: Each gauge displays the following vital output for performance real time gauges.

Gauge Name
The user-defined name from task creation.
Description
The user-defined description.
Device
The device ID of the component displayed in gauge. The device ID is the nickname or model-serial-manufacturer.
Component level
The component level that was identified in task creation.
Component ID
The component ID that was identified during task creation.
metric_name
The value of the metric. The gauge type is selected by the user during the creation of the definition.

After the information above is listed, a table follows with this information:

Date
The date that the collection was taken.
Time
The time of the collection.
ID
For the maximum thresholds only, number of IDs that exceeded the maximum threshold.
metric_name
The name of the metric, for example, Average Cache Holding Time is the heading for this column, and the value of the metric is listed in the table. This represents the gauge type that you selected during the creation of the definition. [0..greatest value registered by the performance data].

The metric name is the same as the one selected during the creation of the gauge. The number of metric columns is the same as the number of metrics selected during creation of the gauge.

Exception Gauges: Each gauge displays the following vital output for exception gauges.

Gauge Name
The user-defined name from the task creation.
Device
The device ID of the component displayed in gauge. The device ID is the nickname or model-serial-manufacturer.
Thresholds
The thresholds that were applied to the selected metrics.
Warning
The warning value that was given.
Time
The time of last data collection for the device or device component ("Last Data Collection").
Description
The user-defined description.

After the information above is listed, a table follows with this information:

Date
The date that the collection was taken.
Time
The time of the collection.
metric_name
The name of the metric, for example, Average Cache Holding Time is the heading for this column, and the value of the metric is listed in the table. This represents the gauge type that you selected during the creation of the definition. [0..greatest value registered by the performance data].

The metric name is the same as the one selected during the creation of the gauge. The number of metric columns is the same as the number of metrics selected during creation of the gauge.

Possible failures

Examples

An invocation example:

perfcli> showgauge essTest5

The resulting output:

Name essTest5
Description My performance gauge
Device 2105.20870
Component Level Cluster
Component ID 2
Thresholds Cache Holding Time; Warning: 60.0; Error: 30.0; Status: enabled
LastDataCollection Wed Oct 15 14:31:44 PDT 2003


Date Time Average Cache Holding Time
==============================================================
Sep. 14, 2003 9:51:25 70
Sep. 15, 2003 9:52:25 65

Related topics

(C) Copyright International Business Machines Corporation 2004