Child pages
  • opCharts Polling Definition
Skip to end of metadata
Go to start of metadata

Polling definitions describe what will be polled when a collector is running, and how it will be presented.  In the first release of real-time charts, polling definitions are imported/exported via opcharts-cli and can be viewed in the GUI.

opCharts ships with several polling definitions that may be useful and can be used as a guide when creating new ones.  These files can be found in omk/install/nmisd/pollers.d/

Polling definitions must define their name (which must be unique) and can optionally have a description.  There are 5 main sections in a polling definition (see below).

Changing a polling definition is not currently supported, if you need to do this please create a new poller with a new name and start collectors using the new poller.

Adding/Importing, Exporting, Removing

To add/import new polling definitions use opcharts-cli.pl, specify the file to get the definition from and if the file has more than one, specify the name of the poller to import:

Exporting takes the current poller definition and writes it to the file specified (or to the screen if no file is given): 

Removing a poller requires that no collectors exist that use it (enabled or not).  After all the collectors that use the poller have been removed, delete the poller like this:

 

Sections

  1. Graph options - set graph attributes (like axis titles, min/max).
  2. Properties - values that generally don't change over time but are needed to calculate a field or just presented with the graph.
  3. Virtual Properties - definitions of new variables which can be calculations using properties, other virtual properties and collector parameters.
  4. Fields - values that will be polled every time the collector runs.
  5. Virtual Fields - definitions of new variables which can be calculations using fields, properties, virtual properties and collector parameters.

Graph Options

The following are options that can be set:

Common attributes (Properties & Fields)

Properties and Fields define data that will be polled, because of this their definitions share common attributes. The following attributes are common to both:

Common attributes (Virtual Properties & Virtual Fields)

Virtual sections all run through the same parsing system so their definitions are similar, see the opCharts Resource Model Description Virtual Options section for more information.  

The differences between property and field definitions is largely the data that is available to them when running calculations.

Properties

In addition to the common property/field attributes, properties can/must have the following attributes:

Virtual Properties

See the common virtual property/field attributes

Fields

In addition to the common property/field attributes, fields can/must have the following attributes:

Virtual Fields

In addition to the common virtual property/field attributes, it can also have all of the attributes defined in Fields (field_type can be defined but will not do anything) 

Example

Here is an example to help make the definition clearer:

  • No labels

2 Comments

  1. Is it possible to post pend OIDs to an indexed field?  For example with some properties such as CDP and LLDP tables we have the index and then further branches in the tree which relate to that index.

    e.g. 1.3.6.1.4.1.2636.3.16.1.1.1.5.INDEX.1.3.4.5.0

     

    1. Not at this time (opCharts 3.0.7).  Currently this feature is meant for polling simpler SNMP structures.