uberAgent

Disable ESA While Keeping Director Integration

Symptom

uberAgent is still evaluating ESA-related metrics on your VDAs although you’ve set EnableESA to false in your uberAgent.conf, and you are running Citrix Virtual Apps and Desktops 2503 or later.

Cause

Starting with Citrix Virtual Apps and Desktops 2503, uberAgent integrates with Citrix Director to enable enhanced monitoring capabilities. The Director integration requires a subset of ESA metrics. Therefore, ESA is enabled by Director even when you’ve set EnableESA to false in your uberAgent.conf.

Resolution

To keep Director functionality while preventing ESA data from being sent to your backend (for example, Splunk), do the following:

  1. Remove the @ConfigInclude uberAgent-ESA.conf line from your uberAgent.conf.
  2. Add the following Event Data Filter to your uberAgent.conf to block remaining ESA data:
# Exclude all ESA metrics
[EventDataFilter]
Action = deny
Sourcetype = ActivityMonitoring:ProcessTagging
Sourcetype = Process:DnsQuery
Sourcetype = System:ScheduledTaskActions
Sourcetype = System:ScheduledTaskTriggers
Sourcetype = System:ScheduledTasks
Sourcetype = Process:ProcessStop
Sourcetype = System:WinEvtLogForwarding
Sourcetype = System:SecurityInventory
Query = true
<!--NeedCopy-->

After applying the filter, save your uberAgent.conf and restart the uberAgent service. ESA data should no longer appear in your backend while Director functionality remains available.

For more details, see Event Data Filtering.

Disable ESA While Keeping Director Integration