# Configuration guide: Citrix DaaS essentials

{% hint style="warning" %}
The configuration options on this page are only accessible to [administrators](https://docs.nexthink.com/platform/user-guide/administration/account-management/roles#roles-administration).

Refer to the [Usage guide: Citrix DaaS essentials](/platform/library-packs/vdi/citrix/citrix-daas-essentials/usage-guide-citrix-daas-essentials.md) to use library content as a standard user.
{% endhint %}

## **Prerequisites** <a href="#documentation-pre-requisites" id="documentation-pre-requisites"></a>

This library pack contains content from the following required [expansion products](/platform/overview/products.md#products-vdiexperience):

* [Nexthink VDI Experience](/platform/user-guide/vdi-experience.md).

{% hint style="info" %}
Some of these products offer default access to their respective content and can still be used without [expansion products](https://docs.nexthink.com/platform/overview/products).

Refer to the [Nexthink Infinity thresholds and limits overview](https://edocs.nexthink.com/nexthink-infinity/infinity-specifications/nexthink-infinity-default-thresholds-overview) documentation for more information about default thresholds for expansion products.
{% endhint %}

## **Included content and dependencies** <a href="#documentation-contentanddependencies" id="documentation-contentanddependencies"></a>

This library pack contains the following content and dependencies:

<table><thead><tr><th width="145.6666259765625">Content type</th><th width="190">Name</th><th width="399.333251953125">Description</th></tr></thead><tbody><tr><td><a href="/pages/6vuxVatlaWj9nnvq568E">Dashboards</a></td><td>Citrix DaaS virtual machine monitoring</td><td>Monitor the health and availability of Citrix virtual machines by identifying performance issues, stale VMs, or registration failures that impact user experience.</td></tr><tr><td></td><td>Citrix DaaS infrastructure</td><td>Monitor the health and availability of Citrix cloud connector servers by identifying offline devices, stopped critical services, and performance or stability issues.</td></tr><tr><td></td><td>Citrix Client version inventory</td><td>Monitor the distribution, support status, and compliance of Citrix Workspace client versions across your environment. Identify devices running unsupported or non-compliant versions, assess user impact, and prioritize remediation to ensure alignment with vendor support and internal standards.</td></tr><tr><td><a href="/pages/lp4sWpFvm4tGjOSmmxVE">Applications</a></td><td>Citrix DaaS</td><td>This network application provides visibility into the connectivity and network usage of the Citrix DaaS on devices, helping to identify any issues with this application.</td></tr><tr><td></td><td>Citrix Workspace client</td><td>This hybrid Web/desktop application provides visibility into the usage, performance, and stability of the Citrix Workspace client on devices, helping to identify issues with the application.</td></tr><tr><td><a href="/pages/WARqMvlgdoZvTGg987Gh">Monitors</a></td><td>High percentage of disconnected sessions per desktop pool</td><td>Identifies frequent or unexpected drops.</td></tr><tr><td></td><td>High CPU usage per desktop pool</td><td>Flags potential performance bottlenecks.</td></tr><tr><td></td><td>High average latency per VDI client location</td><td>Highlights network-related delays by region.</td></tr><tr><td></td><td>High number of sessions per virtual machine</td><td>Prevents resource overutilization.</td></tr><tr><td></td><td>Citrix Workspace app - increasing ratio of non-compliant devices</td><td>Flags the trend of an increasing number of devices running a non-desired version of the Citrix Workspace agent.</td></tr><tr><td><a href="/pages/V6hU7KmSORMczQjEHhpZ">Remote actions</a></td><td>Invoke restart of session host</td><td>Restarts the host machine, by effectively restarting all user sessions.</td></tr><tr><td></td><td>Invoke update GPO computer policy</td><td>Refreshes Group Policy settings on the host machine by executing the gpupdate command at the system level.</td></tr><tr><td></td><td>Invoke update GPO user policy</td><td>Triggers a user-level Group Policy refresh for the currently logged-in user using the command gpupdate /target:user /force.</td></tr><tr><td></td><td>Invoke end process</td><td>Can be used to terminate a process which is running within a user session on a Windows device.</td></tr><tr><td></td><td>Log off VDI session</td><td>Logs off an active Virtual Desktop Infrastructure (VDI) session on a Windows VDI.</td></tr><tr><td></td><td>Get Citrix VDA registration details</td><td>Retrieves essential details about the Citrix Virtual Delivery Agent (VDA), providing administrators with a clear overview of the VDA's connection to the Citrix environment.</td></tr><tr><td></td><td>Reset Citrix Workspace app</td><td>Performs a complete reset of the Citrix Workspace app on a Windows endpoint. It clears all user configurations, accounts, and cached data, restoring the application to its default state.</td></tr><tr><td></td><td>Get DaaS server status</td><td>Checks and reports the real-time status (Running / Stopped / Not Found) of crucial Cloud Connector services on Citrix DaaS servers.</td></tr><tr><td></td><td>Get Citrix Local Host Cache Status</td><td>Verifies the presence of critical High Availability (HA) database files required for Local Host Cache (LHC) functionality on a DaaS server.</td></tr><tr><td></td><td>Monitor Citrix Cloud Connector Events</td><td>Monitors the health of Citrix Cloud Connector by analyzing Windows event logs for predefined or custom topics.</td></tr><tr><td><a href="/pages/xnZyEzIlIuGaE2uNJRNG">Custom fields</a></td><td>Citrix reboot health</td><td>Indicates the reboot health of a device based on the 'Days since last reboot'</td></tr><tr><td></td><td>Citrix server role</td><td>This custom field tags binaries to specific Citrix server roles</td></tr><tr><td></td><td>Citrix cloud connector</td><td>This custom field identifies and tags devices as Citrix cloud connectors by detecting key Citrix binaries running on the server</td></tr><tr><td></td><td>Citrix Workspace desired versions</td><td>This custom field specifies the desired versions of the Citrix Workspace agent according to your organization's policies. It is meant to be customized for each organization to reflect its Citrix Workspace compliance policy.</td></tr><tr><td></td><td>Citrix Workspace non-desired versions</td><td>This custom field specifies the non-desired versions of the Citrix Workspace agent according to your organization's policies. It is meant to be customized for each organization to reflect its Citrix Workspace compliance policy.</td></tr></tbody></table>

## Configuring Citrix DaaS essentials

{% hint style="info" %}
Adapt these suggested configuration steps to edit and customize content according to your organizational needs.
{% endhint %}

Follow these steps to install and configure content:

* Before configuration - Install library pack content from [Nexthink Library](https://docs.nexthink.com/platform/user-guide/nexthink-library)
* [Step 1 - Configure remote actions](#configuring-remote-action-s)
* [Step 2 - ](#documentation-step3-editcampaigns)[Configure monitors](#step-2-configure-monitors)
* [Step 3 - Configure custom fields](#step-3-configure-custom-fields)

### **Step 1 - Configure remote actions**

1. From the main menu, navigate to the **Remote Actions** > [Manage remote action ](https://docs.nexthink.com/platform/user-guide/remote-actions/managing-remote-actions)page.
2. Review and edit your remote actions.

Nexthink recommends the following configurations for these remote actions:

<table><thead><tr><th>Name</th><th>Trigger Schedule</th><th>Parameters to edit</th></tr></thead><tbody><tr><td>Invoke restart of session host</td><td>Triggered on demand to resolve issues</td><td></td></tr><tr><td>Invoke update GPO computer policy</td><td>Triggered on demand to resolve issues</td><td></td></tr><tr><td>Invoke update GPO user policy</td><td>Triggered on demand to resolve issues</td><td></td></tr><tr><td>Invoke end process</td><td>Triggered on demand to resolve issues</td><td></td></tr><tr><td>Log off VDI session</td><td>Triggered on demand to resolve issues</td><td></td></tr><tr><td>Get Citrix VDA registration details</td><td>Scheduled locally on VMs</td><td><pre><code>devices | where virtualization.desktop_broker in [ citrix_daas ]
</code></pre></td></tr><tr><td>Get DaaS server status</td><td>Scheduled locally to run on the cloud connector servers at 10 minutes frequency.</td><td><pre class="language-nql_/apigateway/nql-editor"><code class="lang-nql_/apigateway/nql-editor">devices 
| where name = "CITRIX_SERVER_NAME"
</code></pre></td></tr><tr><td>Monitor Citrix Cloud Connector events</td><td>Scheduled locally to run on the Cloud Connector servers.<br>The recommended frequency is hourly or more often.</td><td><pre class="language-nql_/apigateway/nql-editor"><code class="lang-nql_/apigateway/nql-editor">devices
| where citrix_cloud_connector > 0
</code></pre></td></tr><tr><td>Reset Citrix Workspace app</td><td>Triggered on demand to resolve issues</td><td></td></tr><tr><td>Get Citrix Local Host Cache Status</td><td>Scheduled locally to run on the cloud connector servers at 10 minutes frequency.</td><td><pre class="language-nql_/apigateway/nql-editor"><code class="lang-nql_/apigateway/nql-editor">devices
| where name = "CITRIX_CLOUD_CONNECTOR_SERVER_NAME"
</code></pre></td></tr></tbody></table>

### Step 2 - Configure monitors

To install and (partially) configure content:

1. From the main menu, navigate to the **Alerts & Diagnostics** > [Manage alerts ](https://docs.nexthink.com/platform/user-guide/alerts-and-diagnostics/managing-alerts)page.
2. Review and edit your monitors.
3. For each monitor:
   * The **Scheduling frequency** cannot be modified, like many other configuration fields.
   * If required, set additional [Trigger conditions](https://docs.nexthink.com/platform/user-guide/alerts-and-diagnostics/managing-alerts/customizing-built-in-monitors#customizingbuilt-inmonitors-queryandconditions) and refine the VDI monitor thresholds within the monitor configuration page. Refer to the table below.
   * Additionally, customize [Filters](https://docs.nexthink.com/platform/user-guide/alerts-and-diagnostics/managing-alerts/customizing-built-in-monitors#customizingbuilt-inmonitors-filter), [Priority](https://docs.nexthink.com/platform/user-guide/alerts-and-diagnostics/managing-alerts/creating-custom-monitors#filling-in-the-general-tab), and [Notifications](https://docs.nexthink.com/platform/user-guide/alerts-and-diagnostics/managing-alerts/configuring-email-and-webhook-notifications-for-alerts) for each VDI monitor.

| Name                                                                 | Scheduling Frequency             | Trigger conditions to edit                                                                                                                                                         |
| -------------------------------------------------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **High average latency per VDI client location**                     | Real time                        | <ol><li>Average network latency<br>(Default - moderate increase)</li><li>Percentage of events with high latency<br>(Default >= 20%)</li></ol>                                      |
| **High CPU usage per desktop pool**                                  | <p>Real time<br></p>             | <ol><li>Average CPU queue length<br>(Default - moderate increase)</li><li>Percentage high queue length<br>(Default >= 20%)<br></li></ol>                                           |
| **High number of sessions per virtual machine**                      | <p>Scheduled, 15 minutes<br></p> | <p>Sessions per virtual machine<br>(Default >= 20)<br></p>                                                                                                                         |
| **High percentage of disconnected sessions per desktop pool**        | <p>Scheduled, 15 minutes<br></p> | <p>Percentage of disconnected sessions<br>(Default >= 40%)<br></p>                                                                                                                 |
| **Citrix Workspace app - increasing ratio of non-compliant devices** | Scheduled, 24 hours              | <ol><li>Percentage of devices running undesired Citrix Workspace agents<br>(Default >= 5%)</li><li>Number of devices running Citrix Workspace agents<br>(Default >= 10 )</li></ol> |

{% hint style="warning" %}
The "Monitor Citrix Cloud Connector Events" remote action comes preconfigured with relevant topics. Although it is possible to manually change these predefined topics, doing so may affect the logic of dashboard widgets that rely on this remote action.
{% endhint %}

### Step 3 - Configure custom fields

1. From the main menu, navigate to the **Administration** > [Custom fields ](https://nexthink.gitbook.io/opd/user-guide/administration/content-management/custom-fields-management)page.
2. Check and customize the rule criteria for each custom field.
3. Edit the NQL queries if necessary to suit your environment and reboot policies.
4. Nexthink recommends the following settings:

<table><thead><tr><th width="123.33331298828125">Name</th><th width="175.6666259765625">NQL ID</th><th width="147.33343505859375">Rule name</th><th width="102.6666259765625">Object</th><th width="239.6666259765625">NQL query</th></tr></thead><tbody><tr><td>Citrix reboot health</td><td>citrix_reboot_health</td><td>Good<br>Average<br>Poor</td><td>device</td><td><pre><code>devices | where virtualization.desktop_broker in [ citrix_cvad , citrix_daas ] and ((virtualization.type in [shared, pooled] and boot.days_since_last_full_boot &#x3C;= 1) or (virtualization.type in [personal] and boot.days_since_last_full_boot &#x3C;= 5))
</code></pre></td></tr><tr><td>Citrix server role</td><td>citrix_server_role</td><td>LicenseServer<br>CloudConnector<br>DesktopDeliveryController<br>StoreFront</td><td>binaries</td><td><pre class="language-nql_/apigateway/nql-editor"><code class="lang-nql_/apigateway/nql-editor">binaries
| where binary.name in ["ConfigSyncService.exe", "HighAvailabilityService.exe", "XaXdCloudProxy.exe"]
</code></pre></td></tr><tr><td>Citrix cloud connector</td><td>citrix_cloud_connector</td><td>Computed</td><td>device</td><td><pre class="language-nql_/apigateway/nql-editor"><code class="lang-nql_/apigateway/nql-editor">devices
| include execution.events
| where binary.name in ["ConfigSyncService.exe", "HighAvailabilityService.exe", "XaXdCloudProxy.exe"]
| compute count__ = countif(execution_duration > 0)
| list count__
</code></pre></td></tr><tr><td>Citrix Workspace desired versions</td><td>citrix_workspace_desired_versions</td><td>Computed</td><td>device</td><td><pre class="language-nql_/apigateway/nql-editor"><code class="lang-nql_/apigateway/nql-editor">devices
| include session.vdi_events during past 24h
| where client.app_version != null
    and device.virtualization.desktop_broker in [ citrix_cvad , citrix_daas ]
| where (
    (operating_system.platform == windows and (
        (client.app_version >= v25.11 and client.app_version &#x3C; v25.11.10)
        or (client.app_version >= v25.8.10 and client.app_version &#x3C; v25.9)
        or (client.app_version >= v25.7.1 and client.app_version &#x3C; v25.8)
    ))
    or
    (operating_system.platform == macos and (
        (client.app_version >= v25.8.10 and client.app_version &#x3C; v25.9)
        or (client.app_version >= v25.8 and client.app_version &#x3C; v25.8.10)
        or (client.app_version >= v25.5.10 and client.app_version &#x3C; v25.6)
    ))
)
| compute desired_versions_ = device.count()
| list desired_versions_
</code></pre></td></tr><tr><td>Citrix Workspace non-desired versions</td><td>citrix_workspace_non_desired_versions</td><td>Computed</td><td>device</td><td><pre><code>devices
| include session.vdi_events during past 24h
| where client.app_version != null
    and device.virtualization.desktop_broker in [ citrix_cvad , citrix_daas ]
| where (
    (operating_system.platform == windows and (
        client.app_version &#x3C; v25.7.1
        or (client.app_version >= v25.8 and client.app_version &#x3C; v25.8.10)
        or (client.app_version >= v25.9 and client.app_version &#x3C; v25.11)
        or client.app_version >= v25.11.10
    ))
    or
    (operating_system.platform == macos and (
        client.app_version &#x3C; v25.5.10
        or (client.app_version >= v25.6 and client.app_version &#x3C; v25.8)
        or client.app_version >= v25.9
    ))
)
| compute non_compliant_versions_ = device.count()
| list non_compliant_versions_
</code></pre></td></tr></tbody></table>

***

RELATED TOPICS

* ​[Citrix DaaS essentials​](/platform/library-packs/vdi/citrix/citrix-daas-essentials.md)
* [Usage guide: Citrix DaaS essentials](/platform/library-packs/vdi/citrix/citrix-daas-essentials/usage-guide-citrix-daas-essentials.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexthink.com/platform/library-packs/vdi/citrix/citrix-daas-essentials/configuration-guide-citrix-daas-essentials.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.