ldmpower

- show per-domain, power-consumption information

Synopsis

ldmpower [-ehiprstvx | -o hours | -m minutes] [-c resource] [-l ldom[,ldom[,...]]]
  [interval [count]]

Description

The ldmpower command shows the power-consumption data in watts for domains. By default, it shows the processor power that is consumed by each running domain. You can use options to view memory power-consumption data and the extrapolated power consumption of the entire system divided among the running domains. The per-domain system power consumption is calculated by using strand utilization averages, as well as the percentage of memory bound to each running domain.

When specified with no options, the ldmpower command shows the average power consumption during the last 15, 30, and 60 seconds. The command can also show the most recent power-consumption data. For a longer history, the command can show up to 60 one-minute averages covering the last hour and 336 one-hour averages covering the last 14 days.

To run this command as a non-privileged user, you must be assigned the LDoms Power Mgmt Observability rights profile. If you already have been assigned the LDoms Management or LDoms Review rights profile, you automatically have permission to run the ldmpower command.

The ldmpower command uses the following options and operands:

-c resource

Shows per-domain power consumption for the specified resource type, resource. Valid values are processors and memory. The long version of this option is --component.

-e

Shows the minimum and maximum power-consumption values since data recording began. The long version of this option is --extremes.

-h

Shows descriptions of the ldmpower command options. The alternate short version of this option is -? and the long version of this option is --help.

-i

Shows instantaneous power-consumption data. The long versions of this option are --instant and --instantaneous.

-l ldom

Shows power-consumption data for one or more specified domains. Domain names are separated by commas. The long version of this option is --list.

Note that less data is shown for domains that have been booted for a shorter amount of time than the requested period.

-m minutes

Shows up to one hour of average power-consumption data in fixed one-minute intervals. The long version of this option is --minutes.

Note that less data is shown if the Logical Domains daemon has been running for a shorter amount of time than the requested period.

-o hours

Shows up to 14 days of average power-consumption data in fixed one-hour intervals. The long version of this option is --hours.

Note that less data is shown if the Logical Domains daemon has been running for a shorter amount of time than the requested period.

-p

Shows the overall power consumption for the entire system, which includes processors, memory, and fans. The long version of this option is --platform.

-r

Shows the rolling average power-consumption history for the past 15, 30, and 60 seconds. The long version of this option is --rolling.

-s

Suppresses the output header. The long version of this option is --suppress.

-t

Shows time stamps in the output. The long version of this option is --timestamps.

-v

Shows version data. The long version of this option is --version.

-x

Shows extrapolated power-consumption averages. These averages reflect the percentage of overall system watts that are being consumed based on strand utilization statistics and the percentage of memory bound to the domain. This option can be used with any of the -o, -i, -m, and -r options. The long version of this option is --extrapolate.

interval

Reports output once each interval seconds.

count

Shows count reports. If you specify the count, you must first specify the interval.

Examples

Example 1 Viewing Power-Consumption Data

The following command shows the 15-second, 30-second, and 60-second rolling average power-consumption data for all domains:

# ldmpower
DOMAIN  15_SEC  30_SEC  60_SEC
primary 315     469     520
gdom1   275     308     210
gdom2   250     230     220

Example 2 Viewing Power-Consumption Data at a Regular Interval

The following commands show power-consumption data at a regular interval:

• The following command shows the instantaneous power-consumption data and the 15-second, 30-second, and 60-second rolling average power-consumption data for all domains. The -i option shows the instantaneous power-consumption data, and the -r option shows the rolling average power-consumption data. The -t option shows time stamps in the output. The operand, 10, in the command line indicates that power-consumption data is reported in 10-second intervals. The data continues to be output until an interrupt is received.

  # ldmpower -rit 10
  DOMAIN  TIMESTAMP               INSTANT 15_SEC  30_SEC  60_SEC
  primary 2012.08.29 12:05:05     509     430     469     520
  gdom1   2012.08.29 12:05:05     250     357     308     210
  gdom2   2012.08.29 12:05:05     222     201     230     220
  
  primary 2012.08.29 12:05:15     469     367     459     244
  gdom1   2012.08.29 12:05:15     301     275     256     301
  gdom2   2012.08.29 12:05:15     278     250     246     236
  
  primary 2012.08.29 12:05:25     509     430     469     520
  gdom1   2012.08.29 12:05:25     349     325     300     298
  gdom2   2012.08.29 12:05:25     420     349     306     300

