The SNMP Collector is used to allow Metricly to monitor the performance of SNMP-enabled devices using a set of specified OIDs. The collector can gather data from as many devices as necessary by adding additional configuration sections under the [devices] header.

You should have SNMP set-up and your community string ready prior to activating the SNMP collector.


If you haven’t installed the Linux agent already, see the instructions on this page for how to install it. If you need to disable the Linux integration or view the unique API key assigned to your account, navigate to the Integrations page under the user account drop-down menu and click the integration designated as Infrastructure under the Integration column.

Collector Configuration

  1. Navigate to the collectors folder.
    The default location is /opt/netuitive-agent/conf/collectors.
  2. Open the SNMPCollector.conf file.
    This configuration file will only be available in agent versions 0.3.1 or later. Otherwise, you will have to create a configuration file with the same name.
  3. Change the enabled setting to True.
  4. Change the my-identification-for-this-host header to the name of the host you want to monitor.
  5. Under the [[[oids]]] section, add additional OID-metric pairs list as necessary for the metrics you want Metricly to collect.
  6. Save the configuration file, and restart the Linux Agent.

Additional Configuration Options

  • Collector Options

    Option Default Description
    enabled False Enable collecting SNMP metrics.
    interval 60 How often the collector collects metrics (in seconds).

    The 60-second default may be taxing on your hardware. You may want to increase the collection interval to 120 seconds.
    byte_unit Default numeric output(s).
    measure_collector_time Measure the collector’s run time in milliseconds.
    metrics_blacklist Regex list to match metrics to block. Mutually exclusive with metrics_whitelistoption.
    metrics_whitelist Regex list to match metrics to transmit. Mutually exclusive with metrics_blacklistoption.
    retries Number of times the collector will retry before stopping.
    timeout Seconds before the SNMP connection will automatically timeout.


Redhat 6 and 7
CentOS 6 and 7
Amazon Linux (latest)
Ubuntu 12, 14, 15, and 16
Debian 7, 8, and 9
Linux Agent