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.
Select the Windows services for Scheduler and Health Monitoring check box to 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:
- Navigate to the CMS\Bin folder of your Kentico project folder (typically C:\inetpub\wwwroot\Kentico\CMS\bin)
- 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.