How to Use Remote Performance Monitor to Observe Performance

  • Article

You can use the Remote Performance Monitor tool to display statistics that describe the performance of a target device in real time. Remote Performance Monitor can provide information about resource use, queue lengths, and delays, and can measure throughput and internal congestion. You can also configure the Remote 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.

To track your progress in the following table, select the check box next to each step.

  Step Topic
1. Open an existing platform, or create a new platform. Creating a Platform
2. If you have not built your platform, build the platform. Building a Platform
3. Establish a hardware connection between your development workstation and the target device, and then configure Platform Builder to download the OS image to the target device over the established connection.
  • If your target device is a CEPC, you must boot an OS image on the CEPC.

  • If your target device is custom hardware, you can use the steps for booting an OS image on a CEPC as a model for establishing a connection to your custom hardware.

    For more information, see How to Configure a CEPC to Download an OS Image.

  • If your target device is the Emulator, you must download your OS image to the Emulator.

    For more information, see Downloading an OS Image to the Emulator.

 Configuring a Connection for Downloading and Debugging
4. Download the OS image to the target device. Downloading an OS Image to a Target Device
5. Open the Remote Performance Monitor tool, and then configure the connection from the tool to the target device.

When you configure the connection, perform the following steps:

  • In the Transport box, choose KITL Transport for Windows CE, Configure, and then in the Named connection box, choose the named connection that you used in the Platform Builder IDE to connect to the target device.
  • In the Startup Server box, choose CESH Server for Windows CE, Configure, and then choose Directory containing last image booted by Platform Builder.
 Configuring the Connection to a Target Device Using Platform Manager
6. Connect the Remote Performance Monitor tool to the target device. Connecting to a Target Device with a Remote Tool
7. Open the Chart view window, which Remote Performance Monitor uses to display data from the target device in real time. Opening the Chart View Window
8. Configure the Chart view window to display one or more statistics of your choosing from the target device.

For example, to display memory use as a percentage of total memory, 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
9. 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
10. If you are not satisfied with the appearance or behavior of the chart itself, modify the appearance or behavior of the chart. Modifying Chart Options
11. 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
12. Configure the Alert view window to notify you when one or more conditions occur on the target device.

For example, to make Remote Performance Monitor notify you when memory use on the target device exceeds a specified percentage of total memory, in the Object box, choose CE Memory Statistics, and then from the Counter list, choose Memory Load. In the Alert If area, choose Over, and then in the box type the percentage of memory use at which you want to be notified.

 Adding an Object, Counter, and Instance to an Alert Log
13. After you add an alert, if you are not satisfied with the color of the alert, or if you want to change the value at which Remote Performance Monitor notifies you of the alert, modify the alert. Changing the Appearance of a Counter in the Alert Log
14. Verify that Remote Performance Monitor responds to an alert in the way that you want. Modifying Alert Options
15. Return to the Chart view window. Opening the Chart View Window
16. Perform actions on the target device, and observe the response of the chosen statistic or statistics in the Chart view window.

For example, if you chose to observe memory use on the target device, run an application on the target device and observe how your action affects memory use.

In the Chart view window, you should see the value of the statistic or statistics change when you perform an action on the target device.

If, at some point in time, the conditions on the target device satisfy the conditions that you specified in the Alert view window, Remote Performance Monitor should display an alert in the way that you specified in the alert options.

 Not applicable.

See Also

Platform Development How-to Topics | Remote Performance Monitor

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.