Skip to main content

September 2, 2026

Monitoring the Availability of Your Horizon Edge Resources

If you have a Horizon Plus license, Horizon Availability Monitoring provides you with a client that you can install and use to test the health of your Horizon Edge resources. The tests can help you quickly detect and isolate issues before they become more serious. For example, you can use the Horizon Availability Monitoring client to test connections, and take other actions, on various components, such as the Horizon Connection Server, your Active Directory, the Horizon Gateway appliances, desktops, and published applications.

After you configure the Horizon Availability Monitoring client, you can use the Horizon Universal Console to configure tests that run health checks on your Horizon Edge environment.

Overview of Availability Monitoring Configuration and Usage

Horizon Availability Monitoring applies to Horizon Edges that reside within your tenant.

As a best practice as you begin to work with this opton, consider, using a test account instead of a regular user account when prompted to provide credentials (user name and password).

When you use the Monitor > Availability step sequence from the left pane navigation in Horizon Cloud, the Availability Monitoring page appears. The three tab choices on the page are Configured Test, Testing Clients, and Test Results.

Configured Test Tab

The Configured Test tab options allow you to add or run a test of the following types: Connectivity, Authentication, Resource Launch, or Simulated Launch.

Each test requires progressively greater access to your Horizon Edge environment, which requires you to provide a greater amount of access-related information.

You can add, edit, remove, and run configured tests from this tab.

  • Connectivity Test

    A successful test result of this type occurs when the Connectivity test validates the network path between the client and the Unified Access Gateway (UAG) appliance.

    The Connectivity test runs from the Horizon Availability Monitoring client to the Unified Access Gateway appliance.

    The prerequisites for this test are as follows.

    • Have the URL to the Horizon Edge, which is the connectivity test target.

    • For Horizon, this is the Horizon Connection Server URL, which is used by the Horizon Client.

  • Authentication Test

    A successful test result of this type occurs when the Authentication test validates that a Horizon Connection Server is alive by authenticating against the Active Directory.

    The Authentication test runs from the Horizon Availability Monitoring client, to the Horizon Edge deployment, to the Horizon Gateway appliances (Unified Access Gateway and Horizon Edge Gateway), and to the Horizon Connection Server.

    The prerequisites for this test are as follows.

    • Have the URL to the Horizon Edge, which is the connectivity test target. For Horizon, this is the Horizon Connection Server URL, which is used by the Horizon Client.

    • Have the credentials available for the test account you will use for this Horizon Availability Monitoring test.

  • Resource Launch Test

    A successful test result of this type occurs when the Resource Launch test launches a selected desktop or publish application.

    The resource launch test runs from the Horizon Availability Monitoring client, through the Horizon Edge deployment, all the way to the desktop.

    The prerequisites for this test are as follows.

    • Have the URL to the Horizon Edge, which is the connectivity test target. For Horizon, this is the Horizon Connection Server URL, which is used by the Horizon Client.

    • Have the credentials available for the test account you will use for this Horizon Availability Monitoring test.

    • Have the desktop or published application name that you want to launch as part of the test.

  • Simulated Launch

    The Simulated Launch uses the Horizon Edge Gateway as a destination and simulates a session launch without consuming a real desktop or application. You can test and monitor the desktop connection path with a simulated agent module embedded in the Edge deployment.

    Simulated Launch validates the desktop connection flow involving simulated client, Connection Service, UAG, and the Edge module.

    The prerequisite for this test is as follows,

    • You must have a deployed Edge capacity type and UAG.

Testing Clients Tab

The Testing Clients tab options allow you to add or run a test based on an installable client bundle or a test configuration that is resident in a particular Cloud region. The two choices on this tab are Installable and Cloud.

You can add, edit, and remove tests from this tab.

  • Installable

    A client that you must download and install at a network location on a Windows system. This type of client is a best choice when you want to simulate a test from the same network location from which desktop users are located.

    Use the Installable client type to download, install, and configure the Horizon Availability Monitoring client on your own Windows system, which includes pairing the client to the Horizon Universal Console.

  • Cloud

    A client hosted in the cloud. This type of client is a best choice when desktop users are accessing the desktop from the Internet. As an administrator, you do not need to maintain the machine that hosts the agent.

    Use the Cloud client type to configure the Horizon Availability Monitoring client that is available in a datacenter region in the cloud.

Test Results Tab

The Testing Clients tab lists completed tests and allows you to open and review the results of a selected test.

Sample Procedure - Configure a First Test

For the initial creation of a Horizon Availability Monitoring test, you create one client and one test. After you create the first test, you can create additional clients and tests. For subsequent test configurations, the steps are similar.

Note: The Overview section above describes the information that is required for each test type.

  1. In Horizon Cloud and from the left pane navigation in the Horizon Universal Console, click Monitor > Availability.

  2. From the resultant Availability Monitoring page, click the Testing Clients tab and then click Add.

    To download, install, and configure the Horizon Availability Monitoring client on a Windows system, perform the following steps:

  3. For the Select type option, select Installable.

  4. Click Download to allow your browser to download the client bundle, which is a Windows Installer Package (.msi file).

  5. Click the copy icon next to the pairing code to copy the code.

  6. Move the Windows Installer Package to a folder on the Windows system from which you will run the Horizon Availability Monitoring client.

  7. On the Windows system, start and complete the Windows Installer Package installation.

    • If you want a more friendly client name, rename the client.
    • Enter the pairing code in the appropriate text box when prompted.

    The Availability Monitoring page displays the updated status of the pairing process, such as Pairing complete.

  8. Click Next.

    To configure the Horizon Availability Monitoring client in the cloud, perform the following steps.

  9. For the Select type option, select Cloud.

  10. In the Name text box, enter a name for the client.

  11. From the Region drop-down menu, select a region.

    The Region drop-down menu includes all the regions available in your environment.

  12. Select and save the test type.

    See the preceding explanations of the Connectivity, Authentication, Resource Launch, and Simulated Launch test types.

  13. Provide the information requested and save the test.

    The amount of information that the page prompts you to provide increases for each test type you configure from the Connectivity test to the Authentication test to the Resource Launch to the Simulated Launch test.

