Creating collection formulas

You can create your own collection formulas that you want Telco Network Cloud Manager - Performance to poll and collect the specific device performance metrics. You can create custom collection formulas for any type of device and resources within it.

Before you begin

  1. Copy all the standard and dependent MIB files that are required for the collection formulas that you plan to create and arrange them in vendor-specific directories to avoid conflicts.
    Note: Discovery and polling operations share the MIB files. So, you must copy only those files that are not already available.
  2. Generate the binding with all the required MIB files.
    For example, create a binding with RFC1213-MIB for a formula that required the MIB as follows:
     $ bin/snmp-binding-tool <my_pack> generate RFC1213-MIB   
    
    Generating bindings for mib RFC1213-MIB...
       Generating bindings for mib RFC1213-MIB complete.

Procedure

  1. Create the collection formula file as follows:
    For example, to create a formula file by name, interface.inbound.octets.formula.
    
    interface.inbound.octets = value(RFC1213_MIB.ifInOctets) when resource.type == 'interface'
  2. Save the file in the following directory based on the type of Technology Pack folder. Arrange the discovery formulas in separate directories to avoid conflicts.


    workspace/<my_pack>/snmp/formulas/<group>


    workspace/<my_pack>/file/formulas/<group>

    Note:
    • All the collection formulas must have the file extension as .formula. If the file has more than one formula in it, save it as .formulas.
    • As a best practice, create a formula file for a single metric. Make sure that the formula or the expression is written in one statement. A formula with multiple statements is not supported.
  3. Create all the required formulas to poll the devices and their resources.

What to do next

Validate the content to make sure there are no errors in the formulas.