Sometimes administrators need to know the usage of different versions of Citrix Workspace app or the platforms on which their Citrix Virtual Apps and Desktops sessions are running. The information can help them understand how customers are adopting various platforms and Workspace App versions and help them to make decisions on whether to upgrade to the latest versions or to understand whether Android or Windows or iOS is being used more.

Citrix gives you an easy way to extract this data so you can make those decisions and gather those insights.

Extract Data with OData Queries

With Citrix Monitor service, you can extract this data using specific OData queries. OData is generally used to get information straight from the monitoring database through customized queries. For example, if you want to know the number of virtual desktop or application sessions running on platforms such as Windows, Mac, or Android, you can run the following OData query:

https://{dc-host}/Citrix/Monitor/OData/v4/Data/Connections?$apply=groupby((ClientPlatform), aggregate(Id with countdistinct as Connections))
Your response will look like this:

As you can see, the number of connections on an Android device is 60; the number of connections on Windows is 278. You can use that information to infer that Windows is being used more than Mac or Android. And you can see that HTML5, where the session is launched on end user’s browser window itself, is also being used.

You can also get the number of sessions running on various Workspace app versions so you can determine whether customers are upgrading to latest version or still using older ones. Just run the following query:

https://{dc-host}/Citrix/Monitor/OData/v4/Data/Connections?$apply=groupby((ClientVersion), aggregate(Id with countdistinct as Connections))
The response below shows that the highest percentage of customers is using Workspace app version 18.9.1.1.

Check out the various OData queries available and how to use them here. You can also run the same OData queries on cloud deployments.


Citrix Tech Bytes – Created by Citrix Experts, made for Citrix Technologists! Learn from passionate Citrix Experts and gain technical insights into the latest Citrix Technologies.

Click here for more Tech Bytes and subscribe.

Want specific Tech Bytes? Let us know! tech-content-feedback@citrix.com.