Registering performance counters

Kentico EMS required

Features described on this page require the Kentico EMS license.

There are three ways to register performance counters for a Kentico instance in Windows.

Registering counters during the installation

In the Components step of the custom installer, select the Performance counters for Health Monitoring check box. The installer automatically registers the performance counters for the given instance of Kentico.

Installing Kentico with performance counters

Select the Windows services for Scheduler and Health Monitoring check boxto install the Kentico Scheduler and Kentico Health Monitor services. Installing these services can optimize the monitoring performance.

Registering and removing counters manually using the Windows service

To register performance counters manually:

  1. Navigate to the CMS\Bin folder of your Kentico project folder (typically C:\inetpub\wwwroot\Kentico\CMS\bin)
  2. Execute the HealthMonitoringService.exe file from the Windows command line with the following parameters:

HealthMonitoringService.exe /webpath=<disk path to web project root> /createcounters

To remove already existing performance counters, execute the HealthMonitoringService.exe file with the following parameters:

HealthMonitoringService.exe /webpath=<disk path to web project root> /deletecounters

Registering performance counters in Windows registry

Registration of performance counters is technically performed by adding specific keys to Windows registry. In the registry, these keys are located in HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services. The keys represent individual registered counter categories and have the same names as the respective registered counter categories.

When you delete the registry keys, you also remove the respective counter categories, which unregisters the counters.