• The following command shows the instantaneous power-consumption data and the 15-second, 30-second, and 60-second rolling average power-consumption data for all domains. By specifying the operand 10, the output is recomputed in 10-second intervals. By specifying the -s option, the column headings are suppressed in the output. Output continues until an interrupt is received.

  # ldmpower -ris 10
  primary 509     430     469     520
  gdom1   250     357     308     210
  gdom2   222     201     230     220
  
  primary 469     367     459     244
  gdom1   301     275     256     301
  gdom2   278     250     246     236
  
  primary 509     430     469     520
  gdom1   349     325     300     298
  gdom2   420     349     306     300

Example 3 Viewing Power-Consumption Data for the Entire System

The following commands show the overall instantaneous system power consumption in watts:

• The following command shows the instantaneous power-consumption data for the system, processors, memory, and fans. The -t option includes time stamps in the output.

  # ldmpower -tp
  Overall Instant System Power Consumption in Watts
  System          2012.08.23 23:13:33     738
  Processors      2012.08.23 23:13:33     295
  Memory          2012.08.23 23:13:33     138
  Fans            2012.08.23 23:13:33     28

• The following command shows the instantaneous power-consumption data for the system, processors, memory, and fans:

  # ldmpower -p
  Overall Instant System Power Consumption in Watts
  System          738
  Processors      295
  Memory          138
  Fans            25

Example 4 Viewing Per-Domain, Power-Consumption Data

The following commands show the per-domain power consumption in watts for memory, processors, or both:

• The following command shows the power-consumption data for memory:

  # ldmpower -c memory
  Memory Power Consumption in Watts
  DOMAIN  15_SEC_AVG 30_SEC_AVG 60_SEC_AVG
  primary 138        138        138
  ldg1    19         19         19
  ldg2    19         19         19

• The following command shows the rolling power-consumption data for memory and processors:

  # ldmpower -c memory -c processors
  Processor Power Consumption in Watts
  DOMAIN  15_SEC_AVG 30_SEC_AVG 60_SEC_AVG
  primary 63         61         60
  ldg1    9          10         10
  ldg2    9          9          10
  
  Memory Power Consumption in Watts
  DOMAIN  15_SEC_AVG 30_SEC_AVG 60_SEC_AVG
  primary 138        138        138
  ldg1    19         19         19
  ldg2    19         19         19

• The following command shows the instantaneous power-consumption data for memory and processors:

  # ldmpower -c memory -c processors -i
  Processor Power Consumption in Watts
  DOMAIN  INSTANT
  primary 292
  ldg1    10
  ldg2    10
  
  Memory Power Consumption in Watts
  DOMAIN  INSTANT
  primary 138
  ldg1    19
  ldg2    19

Example 5 Viewing Power-Consumption Data for Specified Domains

The following command shows the instantaneous power-consumption data for the gdom2 and gdom5 domains. The -i option shows the instantaneous power-consumption data, and the -t option shows time stamps in the output. The -l option arguments specify that only information about the gdom2 and gdom5 domains appear in the output. The first operand, 10, indicates that power-consumption data is reported in 10-second intervals. The second operand, 5, is the number of iterations for which the data is output.

# ldmpower -itl gdom2, gdom5 10 5
Processor Power Consumption in Watts
DOMAIN  TIMESTAMP               INSTANT
gdom2   2012.08.29 12:05:33     222
gdom5   2012.08.29 12:05:33     467

gdom2   2012.08.29 12:05:43     351
gdom5   2012.08.29 12:05:43     256

gdom2   2012.08.29 12:05:53     344
gdom5   2012.08.29 12:05:53     435

gdom2   2012.08.29 12:06:03     645
gdom5   2012.08.29 12:06:03     467

gdom2   2012.08.29 12:06:13     378
gdom5   2012.08.29 12:06:13     257

Example 6 Viewing Power-Consumption Data for a Specified Amount of Time

The following commands show power-consumption data for specified amounts of time:

