Citrix Configuration Logging Service Test

The Configuration Logging Service logs configuration changes or administrator requested state changes made to the site. Configuration Logging can be configured, site wide, to be mandatory or optional. If mandatory logging is selected, then any attempts to change site configuration or state when the logging mechanism is unavailable are denied.

The Configuration Logging Service stores information about the logged changes in a database which can be configured to be separate from the site database.

The Configuration Logging Service runs on every Controller in the Site handling logging requests. If one Controller fails, the service on another Controller automatically handles logging requests.

This test periodically monitors the Citrix Configuration Logging Service and reports 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

Target of the test : A Citrix Delivery Controller 7.x

Agent deploying the test : An internal agent

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

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.

Host

The IP address of the host for which this test is to be configured.

Port

Refers to the port at which the host listens to. By default, this is 80.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

Database average transaction time

Indicates the average time taken by the service to execute database transactions.

Secs

Ideally, the value of this measure should be low. A high value indicates that the service is taking too much time to execute transactions on the database; this can cause significant delays in connection brokering.

Is database connected?

Indicates whether the database is connected or not i.e.,whether this service is in contact with the database.

 

This measure reports the value Yes if the database is connected and No if it is not. The numeric values that correspond to these measure values are as follows:

Measure Value Numeric Value
Yes 1
No 0

Note:

By default, this measure reports the above-mentioned Measure Values to indicate whether/not the Citrix Configuration Logging service is connected to the database. However, in the graph of this measure, the same will be represented using the numeric equivalents – 1 and 0 only.

If the database is unavailable, the logging service may not be able to perform critical database transactions; this may adversely impact the user experience with the service and with the broker as a whole.

Database transaction errors

Indicates the rate at which the database transactions are failing while the Citrix Configuration Logging Service is executing the transactions.

Errors/Sec

A low value is desired for this measure.

Database transactions

Indicates the rate at which the database transactions are executed by the Citrix Configuration Logging Service.

Trans/Sec