Horizon RDS Farms Test

Farms are collections of RDS hosts and facilitate the management of those hosts. Farms can have a variable number of RDS hosts and provide a common set of applications or RDS desktops to users. When you create an RDS desktop pool or an application pool, you must specify a farm. To know the composition of an RDS farm and track the status of the desktops and applications in the farm, take the help of the Horizon RDS Farms test. For each RDS farm on the target Omnissa Horizon Cluster/Pod, this test reports , type and source, the count of RDS hosts in the farm, the number and type of sessions active in that farm and the state of desktops and applications in that farm.

Target of the test : An Omnissa Horizon Cluster/Pod

Agent deploying the test : A remote agent

Outputs of the test : One set of results for each RDS farm managed by the Omnissa Horizon Cluster/Pod being monitored

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.

Host

The host for which the test is to be configured.

Port

Refers to the port used by the target Omnissa Horizon Cluster/Pod. By default, this is set to NULL.

Connection Server Name

By default, this test connects to every Horizon Connection Server configured in the Omnissa Horizon Cluster/Pod remotely and collects the required metrics. For this, it is necessary to specify valid credentials of the Horizon Connection Servers. To help administrators provide these credentials quickly and easily, the eG administrative interface embeds a special configuration page. To access this page, simply click on the encircled '+' icon that appears alongside this parameter in the test configuration page. To know how to use this special page, refer to Configuring the Omnissa Horizon Connection Servers for Monitoring.

User Name, Password and Confirm Password

By default, this test uses Omnissa Restful APIs to collect the required metrics from the target Omnissa Horizon Cluster/Pod. For this, the eG agent should be configured with read-only user privileges that will allow the agent to communicate with the Horizon Connection Server in a particular domain and extract statistics. Therefore, specify the credentials of the user who is authorized to access the Horizon Connection Server against the User Name, Password and Confirm Password text boxes.

Domain Name

Specify the name of the domain to which the Horizon Connection Server belongs to.

Show RDS Host DD

By default, this flag is set to No, indicating that this test will not report detailed diagnostics for the RDS Hosts measure. This means that the test, by default, will not capture and store the details of every RDS host in a farm, in the eG database. This default setting is ideal for large RDS farms characterized by hundreds of hosts, as it helps conserve space in the eG database and reduce the strain on the database. However, if your eG database is well-sized and you want to view the complete list of RDS hosts in a farm, enable the detailed diagnosis capability of the RDS hosts measure by setting this flag to Yes.

Total Session DD

By default, this flag is set to No, indicating that this test will not report detailed diagnostics for the Total Sessions measure. This means that the test, by default, will not capture and store the details of every session initiated using the RDS host in a farm, in the eG database. This default setting is ideal for large RDS farms characterized by hundreds of hosts wherein thousands of sessions are initiated, as it helps conserve space in the eG database and reduce the strain on the database. However, if your eG database is well-sized and you want to view the complete list of sessions initiated using the RDS hosts in a farm, enable the detailed diagnosis capability of the Total Sessions measure by setting this flag to Yes.

Idle Duration Time (Mins)

Specify the duration (in minutes) of inactivity beyond which a session is considered to be “idle” by this test. By default, this parameter takes the value 10 (minutes); this implies that by default, the test considers all sessions that have been inactive for beyond 10 minutes as idle sessions.