• The following command shows the average power-consumption data for the last 12 hours for all domains. The -e option shows the minimum and maximum values since data recording began, and the -t option shows time stamps in the output. The -o option argument specifies the number of hours to show the average hourly power-consumption data. Data is shown at one-hour intervals, starting from the last requested hourly calculation.

  # ldmpower -eto 12
  Per domain MINIMUM and MAXIMUM power consumption ever recorded:
  
  primary         2012.08.29 06:59:55     151              Min Processors
  primary         2012.08.29 06:56:20     682              Max Processors
  gdom1           2012.08.29 06:56:25     36               Min Processors
  gdom1           2012.08.29 07:02:10     318              Max Processors
  gdom2           2012.08.29 06:56:25     42               Min Processors
  gdom2           2012.08.29 07:05:45     417              Max Processors
  
  primary         2012.08.29 06:59:55     137              Min Memory
  primary         2012.08.29 06:56:20     138              Max Memory
  gdom1           2012.08.29 06:56:25     59               Min Memory
  gdom1           2012.08.29 07:02:10     60               Max Memory
  gdom2           2012.08.29 06:56:25     59               Min Memory
  gdom2           2012.08.29 07:05:45     60               Max Memory
  
  12 hours worth of data starting from 2012.08.29 12:05:33:
  
  DOMAIN  TIMESTAMP                       1 HOUR AVG
  primary 2012.08.29 12:05:33             574
  gdom1   2012.08.29 12:05:33             268
  gdom2   2012.08.29 12:05:33             386
  
  primary 2012.08.29 13:05:33             488
  gdom1   2012.08.29 13:05:33             250
  gdom2   2012.08.29 13:05:33             364
  
  primary 2012.08.29 14:05:33             694
  gdom1   2012.08.29 14:05:33             276
  gdom2   2012.08.29 14:05:33             364
  ...

• The following command shows the average power-consumption data for the last 30 minutes for all domains. The -e option shows the minimum and maximum values since data recording began, and the -t option shows time stamps in the output. The -m option argument specifies the number of minutes to show the average power-consumption data. Data is shown at one-minute intervals.

  # ldmpower -etm 30
  Per domain MINIMUM and MAXIMUM power consumption ever recorded:
  
  primary         2012.08.29 06:59:55     151              Min Processors
  primary         2012.08.29 06:56:20     682              Max Processors
  gdom1           2012.08.29 06:56:25     36               Min Processors
  gdom1           2012.08.29 07:02:10     318              Max Processors
  gdom2           2012.08.29 06:56:25     42               Min Processors
  gdom2           2012.08.29 07:05:45     417              Max Processors
  
  primary         2012.08.29 06:59:55     137              Min Memory
  primary         2012.08.29 06:56:20     138              Max Memory
  gdom1           2012.08.29 06:56:25     59               Min Memory
  gdom1           2012.08.29 07:02:10     60               Max Memory
  gdom2           2012.08.29 06:56:25     59               Min Memory
  gdom2           2012.08.29 07:05:45     60               Max Memory
  
  30 minute's worth of data starting from 2012.08.29 12:05:33:
  
  DOMAIN  TIMESTAMP                       1 MIN AVG
  primary 2012.08.29 12:05:33             574
  gdom1   2012.08.29 12:05:33             268
  gdom2   2012.08.29 12:05:33             386
  
  primary 2012.08.29 12:06:33             555
  gdom1   2012.08.29 12:06:33             250
  gdom2   2012.08.29 12:06:33             364
  
  primary 2012.08.29 12:07:33             498
  gdom1   2012.08.29 12:07:33             276
  gdom2   2012.08.29 12:07:33             364
  ... 

Example 7 Viewing Extrapolated Power-Consumption Data for All Domains

The following command shows extrapolated power-consumption data for all the domains: primary, gdom1, and gdom2.

# ldmpower -x
System Power Consumption in Watts

DOMAIN    15_SEC        30_SEC          60_SEC
primary   315/38.14%    46942.79%       520/53.46%
gdom1     275/33.72%    308/32.68%      210/21.99%
gdom2     250/24.14%    230/24.53%      220/24.55%

Attributes

See the attributes(5) man page for a description of the following attribute.

See Also

ldmd(1M), attributes(5)