Step 4: Set Up Performance Data Collection

This section describes how to set up performance data collection in Horizon.

Horizon collects performance data using collectd, which is enabled by default. Collectd schedules data collection on network entities using management agents and protocol-specific collectors.

In the Horizon docs, any reference to collectd refers to the Horizon collect daemon, not the independent open source project of the same name.

Data collection for SNMP and OpenNMS-JVM is enabled by default, allowing Horizon to monitor itself through JMX.

For additional information, including collector configuration, see Performance Management in the Deep Dive section.

Before you begin

Horizon data collection for SNMP works out of the box, provided your SNMP credentials are configured correctly.

The default value for the community string is public. We recommend that you do not use the default community string in production.

If you are using SNMPv3, you need to configure details for a User-Based Security Model (USM) user instead of a community string. Horizon supports SNMPv3 and USM, but these topics are outside of the scope of this guide.

To change the community string, follow these steps:

  1. Click the Gear symbol at the top-right of the screen.

  2. Under Provisioning, click Configure SNMP Community Names by IP Address.

  3. Set up the configuration as appropriate for your environment:

    • Enter a valid IP address in the IP Address box, and click Look Up.

    • Choose an SNMP version (v2c or v1) from the Version list.

    • (Optional) Define a range of IP addresses by typing the first and last addresses of the range into the First IP Address and Last IP Address boxes, respectively.

    • In the v1/v2c Specific Parameters section, enter the new community string in the Read Community String box.

  4. Click Save Config.

Performance data collection on other protocols (HTTPS, JMX, and so on) requires additional configuration. You may also want to change how collectd works—when, how, and what data it collects. For more information, see Collectors.

Default performance data collection

By default, Horizon collects a variety of information from monitored nodes that support SNMP. This information includes widely implemented metrics that are standard for MIB-2 sources (for example, TCP group data, network interface counters). SNMP data collection definitions are also included for devices from a range of popular vendors (for example, if you add a Cisco router to your instance, Horizon will automatically collect Cisco-specific metrics). The metrics included in these collections vary by vendor.

SNMP collections and data collection groups

SNMP collections collect, store, and persist performance data. By default, Horizon defines two collections: default and ejn. Because the ejn collection is highly specialized, we recommend that you do not modify it.

Data collection groups collect sets of performance data measurements for persisting, indexing, and visualizing the data in the UI. Individual data collection groups are stored in unique .xml files, which define associated resource types, MIB groups, and system definitions. System definitions bring together MIB groups with full or partial SNMP sysObjectID values, enabling automatic collection of appropriate metrics from devices for which they exist.