Edit

Share via

PwrTest Idle Scenario

  • Article

The PwrTest Idle Scenario monitors user and CPU idle statistics displays idle statistics gathered by kernel every 15 seconds.

You can combine this scenario with the PwrTest Execution State Scenario (/es) to simultaneously monitor legacy execution state changes, which can help you diagnose why a system is not idling out to sleep.

Note  This is a legacy scenario and its recommended replacement is the PwrTest PPM Scenario (/ppm) for monitoring CPU idle statistics, and the PwrTest Monitor Scenario (/monitor) for monitoring user idle.

Syntax

pwrtest /idle  [/t:n] [/?] [/es [es_options]

/t:n
Specifies the total time (in minutes) for the scenario to run (the default value for n is 30 minutes).

/es [es_options]
Runs the PwrTest Execution State (ES) Scenario.

Examples

pwrtest /idle /t:60

pwrtest /idle /es /user

pwrtest /idle /es /kernel

XML log file output

<PwrTestLog>
  <SystemInformation>
  </SystemInformation>
  <PowerIdleStatistics> 
    <IdleStats> 
      <Time></Time>
      <Threshold></Threshold>
      <LowestIdleness></LowestIdleness>
      <AverageIdleness></AverageIdleness>
      <AccruedIdleTime></AccruedIdleTime>
      <NonIdleIgnored></NonIdleIgnored>
      <IdleToSleep></IdleToSleep>
      <NonIdleReferences></NonIdleReferences>
    </IdleStats>
    <EsChange> 
      <Time>XX:XX:XX</Time>
      <Process></Process>
        <RawState></RawState>
        <Continuous></Continuous>
        <System></System>
        <Display></Display>
        <AwayMode></AwayMode>
    </EsChange> 
  </PowerIdleStatistics>
</PwrTestLog>

The following table describes the XML elements that appear in the log file.

Element Description
<PowerIdleStatistics>

Contains information related to the idle scenario scenario. Only one <PowerIdleStatistics> element can appear in the PwrTest log file.
<IdleStats>

Contains idle statistics of the last idle period.
<Time>

Time of most recent idle statistics event.
<Threshold>

Idle ignore threshold.
<LowestIdleness>

Lowest idleness percent in the period.
<AverageIdleness>

Average idleness percent in the period.
<AccruedIdleTime>

Accrued idle time during the period.
<NonIdleIgnored>

Non-idle time that was ignored during the period.
<IdleToSleep>

Did the system idle to sleep during the period?
<NonIdleReferences>

Amount of non-idle ignore references during the period.
<EsChange>

Contains information related a single thread execution state change event. There will be one <EsChange> element for each thread execution state change event recorded in the PwrTest log file.
<Time>

Indicates the time when the execution state change event occurred.
<Process>

Indicates the path to the image file for the process that requested the execution state change.
<RawState>

Indicates the request execution state. This is a 32-bit value of type EXECUTION_STATE (see Windows.h).
<Continuous>

Indicates (TRUE) if the process requested the execution state change to be continuous (ES_CONTINUOUS) or not (FALSE).
<System>

Indicates (TRUE) if the process requested the system to be available (ES_SYSTEM_REQUIRED) or not (FALSE).
<Display>

Indicates (TRUE) if the process requested the display to be available (ES_DISPLAY_REQUIRED) or not (FALSE).
<AwayMode>

Indicates (TRUE) if the process requested away mode to be enabled (ES_AWAYMODE_REQUIRED) or not (FALSE).

PwrTest Syntax