eG Monitoring
 

Measures reported by XDSiteTest

A broker site is a top-level, logical representation of the XenDesktop site, from the perspective of the brokering services running within the site. It defines various site-wide default attributes used by the brokering services. A XenDesktop installation has only a single broker site instance.

This test alerts the user regarding the availability of the license server and the connectivity of the broker to the database.

 The measures made by this test are as follows:

Measurement Description Measurement Unit Interpretation
License_server_avail Indicates the availability of the license server. Percentage If the license server is available, a value of 100 is shown and if the license server is not available, a value of 0 is shown. The detailed diagnosis of this measure shows the License Server Name along with the License Server Port, if the license server is available.
Response_time Indicates the time taken by the broker to contact the license server. Secs Ideally, the response time should be 0. 
Broker_service_status Indicates whether the broker is connected to the configured database. Number This measure reports the following states while indicating the broker connection to the configured database.
  • Ok
  • DBUnconfigured
  • DBRejectedConnection
  • InvalidDBConfigured
  • DBNewerVersionThanService
  • DBOlderVersionThanService
  • DBVersionChangeInProgress
  • PendingFailure
  • Failed
  • Unknown

    • The numeric values that correspond to the above-mentioned states are as follows:

    State Numeric Value Description
    Ok 1 Indicates that the broker is connected to a valid database and the service is running.
    DBUnconfigured 2 Indicates that the broker does not possess a configured database connection.
    DBRejectedConnection 3 Indicates that the database has rejected the login credentials from the Broker Service. This may be caused by bad login credentials, or due to the database not being installed.
    InvalidDBConfigured 4 Indicates that the database schema is missing i.e., the stored procedures are missing from the database.
    DBNewerVersionThanService 5 Indicates that the version of the broker is older than the database version. To access the database, upgrade the version of the broker.
    DBOlderVersionThanService 6 Indicates that the version of the database is older than the broker version. To access the database, upgrade the version of the database.
    DBVersionChangeInProgress 7 Indicates that the database schema upgrade is in progress.
    PendingFailure 8 Indicates that the connectivity between the Broker Service and the database has been lost. This may be due to a transitory network error, but may indicate a loss of connectivity that requires administrator intervention.
    Failed 9 Indicates that the connectivity between the broker and the database has been lost for an extended period of time, or the connectivity has failed due to a configuration problem. The broker service cannot operate while its connection to the database is unavailable.
    Unknown 10 Indicates that the status of the service cannot be determined.

    Note:

    By default, this measure reports the above-mentioned States while indicating the broker connection to the configure database. However, the graph of this measure will be represented using the corresponding numeric equivalents of the states as mentioned in the table above.
    Host_service_status Indicates the current state of the Host service on this controller. Number The Citrix Host Service creates and manages hypervisor connections via specific plugins for XenServer, ESX, and Hyper-V. If this service is unavailable, then, the broker service will not be able to access, clone, start, or stop VMs on hypervisors.

    The table below lists the States reported by this measure and the numeric values that correspond to each of these states:

    State Numeric Value
    Ok 1
    DBUnconfigured 2
    DBRejectedConnection 3
    InvalidDBConfigured 4
    DBNotFound 5
    DBNewerVersionThanService 6
    DBOlderVersionThanService 7
    DBVersionChangeInProgress 8
    Failed 9
    Unknown 10

    Note:

    By default, this measure reports the above-mentioned States in the table above to indicate the status of the Citrix Host service. However, the graph of this measure will be represented using the corresponding numeric equivalents i.e., 1 to 10.
    AD_service_status Indicates the current state of the AD Identity service on the controller. Number The AD Identity server manages Active Directory computer accounts.

    The table below lists the States reported by this measure and the numeric values that correspond to each of these states:

    State Numeric Value
    Ok 1
    DBUnconfigured 2
    DBRejectedConnection 3
    InvalidDBConfigured 4
    DBNotFound 5
    DBNewerVersionThanService 6
    DBOlderVersionThanService 7
    DBVersionChangeInProgress 8
    Failed 9
    Unknown 10

    Note:

    By default, this measure reports the above-mentioned States listed in the table above to indicate the status of the Citrix AD Identity service. However, the graph of this measure will be represented using the corresponding numeric equivalents i.e., 0 to 10.
    Config_service_status Indicates the current status of the Configuration service on the controller. Number The Citrix Configuration Service stores global meta-data about all the other services so there is no SCP record needed in AD anymore.

    The table below lists the States reported by this measure and the numeric values that correspond to each of these states:

    State Numeric Value
    Ok 1
    DBUnconfigured 2
    DBRejectedConnection 3
    InvalidDBConfigured 4
    DBNotFound 5
    DBNewerVersionThanService 6
    DBOlderVersionThanService 7
    DBVersionChangeInProgress 8
    Failed 9
    Unknown 10

    Note:

    By default, this measure reports the above-mentioned States to indicate the status of the Citrix Configuration service. However, the graph of this measure will be represented using the corresponding numeric equivalents i.e., 1 to 10.
    MeachCr_service_status Indicates the current state of the Machine Creation server on the controller. Number The Citrix Machine Creation Service creates new virtual machines.

    The table below lists the States reported by this measure and the numeric values that correspond to each of these states:
    State Numeric Value
    Ok 1
    DBUnconfigured 2
    DBRejectedConnection 3
    InvalidDBConfigured 4
    DBNotFound 5
    DBNewerVersionThanService 6
    DBOlderVersionThanService 7
    DBVersionChangeInProgress 8
    Failed 9
    Unknown 10

    Note:

    By default, this measure reports the above-mentioned States to indicate the status of the Citrix Machine Creation service. However, the graph of this measure will be represented using the corresponding numeric equivalents i.e., 1 to 10.
    MachId_service_status Indicates the current status of the Machine Identity service on the controller. Number The Citrix Machine Identity Service manages the storage of virtual machines.

    The table below lists the States reported by this measure and the numeric values that correspond to each of these states:

    State Numeric Value
    Ok 1
    DBUnconfigured 2
    DBRejectedConnection 3
    InvalidDBConfigured 4
    DBNotFound 5
    DBNewerVersionThanService 6
    DBOlderVersionThanService 7
    DBVersionChangeInProgress 8
    Failed 9
    Unknown 10

    Note:

    By default, this measure reports the above-mentioned States to indicate the status of the Citrix Machine Identity service. However, the graph of this measure will be represented using the corresponding numeric equivalents i.e., 1 to 10.