eG Monitoring
 

Measures reported by XDCtxBrokerTest

The Citrix Broker Service brokers connections from endpoint devices to desktops and applications. By closely monitoring how this service interacts with the broker's MS SQL database, you can be forewarned of potential delays in servicing user requests for desktops.

This test periodically monitors the load on the Citrix Broker Service, the connectivity between the service and the database, and the health of transactions performed by the service on the database, so that you can receive real-time updates on the following:

  • The sudden unavailability of connection to the database;

  • A service overload;

  • Failure of transactions to the database;

  • Delays in the completion of transactions on the database

The measures made by this test are as follows:

Measurement Description Measurement Unit Interpretation
Brokered_sessions Indicates the number of virtual desktop sessions that are brokered by the Citrix Broker Service. Number  
DB_avg_trans_time Indicates the average time taken by the broker to execute a database transaction from the Citrix Broker Service. Secs  
DB_connected Indicates whether the Citrix Broker Service is connected to the database. Number A value of 1 indicates that the database is connected and a value of 0 indicates that the database is not connected to the Citrix Broker Service.
DB_trans_err Indicates the rate at which the database transactions are failing while the Citrix Broker Service is executing the transactions. Trans/sec  
DB_trans Indicates the rate at which the database transactions are executed from this Citrix Broker Service. Trans/sec  
Deregistration_req Indicates the number of de-registration requests received by the Citrix Broker Service from the virtual desktops. Number/req  
Expired_launches Indicates the rate at which virtual desktops are timed out while waiting to be connected to the clients, as detected by the Citrix Broker Service. Launches/sec  
Expired_registrations Indicates the number of virtual desktop registrations that have expired. Number  
Expired_reg_per_sec Indicates the rate at which virtual desktop registrations with Citrix Broker Service expire, through inactive communication. Registrations/sec  
Hard_reg_per_sec Indicates the rate at which the virtual desktop agents are hard-registered i.e., forcefully registered with the Citrix Broker Service. Registrations/sec  
Reg_avg_req_time Indicates the average time taken to process a virtual desktop registration request in the Citrix Broker Service. Secs  
Reg_rejects_per_sec Indicates the rate at which the Citrix Broker Service rejects registration requests from virtual desktops. Rejects/sec  
Registration_req Indicates the number of registration requests received by the Citrix Broker Service from the virtual desktops. Number  
Reg_req_per_sec Indicates the rate at which the Citrix Broker Service receives registration requests from the virtual desktops. Requests/sec  
Soft_reg_per_sec Indicates the rate at which virtual desktop agents are soft-registered i.e., registered during installation with the Citrix Broker Service. Registrations/sec  
Icon_cache_writes Indicates the number of icons cached for connection leasing by the Citrix Broker Service. Number

For best performance, user connections to regularly used icons should be in the cache. However, if the cache does not have adequate space, then very few user connections will be cached - sometimes, many of the regular connections themselves may not be in the cache. In such a situation, if the database becomes unavailable, many application/desktop launches will fail owing to the absence of cached connections.

Therefore, to ensure that the value of this measure remain high - i.e., to ensure that sufficient user connections to icons are present in the cache - you need to make sure that the cache is adequately sized.
Lease_sync_skip Indicates number of lease cache synchronization cycles that were skipped as a result of the previous cycle not completing on time. Number

The leases generated on each Controller are uploaded to the Site database for periodic synchronization to other Controllers on the Site.

If a non-zero value is reported by this measure, it means that one/more synchronizations have been missed. This in turn implies that outdated lease information is at the disposal of the other controllers on the site. This in turn can cause inconsistencies in connection leasing behaviour across the site.
Lease_sync_skip Indicates number of lease cache synchronization cycles that were skipped as a result of the previous cycle not completing on time. Number

The leases generated on each Controller are uploaded to the Site database for periodic synchronization to other Controllers on the Site.

If a non-zero value is reported by this measure, it means that one/more synchronizations have been missed. This in turn implies that outdated lease information is at the disposal of the other controllers on the site. This in turn can cause inconsistencies in connection leasing behaviour across the site.
Lease_uploads Indicates the number of leases uploaded and synchronized across the site for connection leasing by the Citrix Broker Service. Number Ideally, the value of this measure should be high.
Lease_writes Indicates the number of leases cached for connection leasing by the Citrix Broker Service. Number