How to: Examine Cache Performance for an Application-Tier Server

  • Article

As a Team Foundation Server administrator, you might want to examine the performance of the source control cache on the Team Foundation application-tier server. By default, performance counters are installed, and you can view statistics for these counters in the Performance monitor or by using the ProxyStatistics Web service. For example, you can view the following performance counters:

  • Current cache size

  • Total cache hits

  • Total download requests

  • Total files in cache

These statistics are regularly saved to an XML file named ProxyStatistics.xml. You can also change the period of time for these intervals. For more information, see How to: Change Cache Settings for an Application-Tier Server.

Required Permissions

To perform this procedure using Perfmon.exe, you must be at least a member of the Performance Monitor Users security group on the Team Foundation application-tier server.

To perform this procedure using the ProxyStatistics Web service, you must be a member of the local Administrators security group on the Team Foundation application-tier server.

To view cache performance on the Team Foundation application-tier server by using Perfmon.exe

  1. Click Start, point to Administrative Tools, and then click Performance.

    - or -

    Open a Command Prompt window, and at the command prompt, type perfmon.

    The Performance monitor appears.

  2. In the left pane, expand Console Root, and then click System Monitor.

    The system monitor appears in the right pane.

  3. Right-click the system monitor pane and then click Add Counters.

  4. In the Add Counters dialog box, click Select counters from computer.

  5. In the Select counters from computer box, make sure that the name of the Team Foundation application-tier server is displayed. Otherwise, type or select the name of the Team Foundation application-tier server.

  6. In the Performance object box, select TFS Proxy Server.

    In the Select counters from list box, the performance counters for this performance object are displayed.

  7. Select one of the following:

    • To select all counters, click All counters, click Add, and then click Close.

    • To select individual counters, click Select counters from list, select the counters you want to add, click Add, and then click Close.

      Tip

      To select a continuous range of counters, press and hold the SHIFT key when you select the first and last counter in the range. To select a discontinuous range, press and hold the CTRL key when you select each counter.

    In the system monitor pane, the performance counters for the cache are added to the System Monitor window.

To view cache performance on the Team Foundation application-tier server by using the ProxyStatistics Web service

  1. On the Team Foundation application-tier server, open Internet Explorer and locate the following URL:

    https://localhost:8080/VersionControl/v1.0/proxystatistics.asmx

    The Web page for the ProxyStatistics Web service and its operations is displayed.

  2. Click QueryProxyStatistics to view information about the operation.

  3. Click Invoke to display an XML file that contains performance counter statistics.

    Note

    You can call the QueryProxyStatistics operation only from the local computer on which the application-tier is installed.

  4. Locate the <ProxyStatisticsInfo> element that contains these statistics.

    For example, some sample output might look like the following:

    <ProxyStatisticsInfo CurrentCacheSize="356352" NoOfRequests="82" OverallCacheHits="41" NoOfFilesInCache="41" OverallCacheMisses="41" CacheHitsPercentage="50" CacheMissPercentage="50" ServerId="643c23c1-3f47-43d2-b638-3bd0e7ea8bff" ServerUrl="https://TeamFoundationServerName:8080/VersionControl" />

    Note

    The following statistics are calculated at run time: OverallCacheMisses, CacheHitsPercentage, and CacheMissPercentage.

See Also

Tasks

How to: Enable Source Control Caching for Team Foundation Server Proxy

Concepts

Team Foundation Server Proxy and Source Control
Managing Team Foundation Server Application-Tier Servers