<table>
<thead>
<tr>
<th>Prompts Applicable to All Test Types</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>Type</td>
<td>Select the test type to perform.</td>
</tr>
<tr>
<td>Name</td>
<td>Create a name for the test.</td>
</tr>
<tr>
<td>Client</td>
<td>Select the client from which to run the test.
For the initial test, this client is the client you added in the first step of the Horizon Availability Monitoring wizard.<br>
When you create clients in the future, you can configure this test by changing the client to another client or by adding clients.<br>
<strong>Note:</strong> Multiple clients can use the same test.</td>
</tr>
<tr>
<td>Interval</td>
<td>Select how often you want the test to run.
The test runs continuously at the interval you select until you change the interval or delete the test.</td>
</tr>
<tr>
<td>URL</td>
<td>The URL of the Horizon Edge that serves as the test target.</td>
</tr>
</tbody>
</table>

<table>
<thead>
<tr>
<th>Additional Prompts Applicable to Authentication and Resource Launch Test Types</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>Username</td>
<td>Enter the user name of the test account for this Horizon Availability Monitoring test.</td>
</tr>
<tr>
<td>Password</td>
<td>Enter the password of the test account for this Horizon Availability Monitoring test.</td>
</tr>
<tr>
<td>Domain (optional)</td>
<td>The domain of the Horizon Edge that serves as the test target.</td>
</tr>
</tbody>
</table>

<table>
<thead>
<tr>
<th>Additional Prompt Applicable to the Resource Launch Test Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>Pool Name</td>
<td>Provide the name of the desktop or application to launch.</td>
</tr>
</tbody>
</table>

<table>
<thead>
<tr>
<th>Additional Prompt Applicable to the Simulated Launch Test Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>Horizon Edge</td>
<td>Select the edge to act as a destination for HST test.</td>
</tr>
<tr>
<td>Unified Access Gateway address</td>
<td>The address of the Unified Access Gateway (UAG) as specified by the Azure FQDN or the UAG load balancer IP address.<br>
<b>Note:</b> As an added security measure, a custom FQDN is not allowed. If you used a custom FQDN for the UAG, you can provide the UAG load balancer IP address in a UAG header allowlist.<br>
For information about configuring and using allowed UAG host headers, see <a href="https://docs.omnissa.com/bundle/UnifiedAccessGatewayDeployandConfigureV2603/page/HostHeaderValidationonUAG.html

">Host Header Validation on Unified Access Gateway in Omnissa Unified Access Gateway product documentation.
For information about Load Balancer FQDN and IP Address details, see View Horizon Edge Details. Verify SSL Toggle on or off Verify SSL. When this option is toggled on, the test verifies the existence and authenticity of a server identity certificate.

  1. When the test configuration is finished, the Availability Monitoring page reappears with an updated look, presenting information about your configured tests, clients, and results. This updated look is the permanent look of the page going forward.

Run the Test

  1. To run a test, click Monitor > Availability from the left pane navigation in Horizon Cloud and then click Configured Test.

  2. Select the test that you want to run from the list of available tests and then click Run Test.

Horizon Availability Monitoring Actions You Can Perform

You can perform the following actions, many of which are the same as or similar to the steps for configuring the initial Horizon Availability Monitoring test.

Note: When a Horizon Availability Monitoring test fails, a notification appears on the Notifications page.

ActionDescription
Filter information on the Availability Monitoring page.From each tab on the Availability Monitoring page, you can use the column filters to present the information in a manner that best suits your needs.
Add, edit, delete, or run configured tests.Select Availability > Configured Tests to take any of the following actions.
  • Add another Horizon Availability Monitoring test.
  • Edit an existing configured test, for example, to add or change clients or change the test interval. Depending on the test type, you can also change the credentials of the test account or change the pool name.
  • Delete an existing configured test, for example, when the test is no longer useful.
  • Run an existing configured test manually, for example, when you want to run the test now instead of waiting for the next scheduled run of the test.
Add, edit, or delete testing clients.Select Availability > Testing Clients to take any of the following actions.
  • Add new testing clients.
  • For the <b>Installable</b> client type, you can only add a new testing client to a different Windows system.
    Note: One Horizon Availability Monitoring client is supported at a time on a given operating system.
    
  • Edit an existing testing client.
  • For the <b>Installable</b> client type, if the Windows system that hosts the client fails and requires re-installation, you can install a new client and re-pair to the original client record.
    
  • Delete an existing testing client, for example, when the client is no longer useful.
View test results.Select Test Results to view a list of test results. The list includes 30-days of test results. On the page, you can view a list of the test results, for example, you can view which tests succeeded and which tests failed, if any. Troubleshoot a failed test by considering the test type that failed and when it failed. See the preceding test-type information for details.

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…