HDXWatcher and PCOIPWatcher – Realtime, easy virtual desktop traffic reporting.

logoWhen checking the bandwidth requirement of multimedia sites, checking how much additional bandwidth video conferencing is going to require or even troubleshooting WAN capacity issues, it’s extremely useful to have a visible interpretation of realtime bandwidth consumption from your virtual desktop.

I wrote a tool quite some time ago called watcher2 while troubleshooting a similar issue. I finally took the time to refactor that tool for use with XenApp 6.5 , XenDesktop and VMware View and they are finally available to download! Both watcher utilities also include a latency counter which was a request that came in over and over.

HDX and PCOIP watcher by default dock to the top of the screen and can be moved left or right as below:

hdx watcher docked

pcoip watcher docked

They can now also be completely un docked:

hdx watcher

pcoip watcher undocked

How do they work?

The tool finds your username in the performance monitor counters for session bandwidth, once it finds this entry it reads your performance monitor data once every second and reports on it.

In the case of PCOIP watcher, it reads the PCOIP counters from performance monitor.

what do the values mean?

All values are in either Kilobits per second or Megabits per second.

In = Traffic from the client to the virtual, this may spike during large copy / paste jobs,web cams or copying data from a usb key to the session:
Out = Traffic from the virtual desktop to the client, mainly audio or video traffic causes this to spike.
Latency = The delay between your client and the virtual desktop.

Can I Configure it?

Two thresholds are available, a yellow warning and a red warning, currently . These default values can be written to:


Dword: YellowWarning = 300 (decimal)

Dword: RedWarning = 600 (decimal)

Do they have any dependencies?

.net framework 3.5

if you are running XenApp 6.5 or XenDesktop 5.6, ensure you have the latest hot-fixes installed or the counters may be incorrect.

How do I launch it?

Allow the user to run it manually, or place the executable in their start-up folder or login script.

Where Can I download it?


What’s coming next:

  • Native Microsoft RDP Counters.
  • Realtime graphs and recording.
  • source code is available on request.

Related Posts

UnSticking an AppDisk provisioning task in XenDesk... Here's a wee little bug I've no idea how i created, but managed to clear it out anyway. After creating an AppDisk, it got a little stuck. I tried d...
Creating an automated VMware Horizon RDS Pool with...   So VMware Horizon 6.2 was announced at VMworld just a week ago and the one feature I sorely wanted to see was automated provisioning (golden...
New Free Tool: Citrix Director Notification Servic... Citrix Director for XenApp and XenDesktop can be a great utility for information about your Application / Desktop virtualisation environment. In Direc...

19 Comments About “HDXWatcher and PCOIPWatcher – Realtime, easy virtual desktop traffic reporting.

  1. GeertC

    Hi, I’m having some problem with HDXWatcher.
    When I start it in XenApp 6.5 desktop session I get these 2 popups

    Exception in getusercounter: Category does not exist.
    A HDX session was not detected, HDXWatcher will now close.

    Do I need to configure something to enable HDX?

      1. Marc Trotter

        I’m seeing the same error, tried running it from two different machines. Thought I’d volunteer that .Net Framework 4.5 is installed don’t know if that plays a part?

      2. Marc Trotter

        Yes, definitely within an ICA session, does the fact that we’ve enabled Session Reliability play a part, in other words port 2598 is leveraged not 1494?

  2. Alan Osborne

    Thanks Andrew! There used to be a Latency Checker application for CPS 4/5 and I’ve been looking for a simple utility like this for a couple of years now. I second the request for a latency threshold, since I will use this app to demonstrate to clients when “laggyness” in their session is due to network latency. Yellow/red color indicators will make things that much simpler.

  3. Brian King

    Hi Andrew,

    I have a home user that when running the Watcher on the Xendesktop shows 934 MS latency and than a message “disconnect detected” is that message triggered from the high latency number or something else?. The user is on a high speed cable connection so I find it odd.

  4. Christiaan

    Great tool Andrew. Interested to hear if it is possible to have it modified so it can maybe run in the taskbar of the user session and then give a red/amber/green light status depending on parameters we can set for latency? Even better if it can also do a small baloon pop-up to prompt user to know they are not on a good connection and may need to expect degraded performance…In essence something very simple to set end-user expectations on session performance…

  5. Shiv

    Hello Andy,

    When do I run it? I am running it in my published application server and I am getting below.

    “A HDX Session was not detected, HDXWatcher will close now.”

    In the system, 10 users were logged it at that time.



Leave a Reply