Remote Performance Monitor (Compact 2013)

3/26/2014

The Performance Monitor remote tool is a graphical tool for measuring the performance of a Windows Embedded Compact–based OS design. Performance Monitor provides the ability to track current activity on a target device and the ability to view data from a log file.

By using the tool, you can observe the behavior of performance objects such as CPUs, threads, processes, and system memory. Each performance object has an associated set of performance counters that provide information about device usage, queue lengths, and delays, and information used to measure throughput and internal congestion.

You can access Performance Monitor from Windows Embedded Compact, or you can access Performance Monitor from the Windows Start menu.

To use Performance Monitor from Windows Embedded Compact, you must first connect to the target device.

After you connect to the target device, you can display performance counters from the target device in the Performance Monitor window. For more information, see the Adding an Object, Counter, or Instance to a Chart section in this topic.

Performance Objects

Performance Monitor supports the following performance objects:

• Remote Access Server
• Internet Control Message Protocol (ICMP)
• TCP
• IP
• User Datagram Protocol (UDP)
• Memory
• Battery
• System
• Process
• Thread

Each Performance Monitor object has two parts, explained in the following table.

Part	Description
Device-side collector	Collects data on the target device.
Performance Monitor Extension DLL	Queries the device-side collector for performance data. The data is transferred to the development workstation over Platform Manager; then it is formatted and displayed in the Performance Monitor user interface (UI).

Observation Modes

Performance Monitor supports the following four modes for observing performance data.

View	Description
Chart	Enables you to monitor data in real time.
Alert	Notifies you when specified conditions occur on the remote system.
Log	Logs data to be viewed at a later time.
Report	Displays data in plain text.

Chart View

The Remote Performance Monitor supports a Chart view that allows you to monitor performance in real time. By using the tool, you can observe the behavior of performance objects such as CPUs, threads, processes, and system memory.

The Chart View window allows you to select categories of statistics you want to monitor, and to select the type of chart you want displayed. When you choose a category, the Remote Performance Monitor tool automatically updates the available options in that category.

Adding an Object, Counter, or Instance to a Chart

You can choose the process instance of performance monitoring and choose the type of statistics the tool gathers.

To add an object to a chart

1. Create a new chart, or open an existing chart from the File menu.

2. On the Edit menu, click Add To Chart.

3. In the Object box, choose a category of statistics.

   When you choose a category, the Counter and Instance lists update to display the available items on the target device for the chosen category.

4. In the Counter list, select one or more counters.

   To select multiple counters, press the CTRL key while you select counters.

   To see a definition of the selected counter, in the Counter Definition box, click Explain.

5. If applicable, in the Instance list, select one or more instances.

6. Select a line color, plot scale, line width, and line style setting, and then click Add.

7. Repeat the previous four steps for additional counters that you want to monitor, and then click Done.

8. To save your chart selections in a settings file, on the File menu, click Save Chart Settings As.

Alert View

The Alert View window in Remote Performance Monitor notifies you when specific alert conditions occur in the remote system.

In addition, the Remote Performance Monitor tool allows you to set parameters that signal which alerts are monitored. For example, you can designate a specific instance that the tool watches, and designate whether you want to be alerted when the object exceeds a certain value.

You can also specify a macro or function to run when the alert condition is triggered.

Modifying Alert Options

You can customize the way the Alert log selects and monitors conditions.

To modify alert options

1. On the Options menu, choose Alert.

2. To configure Performance Monitor to display the Alert view when an alert occurs, select the Switch To Alert View check box.

   -or-

   To configure Performance Monitor to remain in the current view when an alert occurs, clear the Switch To Alert View check box.

3. To configure Performance Monitor to record each alert in a log file, select the Log Event In Application Log check box.

   -or-

   To configure Performance Monitor to display each alert in Alert view only, clear the Log Event In Application Log check box.

4. To configure Performance Monitor to send a network message when an alert occurs, select the Send network message check box.

5. Optional. If you select the Send network message check box, in the Net Name box, type the network name of the alert recipient's device, without backslashes (\\).

6. In the Update Time area, select Manual Update or Periodic Update.

7. Optional. If you choose Periodic Update, in the Interval box, type a number to specify the time, in seconds, between updates.

8. Click OK.

You can designate the conditions for which Remote Performance Monitor notifies you.

To add an object, counter, or instance to an alert log

1. On the Edit menu, click Add To Alert.

2. In the Object box, select a category of statistics.

3. In the Counter list, select one or more counters.

   To select multiple counters, press the CTRL key while you select counters.

   Click Explain to display a definition of the selected counter.

4. If applicable, from the Instance list, select one or more instances.

5. In the Alert If area, select Over or Under, and then in the box, type the value at which you want Remote Performance Monitor to generate an alert.

6. In the Run Program On Alert area, type the path and file name for the application or macro that you want to run when the specified alert occurs, and then click Add.

7. To run the application or macro every time the alert occurs, select Every Time.

   -or-

   To run the application or macro only the first time the alert occurs, select First Time.

8. Repeat the previous six steps for each alert that you want to add, and then click Done.

Log View

The Log View window in Remote Performance Monitor records data to a log for viewing at a later time.

You can select the type of data logged and the frequency of logging. In addition, you can save the log settings and content in a file.

To view the Log View window, on the View menu, click Log.

If you switch from another view, the Log View window is blank unless you already created or opened a log file during your session or from the command prompt.

Create a log file

1. On the File menu, click New Log Settings.

2. On the Edit menu, choose Add To Log.

3. In the Objects box, select an object or set of objects to monitor, and then click Add.

4. Repeat the previous step for additional devices that you want to monitor, and then click Done.

5. On the File menu, click Save Log Settings As.

   Navigate to the directory where you want to store the settings file. In the File name box, type the name of the file, and then click OK.

You can start or stop logging at any time.

To start or stop logging

1. On the Options menu, click Log.

2. If Start Log is not enabled, type a name in the File Name box, and then add objects to the log.

   -or-

   If Start Log is enabled, select Start Log.

3. To stop logging, select Stop Log.

Report View

The Report View window displays data in plain text.

You can control what the tool reports, and how often it generates reports. You can also save the reports.

To view the Report View window, on the View menu, click Report.

To use the Report view window

1. Open an existing report settings file by clicking File, clicking Open, and then navigating to the .pmr file that you want to use.

   -or-

   Create a new report settings file by clicking File, and then clicking New.

2. Add the items that you would like to monitor to the settings file.

   1. On the Edit menu, click Add to Report.
   2. In the Object window, select an object to monitor from the list.
   3. In the Counter window, select one or more counters.
   4. If applicable, in the Instance box, select one or more instances.
   5. Click OK.
      Repeat the previous five steps for additional objects or devices you want to monitor, and then click Done.

See Also

Other Resources

Remote Tools