How to use Lync Key Health Indicators

Update: October 17 – Two great scripts were recently released to the Technet Gallery to ease the process of KHI import data into Excel:

1) Lync KHI Importer by wilfried van oosterhout

2) Lync KHI Summarizer by Chris Lehr

Back in February, Microsoft released guidance on Lync KHI (Key Health Indicators):

Key Health Indicators are performance counters with thresholds aimed at revealing user experience issues. Gathering KHI data is usually the first step to implementing the Call Quality Methodology (CQM), which is focused on ensuring a quality audio experience for Lync users.

KHIs are used in addition to standard Lync Monitoring Solutions (e.g. System Center Operations Manager, Synthetic Transactions, Monitoring Server) and not instead of those solutions.

Collect the KHI performance counters and populate the KHI spreadsheet accompanying the Networking Guide to produce a scorecard that will help you determine the server health of a Lync deployment. Once populated, it guides you in repairing the environment and gives additional insight to other stakeholders. Evaluate KHIs on a monthly basis and incorporate them into any deployment’s ongoing operational processes.

In order to start collecting those KHIs and running the counters, use the following steps:

  1. Download the Lync Server Networking Guide to see the full list of KHIs and to get the related spreadsheets.
  2. Within the downloaded file, extract the two KHIs related files:

    1. Create_KHI_Collection.ps1
    2. Lync_Server_2013_Key_Health_Indicators.xlsx
  3. Copy the Create_KHI_Collection.ps1 to every Lync server you would like to monitor and run the script in PowerShell with Administrator rights:
  4. Running the script will create a New Data Collector Set named KHI under the User Defined section in the Performance Monitor tool:
  5. This Data Collector set contain a list of all Performance Counters related to Lync which are required for the KHI Report:
  6. In order to run the KHI collector set, right click on KHI and choose Start or click on the start button on the top menu after selecting KHI:
  7. Once the data collector start it will generate a CSV file under the C:PerfLogs folder.
    This CSV file will contain all counters data and it will update the file every 15 seconds by default.
  8. The Data Collector should be started before the company business start and should be stopped at the end of that business day. Once you stop the data collector, copy the CSV file to a central location.
  9. Once all data was gathered in the CSV file, it needs to be open in Excel in order to summarize all results and copy them to the KHI report extracted in Stage 2: Lync_Server_2013_Key_Health_Indicators.xlsx.
  10. The First tab of the Excel report contain an example of how the report should look like after filling in the data gathered from the CSV file.
    Please note that currently copying the data and summarizing the AVG and MAXIMUM results involve in a manual process by using Excel or any 3rd party tool or script which can summarize the Performance Counters data. Microsoft are aware of that, and to my understanding they building a tool which will make this step automatically, though there isn’t any official release date yet.
  11. After using Performance Monitor to fill in the KHI spreadsheet, we need to compare the results to the recommended targets. The recommends settings can be found in one of the following:
    1. On every tab in the spreadsheet under the Healthy Range column
    2. On Microsoft web site Key Health Indicators

More Information:


  1. Pingback: Weekly IT Newsletter – May 26-30, 2014 | Just a Lync Guy

  2. turbomcp

    awesome stuff as always

  3. StartUp

    Please clarify your 8th point i.e. “The Data Collector should be started before the company business start and should be stopped at the end of that business day.” so does this mean I cant run it after deploying SFB environment fully?

Comments are closed.