Getting Started

Horizon installs with a base configuration that automatically begins service-level monitoring and reporting as soon as you provision managed entities (nodes, IP interfaces, SNMP interfaces, and services).

Horizon has three methods of provisioning:

Use auto discovery if you do not have a "source of truth" for your network inventory. Auto discovery can become that source. Be aware that auto discovery can include entities you do not want to monitor, if not properly configured.

Directed discovery is effective if you know your inventory, particularly with smaller networks (for example, 100–200 nodes). It is also useful for areas of your network that you cannot auto discover.

Regardless of the method, provisioning is an iterative process. You will need to fine-tune your results to exclude or add things to what you monitor.

Before you begin

If you collect data via SNMP or are monitoring the availability of the SNMP service on a node, you must configure SNMP for provisioning before using auto or directed discovery. This ensures that Horizon can immediately scan newly discovered devices for entities. It also makes reporting and thresholding available for these devices.

In addition, you may want to edit the default foreign source definition to specify the services to detect and policies to apply during discovery.

Configure SNMP for provisioning

Proper SNMP configuration lets Horizon understand network/node topology and automatically enables performance data collection. Horizon updates network topology as it provisions nodes.

  1. In the web UI, click the gear icon in the top right.

  2. In the Provisioning area, choose Configure SNMP Community Names by IP Address, and fill in the fields as desired:

SNMP Config
Figure 1. Configure SNMP community names

This screen sets up SNMP within Horizon for agents listening on IP addresses through These settings are optimized into the snmp-config.xml file.

For an example of the resulting XML configuration, see Configure SNMP community names.

Edit Default Foreign Source Definition

The default foreign source definition serves as a template that defines the services to detect on (DNS, FTP, ICMP, and so on), the scan interval for discovery, and the policies to use when provisioning.

Policies determine entity persistence and/or set attributes on the discovered entities that control Horizon management behavior. Provisiond applies the existing default foreign source definition unless you choose to modify it.

Edit detectors and set scan interval

  1. In the web UI, click the gear icon in the top right.

  2. In the Provisioning area, choose Manage Provisioning Requisitions.

  3. Click Edit Default FS.

    FS def
    The screen displays the list of service detectors and a tab to view and define policies. Provisiond scans the services in the order in which the detectors appear in the list.
  4. Click the appropriate icon to edit, delete, or move a service detector.

    1. You can also add parameters to a detector, including retries, timeout, port, and so on, by clicking the Edit icon and choosing Add Parameter.

  5. Click Save.

  6. If desired, update the scan interval using one of the following:

    • w: weeks

    • d: days

    • h: hours

    • m: minutes

    • s: seconds

    • ms: milliseconds

    For example, to rescan every six days and 53 minutes, use 6d 53m. Specify 0 to disable automatic scanning.

  7. Click Save.

Create policies

  1. Click the Policies tab in the Default Foreign Source Definition screen.

  2. Specify a name for the policy, select the class from the drop down, and fill out any information associated with that class.

    1. Use the space bar to see the options for the fields.

  3. (optional) Click Add Parameter to add additional parameters to the class, or Save.

  4. Click Save.

  5. Repeat for any additional policies you want to add.

  6. Click Save at the top right to save the FS definition.

To return to the default foreign source definition, click Reset to Default.

Create a requisition

A requisition is a set of nodes (networked devices) that you want to import into Horizon for monitoring and management. You can iteratively build a requisition and later actually import the nodes in the requisition into Horizon. Doing so processes all of the adds/changes/deletes at once.

Organize nodes with a similar network monitoring profile into a requisition, so that you can assign the same services, detectors, and policies to model the network monitoring behavior (e.g., routers, switches).

This procedure describes how to create an empty requisition. Links to additional information on customizing a requisition appear at the end of the procedure.

  1. In the web UI, click the gear icon in the top right.

  2. In the Provisioning area, choose Manage Provisioning Requisitions.

  3. If you haven’t already, edit the default foreign source definition to define services to detect.

  4. Click Add Requisition, type a name, and click OK.

  5. Click the edit icon beside the requisition you created.

  6. (optional) Click Edit Definition to define the services, policies, and scan interval to use for this requisition.

    1. Do this only if this requisition differs from the default foreign source definition already configured.

The requisition remains red until you synchronize it with the database.
red requisition

Once created, you can add nodes to the requisition.