DD Frequency

  • Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD Frequency.
  • Detailed Diagnosis

    To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

    The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

    • The eG manager license should allow the detailed diagnosis capability
    • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
    Measurements made by the test
    Measurement Description Measurement Unit Interpretation

    RDS hosts

    Indicates the number of RDS hosts in this farm.

    Number

     

    Application pools

    Indicates the number of application pools in this farm.

    Number

    Application pools let you deliver applications to many users. The applications in application pools run on a farm of RDS hosts.

    The detailed diagnosis of this measure lists the name of the application pools, the RDS farm associated to the application pool, the RDS hosts to which the application pool is associated to and the Enabled status of the application pool.

    Total sessions

    Indicates the total number of remote sessions to desktops/applications in this farm.

    Number

    The detailed diagnosis of this measure lists the name of the user who initiated the session, the RDS farm to which the user is associated to, the start time of the session, the DNS name, the status of the session, the protocol through which the session was initiated and the IP address.

    Connected desktop sessions

    Indicates the number of desktops in this farm that are in active sessions and have active remote connections to a View client.

    Number

    The detailed diagnosis of this measure lists the name of the user who initiated the session, the RDS farm to which the user is associated to, the start time of the session, the DNS name, the status of the session, the protocol through which the session was initiated and the IP address.

    Disconnected desktop sessions

    Indicates the number of desktops in this farm that are in active sessions but are disconnected from the View client.

    Number

    A non-zero value is a cause for concern.

    The detailed diagnosis of this measure lists the name of the user who initiated the session, the RDS farm to which the user is associated to, the start time of the session, the DNS name, the status of the session, the protocol through which the session was initiated and the IP address.

    Connected applications

    Indicates the number of applications in this farm that are in active sessions and have active remote connections to a View client.

    Number

    The detailed diagnosis of this measure lists the name of the user who accessed the application, the RDS farm to which the user is associated to, the start time of the session through which the application was accessed, the DNS name, the status of the session, the protocol through which the session was initiated and the IP address.

    Disconnected applications

    Indicates the number of applications in this farm that are in active sessions but are disconnected from the View client.

    Number

    A non-zero value warrants close scrutiny.

    The detailed diagnosis of this measure lists the name of the user who accessed the application, the RDS farm to which the user is associated to, the start time of the session through which the application was accessed, the DNS name, the status of the session, the protocol through which the session was initiated and the IP address.

    Is enabled?

    Indicates whether/not this farm is enabled.

     

    This measure reports a value Yes if the farm is enabled and No, if otherwise. The numeric values that correspond to the above-mentioned states are as follows:

    State Numeric Value
    Yes 1
    No 0

    Note:

    By default, this measure reports the above-mentioned states while indicating the status of this farm. However, the graph of this measure will be represented using the corresponding numeric equivalents of the states as mentioned in the table above.

    Sessions via PCoIP

    Indicates the number of PCoIP sessions to the desktops/applications in this farm.

    Number

    The details of the PCoIP sessions can be viewed in the detailed diagnosis.

    Sessions via Blast

    Indicates the number of Blast sessions to the desktops/applications in this farm.

    Number

    The details of the Blast sessions can be viewed in the detailed diagnosis.

    Sessions via RDP

    Indicates the number of RDP sessions to the desktops/applications in this farm.

    Number

    The details of the RDP sessions can be viewed in the detailed diagnosis.

    Maximum connections

    Indicates the maximum number of connections that can be provided to the desktops/applications on this farm.

    Number

     

    Farm type

    Indicates the type of this farm.

     

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

    Measure Value Numeric Value
    Automated 1
    Manual 2

    Note:

    By default, this measure reports the above-mentioned Measure Values while indicating the type of this farm. However, the graph of this measure will be represented using the corresponding numeric equivalents only.

    Farm source

    Indicates the source of this farm.

     

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

    Measure Value Numeric Value
    View composer 1
    Instant clone engine 2

    Note:

    By default, this measure reports the above-mentioned Measure Values while indicating the source of this farm. However, the graph of this measure will be represented using the corresponding numeric equivalents only.

    Farm image source

    Indicates the image source of this farm

     

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

    Measure Value Numeric Value
    Virtual center 1
    Image catalog 2

    Note:

    By default, this measure reports the above-mentioned Measure Values while indicating the image source of this farm. However, the graph of this measure will be represented using the corresponding numeric equivalents only.

    Farm maximum session type

    Indicates the maximum session type configured for this farm.

     

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

    Measure Value Numeric Value
    Limited 1
    Unlimited 2

    Note:

    By default, this measure reports the above-mentioned Measure Values while indicating the image source of this farm. However, the graph of this measure will be represented using the corresponding numeric equivalents only.

    Idle sessions

    Indicates the number of sessions that have been idle beyond the time duration specified against the Idle Duration Time (Mins) parameter.

    Number

    The value of this measure should be low.

    Unknown sessions

    Indicates the number of sessions to the desktops/applications in this farm that are not recognized by the connection server.

    Number

     

    Average farm load index

    Indicates the average percentage of load across all the desktops/applications in this farm.

    Percent

    The value of this measure helps administrators to decide whether additional resources are required to handle the load or load balancing across the desktops needs to be optimized.

    Desktops with agent unreachable

    Indicates the number of desktops whose agents are not reachable.

    Number

    Horizon agents installed on the desktops in the farm become unreachable when Horizon Connection Server is unable to communicate with the agents. This in turn can prevent users from accessing their desktops and can cause disruptions and seriously impact user experience.

    Provisioned desktops

    Indicates the number of desktops that are powered off and suspended in this farm.

    Number

     

    Available desktops

    Indicates the number of desktops that are powered on and ready to be provisioned to the users from this farm.

    Number

     

    Desktops with agent disabled

    Indicates the number of desktops on which the agents are currently disabled.

    Number

     

    Desktops with invalid IPs

    Indicates the number of desktops in this farm that are configured with invalid IPs.

    Number

     

    Desktops where agent needs reboot

    Indicates the number of desktops whose agents require reboot.

    Number

     

    Desktops with protocol failures

    Indicates the number of desktops that experienced protocol failures during the last measurement period.

    Number

    A non-zero value for this measure is a cause for concern.

    When the desktops in the farm encounter protocol failures due to network issues, misconfigurations, or compatibility problems., the users are unable to connect to their desktops using the configured display protocols, such as PCoIP, Blast or RDP. These failures can significantly affect user connectivity and experience.

    Desktops with domain failures

    Indicates the number of desktops that experienced domain failures during the last measurement period.

    Number

    A non-zero value for this measure is a cause for concern.

    Domain failures are reported when the domain server is not accessible, or the domain authentication failed. These errors can prevent users from logging in and accessing their desktops, which in turn directly impacts user productivity and experience.

    Already used desktops

    Indicates the number of desktops that are already assigned to the users from this farm.

    Number

     

    Desktops with provisioning errors

    Indicates the number of desktops that experienced errors while being provisioned from this farm.

    Number

    The value of this measure should be very low.

    Desktops with other errors

    Indicates the number of desktops that encountered other type of errors.

    Number

    The value of this measure should be very low.

    Unassigned user connected desktops

    Indicates the number of desktops that are accessed by a user other than the assigned user.

    Number

     

    Unassigned user disconnected desktops

    Indicates the number of desktops that are accessed and disconnected by a user other than the assigned user.

    Number

     

    Desktops in unknown state

    Indicates the number of desktops in this farm that are in unknown state.

    Number

     

    Provisioning desktops

    Indicates the number of desktops that are being provisioned from this farm.

    Number

     

    Customizing desktops

    Indicates the number of desktops in this farm that are being customized.

    Number

     

    Waiting for agent desktops

    Indicates the number of desktops that are waiting for Horizon Connection Server to establish communication with Horizon Agents installed on them.

    Number

     

    Deleting desktops

    Indicates the number of desktops that are marked for deletion in this farm.

    Number

     

    Maintenance desktops

    Indicates the number of desktops that are currently in maintenance mode.

    Number

    Users cannot log in or use the desktops when they are under maintenance mode.

    Desktops in startup state

    Indicates the number of desktops in this farm that are currently in startup state.

     

    A desktop in a farm moves to startup state when its Horizon Agent has started, but other required services such as the display protocol are still starting.

    Desktops in startup progress state

    Indicates the number of desktops in this farm that are currently in startup progress state.

    Number

     

    Desktops in progress state

    Indicates the number of desktops in this farm that are currently in progress state.

    Number

     

    Desktops in disabled state

    Indicates the number of desktops in this farm that are currently in disabled state.

    Number

     

    Desktops in disabled progress state

    Indicates the number of desktops in this farm that are currently in disabled progress state.

    Number

     

    Desktops in validating state

    Indicates the number of desktops in this farm that are currently in validating state.

    Number

     

    Total problem machines

    Indicates the total number of desktops that encountered one or more problems.

    Number

     

    Total unique user sessions

    Indicates the total number of unique user sessions established to the desktops in this farm.

    Number