You use the Broker Agent Config Utility for Horizon to configure the broker agent to communicate with the vRealize Operations for Horizon solution.

You pair each broker agent with a Horizon Adapter instance. Pairing the broker agent with an adapter instance enables the broker agent and its desktop agents to communicate with the Horizon Adapter.

You can pair the broker agents in different pods with a single Horizon Adapter instance as long as the total number of desktops that the adapter instance handles does not exceed 10,000.

You must configure the broker agent to connect to your event database. You can also optionally configure the broker agent to monitor application pools and specific desktop pools.


  • Install the vRealize Operations for Horizon broker agent. See Install the vRealize Operations for Horizon Broker Agent.
  • Obtain the server key for the Horizon Adapter instance. You specified the server key when you created the credential for the adapter instance.
  • Obtain the IP address of the host where you installed the Horizon Adapter instance.
  • Obtain the credentials for your event database and verify that the database format is supported. See Supported Event Databases.
  • If you want to monitor specific desktop pools in Horizon, obtain the IDs for the pools from Horizon Administrator.
  • Log in to the Horizon Connection Server host as a Horizon administrator.


  1. If the Broker Agent Config Utility for Horizon wizard is not already open, select Start > VMware > vRealize Operations for Horizon Broker Agent Settings.
  2. Enter the FQDN or IP address and the port of the vRealize Operations Manager node where the Horizon Adapter instance is running.
    By default, the broker agent uses port 3091 to communicate with the Horizon Adapter.
  3. Enter the server key and click Pair.
    The status of the pairing process appears in the lower pane.
  4. On the Connection Server page, enter the user name, password, and domain of a Horizon administrator account and the port used to connect to Horizon Connection Server.
  5. On the Event DB and Desktop Pools page, configure your event database and desktop pool settings.
    1. In the Event Database Information section, enter your event database credentials and click Test.
    2. (Optional) In the Desktop Pools section, select the Specify Desktop Pools check box, select whether to include or exclude the specified pools, and enter desktop pool IDs (separated by commas) in the text box.
    3. (Optional) Select the Monitor Application Pools and hosted applications check box.
      Monitoring only specified application pools is not supported.
  6. Click Next through the following four pages and make any changes necessary. You can perform the following configurations:
    • On the Configure App Volumes page, specify App Volumes Manager installations for the broker agent to monitor.
      Note: Computer-based AppStacks are not supported. Metrics can be displayed for user-assigned AppStacks only.
    • On the Configure Unified Access Gateway page, specify Unified Access Gateway appliances for the broker agent to monitor.
      Note: Ensure that each Unified Access Gateway is configured on one broker agent only. Do not configure the same Unified Access Gateway appliance on more than one broker agent.
    • On the Intervals and Timeouts page, modify how often the topology is refreshed and sessions are updated.
    • On the Logging page, set the level of logs to create and the policy for log rotation.
  7. On the Broker Agent Service page, view the status of the service and start, stop, or restart it if necessary.
  8. On the final page, review your settings and click Finish.
    If you want to make any changes, click Back until you reach the appropriate page.
    The Broker Agent Config Utility for Horizon wizard closes, and the broker agent service is restarted.

What to do next

Verify Your vRealize Operations for Horizon Installation