Deploying Skype for Business Server, Real-Time Statistics Manager

StatsMan is a dashboard solution for viewing KHI calculations in real-time as well as graphed performance counters aggregated across your infrastructure. The dashboard can be used to pinpoint ongoing performance issues, view the results of a planned change to your environment, track resolution of outages, and much more. Out of the box, it is configured with KHI thresholds from the KHI Resources, and can be customized to suit your deployment’s unique needs.

Deployment:

To deploy Statistics Manager, follow these steps:

  1. Prepare the Listener host machine by installing the Redis in-memory caching system, and by ensuring that you have installed the appropriate certificates.
  2. Install the Listener service on the host machine.
  3. Install the Website on the host machine.
  4. Install an Agent on each Skype for Business Server machine you wish to monitor.
  5. Import the topology for the servers you are monitoring.

How-To Guide:

Please note that the following guidelines are based on the Microsoft documentation that can be found here and before deploying it in your production environment please take some time to plan it carefully for capacity and performance purposes.

Installing the Redis in-memory caching system

image

image

image

  • Make sure during the setup to uncheck the FW exception rule

image

image

image

image

image

Install the Listener service:

  • Install the Listener service on the host machine by running the StatsManPerfAgentListener.msi

image

  • Review the License Agreement, and if you agree, select I accept the terms in the license agreement, and then click Next.

image

  • Service Password: This is the password the remote Agents will use to authenticate to the Listener service.
  • Service Port: This is the HTTPS port number that the Listener will use to communicate with the Agents. During installation, this port will be allowed through the local firewall, a URL ACL will be created, and an SSL cert will be bound to this port. The default is 8443.
  • Certificate Thumbprint: This is the certificate thumbprint the Listener will use to encrypt the HTTPS protocol. Network Service must have read access to the private key.
  • Click the Select… button to choose the thumbprint.
  • Install Dir: This is the directory on which the binaries will be installed. You may change it from the default by using the Browse… button.
  • AppData Dir: This is the directory where the Logs folder and other data will be stored. You may change it from the default. It will not be deleted on uninstall.

image

image

image

image

Install the Website:

  • Install the Website on the host machine by running the StatsManWebSite.msi and specifying the following:

image

image

  • Service Port: This is the port number the web site will listen on. You can change it later by using IIS manager binding. During installation, this port will be allowed through the local firewall.
  • Install Dir: This is the directory where the binaries will be installed. You may change it from the default by using the Browse… button.
  • AppData Dir: This is the directory where the Logs folder and other data will be stored. You may change it from the default. It will not be deleted on uninstall.

image

image

image

Install the Agents:

  • Install an Agent on each Skype for Business Server that you wish to monitor by running the StatsManPerfAgent.msi

image

image

  • Make sure you have the Certificate thumbprint that we used during during the Listener Service Deployment in the previous steps.
    You can get the certificate thumbprint by running the following command:

image

  • Service Password: This is the password the remote agent will use to authenticate to the Listener service.
  • Service URI: This is the URI where the Listener resides. It should use the https://name:port format.
  • You can use a NETBIOS name or a FQDN. You can use the name that is also specified as the Subject or Subject Alternative Names of the certificate on the Listener service, but this is not a requirement.
  • Service Thumbprint: This is the thumbprint of the SSL certificate the Listener is using. The Agent will use this thumbprint to authenticate to the Listener. (It will not do full certificate validation because it is possible to use self-signed certificates.)
  • Install Dir: This is the directory on which the binaries will be installed. You may change it from the default by using the Browse… button.
  • AppData Dir: This is the directory where the Logs folder and the encrypted password.txt file will be stored. You may thanks change it from the default. It will not be deleted on uninstall.

image

image

Import Topology

After Statistics Manager is installed and running, you need to import the Skype for Business Server topology so that Statistics Manager knows the Site, Pool, and Role of each server. To import your Skype for Business Server topology, you will use the Get-CsPool cmdlet to retrieve information about each pool in use in your organization, then import this information into Statistics Manager.

  • On a host that has the Skype for Business Server PowerShell cmdlets run the following command and then Copy the “mypoolinfo.xml” file to the server that runs the Listener.

image

  • On the host that runs the Listener run powershell and Navigate to the directory on which the Listener is installed.

  • To confirm which servers are being added and updated, run the following command:

image

Connecting the Web Service:

  • From any server within your network, access the Web Server URL: http://localhost:webport>/
  • If you get the following error message, give it a couple of minute to gain some listener details and send the details to the liseter server.

image

  • After couple of minutes you’ll be able to start watching your environment statistics, for instance the KHI Charts default view:

image

  • Landscape View:

image

  • Per-Counter View:

image

8 Comments

  1. Pingback: Weekly IT Newsletter – October 19-23, 2015 | Just a Lync Guy

  2. Justin Davies

    Receiving this error when opening the web site http://localhost:webport/ after completing the installs for Redis and Statistics manager (before instaling the agent). “Error 1 – Failed to load config file – dashconfig.json”
    Any thoughts as to what it could be?

    Reply
    1. Guy Bachar (Post author)

      Are you just getting IIS error or are you able to see the actual site?
      What server version are you using?

      Reply
  3. Pingback: More fun with Skype for Business Real-Time Statistics Manager (StatsMan) | JC's Blog-O-Gibberish

  4. Mohit

    Hi,

    We have deployed Statistics Manager for Skype4B few days back.When we open the http portal its only showing data for last 24 hours. We also tried applying Time range filters but they are not working.

    Any idea is this by design or some tweaks can fix it?

    Thanks,

    Mohit

    Reply
    1. Guy Bachar (Post author)

      On the databases you see data from the last 24 hours as well?

      Reply
  5. Erdal Kahraman

    Hi, we have deployed Statistics Manager https://three65.blog/2015/10/23/skype-for-business-statistics-manager-installation-guide/ and everything works fine except the landscape view. If we switch from Default View to KHI Landscape View, we see a empty page (blank).

    Any idea what that might be??

    Thanks, Erdal

    Reply
  6. Matt Freestone

    So, I’ve had this deployed for a while now, but I can’t seem to find out how to add additional users to be able to login to statistics manager? How do you manage access?

    Reply

Leave a Comment

Your email address will not be published. Required fields are marked *