Ad hoc collection

The opennms:collect Karaf Shell command can be used to trigger and perform a collection on any of the available collectors.

The results of the collection (also referred to as the "collection set") will be displayed in the console after a successful collection. The resulting collection set will not be persisted, nor will any thresholding be applied.

  • List all of the available collectors.

    opennms:list-collectors
  • Invoke the SnmpCollector against interface 127.0.0.1 on node n1 from the NODES requisition.

    opennms:collect -n NODES:n1 org.opennms.netmgt.collectd.SnmpCollector 127.0.0.1
  • Invoke the SnmpCollector against interface 127.0.0.1 on NODES:n1 via the MINION location. Setting the location on the command line will override the location set on the node in the database.

    opennms:collect -l MINION -n NODES:n1 org.opennms.netmgt.collectd.SnmpCollector 127.0.0.1
    If you see errors caused by RequestTimedOutException when invoking a collector at a remote location, consider increasing the time to live. By default, collectd will use the service interval as the time to live.
  • Invoke the JdbcCollector against 127.0.0.1 while specifying some of the collector parameters.

    opennms:collect org.opennms.netmgt.collectd.JdbcCollector 127.0.0.1 collection=PostgreSQL driver=org.postgresql.Driver url=jdbc:postgresql://OPENNMS_JDBC_HOSTNAME/postgres user=postgres
    Some collectors, such as the JdbcCollector, can be invoked without specifying a node.
  • Persist a collection.

    -p/--persist option will persist the new collection set by introducing an extra datapoint in addition to data collected during the regular collection intervals.

    opennms:collect -l MINION -n NODES=n1 -p org.opennms.netmgt.collectd.SnmpCollector 127.0.0.1
    This option will only persist data to JRB/RRD files if there is an existing file for the defined metrics. The files should be created on the first successful collection during a regular collection interval.

A complete list of options is available using the help command.

opennms:collect --help
DESCRIPTION
        opennms:collect

        Invokes a collector against a host at a specified location.

SYNTAX
        opennms:collect [options] collectorClass host [attributes]

ARGUMENTS
        collectorClass
                Collector class
                (required)
        host
                Hostname or IP Address of the system to poll
                (required)
        attributes
                Collector specific attributes in key=value form

OPTIONS
        -l, --location
                Location
        -s, --system-id
                System ID
        -p, --persist
                Persist collection
        -n, --node
                Node ID or FS:FID
        -t, --ttl
                Time to live in milliseconds
        -x, --rra
                Round Robin Archives, defaults to the pristine content on datacollection-config.xml
                (multi-valued)
        --help
                Display this help message

Interpreting the output

After a successful collection, the collection set will be displayed in the following format:

resource a
  group 1
    attribute
    attribute
  group 2
    attribute
resource b
  group 1
    attribute
...

The description of the resources, groups and attribute may differ between collectors. This output is independent of the persistence strategy that is being used.