Monitoring requirements for Citrix probes
Please note that depending on the version of the Citrix software, the prerequisites and the available checkpoints are different.
Citrix XenApp and XenDestop version 7 and higher
| Citrix-XenApp-ConcurrentSessions | Collects the average number of concurrent Citrix sessions, and the number of disconnected sessions, over the time interval that should correspond to the monitoring frequency. Notifies when thresholds are exceeded (alert and critical) on the number of total sessions, on the number of disconnected sessions. ConfigurationXenApp OData and XenDesktop Web Service login account and password. |
| Citrix-XenApp-Session-Opening-avg
|
Collects the average Citrix login time and the number of logins, over the time interval that should match the monitoring frequency. Notifies when thresholds are exceeded (alert and critical) on the average logon duration. Configuration : identifier between [] specified in /etc/freetds.conf on the monitoring server, account and password of a user with access to the Citrix Director database, threshold for going to alert state, threshold for going to critical state. |
| Citrix-XenApp-Session-Opening-Max
|
Collects the maximum Citrix login duration and the number of logins, over the time interval that should match the monitoring frequency. Notifies when thresholds are exceeded (alert and critical) on average logon duration. Configuration : identifier between [] specified in /etc/freetds.conf on the monitoring server, account and password of a user with access to the Citrix Director database, threshold for going to alert state, threshold for going to critical state. |
Citrix v7.x plugins require the Kerberos5 package to be installed.
KDC = Key distribution center => the central authentication server => Active directory.
Citrix monitoring involves authentication to a Web Service using an AD account and the Kerberos protocol.
The SNB (ServiceNav Box) must first retrieve the authorization on the KDC in order to authenticate itself on the webservice. To do this, it is necessary to search for a ticket on the KDC: this is handled automatically by the Citrix plug-in. Nevertheless, a manual setting is necessary on the box.
On the Citrix installation side, you need to be able to access the APIs. You can check their access with the following url :
http:///Citrix/Monitor/OData/v1/Methods
Configuration:
Connect to the ServiceNav Box.
Configure the file /etc/krb5.conf :
nano /etc/krb5.conf
In the [libdefaults] section: Change the default domain:
default_realm = DOMAIN
For example: default_realm = COSERVIT
In the [realms] section: Add a configuration line for the domain:
DOMAIN = {
Kdc = @IP_KDC(server AD)
}
For example:
COSERVIT = {
kdc = 192.168.1.250
}
Citrix XenApp and XenDesktop version 5.5, 6.0 and 6.5
Configuration :
- Windows Account - Admin: user ID, password and domain (optional) for a user with remote WMI read access
- warning level
- critical threshold.
| Citrix-XenApp-Counter-ApplicationEnumerationsPersec | Collects the number of (non-XML based) application list requests per second. This counter is to be configured on the XML broker or any Citrix server responsible for making requests on the Citrix farm. |
| Citrix-XenApp-Counter-ApplicationResolutionsPersec | Collects the number of resolutions (application launch requests) per second. This counter is to be configured on the XML broker. |
| Citrix-XenApp-Counter-ApplicationResolutionTimems | Collects the time, in milliseconds, to determine the least loaded server when launching an application. |
| Citrix-XenApp-Counter-AverageLicenseCheckOutResponseTimems | Collects the average duration of license verification requests to the Citrix license server, in milliseconds. |
| Citrix-XenApp-Counter-DataStoreConnectionFailure | Collects the time in minutes that the presentation server was disconnected from the server containing the DataStore database. |
| Citrix-XenApp-Counter-FilteredApplicationEnumerationsPersec | Collects the number of (XML-based) application list requests per second. This counter is to be configured on the XML broker. |
| Citrix-XenApp-Counter-LastRecordedLicenseCheckOutResponseTimems | Collects the duration of the last license verification request to the Citrix license server, in milliseconds. |
| Citrix-XenApp-Counter-LicenseServerConnectionFailure | Collects the time it takes to disconnect the XenApp server from the license server, in minutes. |
| Citrix-XenApp-Counter-NumberofbusyXMLthreads | Collects the number of XML threads being processed. This number must not exceed 16. |
| Citrix-XenApp-Counter-ResolutionWorkItemQueueReadyCount | Collects the number of application launch tasks being processed at the XML broker. |
| Citrix-XenApp-Counter-WorkItemQueueReadyCount | Collects the number of tasks being processed at the XML broker or data collectors. |
XML broker configuration: https://support.citrix.com/article/CTX127503
