How to Use Performance Monitor to Observe Performance

  • Article

Other versions of this page are also available for the following:

Windows Mobile SupportedWindows Embedded CE Supported

8/27/2008

You can use the Performance Monitor tool to display statistics that describe the performance of a target device in real time.

You can also use Performance Monitor for information about the following:

  • Resource use
  • Queue lengths
  • Delays
  • Throughput and internal congestion

You can also configure the Performance Monitor tool to alert you when the target device meets a specified condition.

Hardware and Software Assumptions

  • You are familiar with how to use remote tools. For more information, see Remote Tools.
  • If you are using a development workstation that runs Windows Vista, you are running Platform Builder for Windows Embedded CE 6.0 with administrator privileges.

Steps

Step Topic

1. Open an OS design, or use the wizard to select a design template and the initial components for the OS design.

After you create the OS design, choose Catalog Item View and make sure that it includes the required Catalog items. The OS design must include support for the following SYSGEN variables:

  • SYSGEN_SHELL
  • SYSGEN_RELFSD
  • SYSGEN_CPP_EH_AND_RTTI

If you want to use ActiveSync transport for the configured connection, the OS design must include support for ActiveSync. For more information, see ActiveSync OS Design Development.

If you want to use TCP/IP transport for the configured connection, the OS design must include support for TCP/IP. For more information, see TCP/IP OS Design Development.

Creating an OS Design with the Windows Embedded CE OS Design Wizard

2. Choose a Debug or Release configuration to target when Platform Builder builds the OS design into a run-time image.

To use the kernel debugger, make sure that support for the kernel debugger is enabled.

If you want to use KITL transport for the configured connection, make sure that you enable KITL in the run-time image.

Levels of Debugging Support

Building a Run-Time Image From a Debug Configuration

Building a Run-Time Image From a Release Configuration

3. If you have not built your run-time image, build the OS design into a run-time image.

Building a Run-Time Image

4. Establish a hardware connection between your development workstation and the target device; then configure Platform Builder to download the run-time image to the target device over the established connection.

  • If your target device is a CEPC, you must boot a run-time image on the CEPC.
  • If your target device is custom hardware, you can use the steps for booting a run-time image on a CEPC as a model for establishing a connection to your custom hardware.
    For more information, see How to Configure and Download a Run-Time Image to a CEPC.
  • If your target device is the Device Emulator, download your run-time image to the Device Emulator.

Configuring a Connection for Downloading and Debugging

5. Download the run-time image to the target device through the configured connection.

Wait until all modules are loaded onto the target device.

  • To ensure that Performance Monitor successfully connects to your run-time image, make sure that you download a run-time image from the local release directory for your OS design. The default location of the release directory for your OS design is %_WINCEROOT%\OSDesigns\%_TGTPROJ%\RelDir\%_TGTPLAT%\%_TGTCPUFAMILY%_Release. For information about the contents of the release directory, see Opening the Release Directory.

Downloading a Run-Time Image

6. Start the Performance Monitor tool.

  • In Platform Builder, on the Target menu, choose Remote Tools, and then choose Performance Monitor.

Not applicable

7. Connect the Performance Monitor tool to the target device.

When you configure the connection, perform the following additional steps:

  • In the Transport box, choose KITL Transport for Windows CE and then choose Configure.
  • In the Named connection box, choose the named connection you used in the Platform Builder IDE to connect to the target device.
  • In the Startup Server box, choose KITL Bootstrap Server.

Configuring the Connection to a Target Device Using Platform Manager

Troubleshooting a Connection to a Target Device That Uses Platform Manager

8. Open the Chart view window, which the Performance Monitor uses to display data from the target device in real time.

Opening the Chart View Window

9. Configure the Chart view window to display one or more statistics from the target device.

For example, to display memory use as a percentage of total memory, do the following.

  • In the Object box, choose CE Memory Statistics, and then, from the Counter list, choose Memory Load.

Adding an Object, Counter, or Instance to a Chart

10. After you add a statistic to the chart, if you are not satisfied with the appearance of the line that plots the statistic, change the appearance of the line.

Changing the Appearance of a Counter on a Chart

11. If you are not satisfied with the appearance or behavior of the chart, modify the appearance or behavior.

Modifying Chart Options

12. Open the Alert view window, which Remote Performance Monitor uses to notify you when specific condition occurs on the target device.

Viewing the Alert View Window

13. Configure the Alert view window to notify you when conditions occur on the target device.

For example, to enable Performance Monitor to notify you when memory use on the target device exceeds a specified percentage of total memory, do the following:

  • In the Object box, choose CE Memory Statistics.
  • From the Counter list, choose Memory Load.
  • In the Alert If area, choose Over; then in the box type the percentage of memory use at which you want to be notified.

Adding an Object, Counter, or Instance to an Alert Log

14. After you add an alert, if you are not satisfied with the color or if you want to change the value at which Performance Monitor notifies you of the alert, modify the alert.

Changing the Appearance of a Counter in the Alert Log

15. Verify that Performance Monitor responds to an alert in the way you want.

Modifying Alert Options

16. Return to the Chart view window.

Opening the Chart View Window

17. Perform actions on the target device and observe the response of chosen statistics in the Chart view window.

Not applicable.

See Also

Concepts

Tools for Performance Tuning
Performance Monitor

Other Resources

How-to Topics