eG Monitoring
 

Measures reported by CtxXcXDLicenseTest

Licensing errors in a XenApp/XenDesktop environment can cause major outages or degraded service for customers. To avoid such adversities, administrators should be able to proactively identify when license problems affect your site or are about to impact user connections. This is where the CtxXcXDLicenseTest test helps. This test scans the application event log of the delivery controller for specific critical, error, warning, and information events pertaining to license usage, and reports the count of events captured recently. The detailed diagnosis of this test reveals the messages so captured, so as to aid troubleshooting.

Outputs of the test : One set of results for the Delivery Controller being monitored

The measures made by this test are as follows:

Measurement Description Measurement Unit Interpretation
Dc_license_warning Indicates the count of warning events with the event ID 1154 that were captured in the event log during the last measurement period. Number Events with the ID 1154 occur only when the controller enters the licensing grace period. Use the detailed diagnosis of this measure to know when the grace period will expire - i.e., to know how much time is left before the controller stops providing desktop sessions.

Broker_serv_license_critical Indicates the count of critical events with the event ID 1151, 1155, 1157, and 1159, which were captured in the event log during the last measurement period. Number Typically, events with the ID 1151, 1155, 1157, and 1159 are triggered, if the following problems are noticed:

  • The Citrix Broker Service is not able to contact the license server:

  • The Citrix Broker Service stops providing desktop sessions, because the controller is no longer in or could not enter a licensing grace period;

  • The version of the license server is older than the version of the Citrix Broker Service;

  • The Citrix Broker Service denies a desktop connection because the maximum number of licenses for the site has exceeded

Use the detailed diagnosis of this measure to know which events occurred recently and how to resolve them.

Broker_serv_license_info Indicates the number of events with event ID 1150 and 1156, which were captured during the last measurement period. Number Typically, events with the ID 1150 and 1156 are triggered, if the following are noticed:

  • The Citrix Broker Service successfully contacted the license server;

  • The controller is no longer in the licensing grace period, as the license has been acquired. The Citrix Broker Service is successfully communicating with the license server after license acquisition.

Use the detailed diagnosis of this measure for more details about these events.

Broker_serv_license_warn Indicates the number of events with the event ID 1153, 1158, and 1160, which were captured in the last measurement period. Number Typically, events with the ID 1153, 1158, and 1160 are triggered, if the following problems are noticed:

  • The XenDesktop site's license expired:

  • The Citrix Broker Service detected that you have exceeded the number of licenses available for this site on the license server for this edition. The license server granted you an overdraft license;

  • The Citrix Broker service encountered an internal error while managing licenses.

Use the detailed diagnosis of this measure to know which events occurred recently and to troubleshoot them effectively.

Site_license_error Indicates the number of events with event ID 1152, that were captured during the last measurement period. Number Events with ID 1152 occur if the XenDesktop site being monitored does not have the required licenses present on the license server.

Use the detailed diagnosis of this measure to know more details about these events. Typically, when such events occur, you may want to use the License Administration Console to add the relevant licenses to the license server and proceed.