Skip to content

Component: OID Conditions

Toni Moreno edited this page Nov 2, 2021 · 9 revisions

OID Conditions

This component allows the user define some conditions based on OID query and rules. Those Conditions can be used on SNMP Metrics to create counters and to create Measurement Filters

View

Configured OID Conditions are shown as table. This will appear every time you navigate from menu.

influx servers list

Add/Edit OID Conditions

  • Add: In the OID Conditions list click on new button New Button

  • Edit: Click on OID Condition edit's button Edit Button

The Create/Modify form will show up:

Edit/Modify OID Conditions

Configuration Parameters

These are the following parameters that allow you to create an OID Condition to be applied as Measurement Filter on Measurement definitions

Note: on 0.8.1+, the match condition works with all SNMP types. Prior to 0.8.1 only works on OctetString SNMP type results

Type of settings Config Parameter Description
Basic settings ID Text String that uniquely identify the OIDCondition
IsMultiple Select if the OID must apply multiple or not:
  • true: apply logical syntax with existing OIDs Conditions
  • false: apply the set condition on OID query
OID Condition settings OID/OID Condition Depending on isMultiple value:
  • Base OID to get data from
  • Logical syntax using existing OID Conditions
Condition Type (Only applied on Multiple: false) All possible conditions

  • neq: returns true if value is equal (number evaluation)
  • nin: returns true if values separated by comma are equal (multiple number evaluation)
  • nlt:returns true if value is less than (number evaluation)
  • ngt:returns true if value is greather than (number evaluation)
  • nge:returns true if value is greater or equal than (number evaluation)
  • nle:returns true if value is less or equal (number evaluation)
  • match:returns true if value match (regex string evaluation)
  • nomatch:returns true if value not match (regex string evaluation)
Condition Value the number or regex will apply to filter result from queried SNMP OID's
Extra settings Description Some useful description to administrators

Multi edit in OID Conditions

Multi edit has 1 option: Remove

  1. Remove: Allows to remove all the selected items

Examples:

A. Creating new Multiple OID Condition

Lets filter all interfaces that are UP and are Ethernet like:

A.1 Add single OID Conditions, the result must be like:

ID Is Multiple OIDCond CondType CondValue
cond_if_status_up false .1.3.6.1.2.1.2.2.1.8 neq 1
cond_if_name_match_eth false .1.3.6.1.2.1.31.1.1.1.1 match eth.*

A.2 Add a OID Condition with IsMultiple = true

Now the OID Condition field must be filled with a logical expression that uses already defined conditions:

ID Is Multiple OIDCond
cond_if_status_if_eth true cond_if_name_match_eth && cond_if_status_up

A.3 Result

The OID Condition list must be like:

ID Is Multiple OIDCond CondType CondValue
cond_if_status_up false .1.3.6.1.2.1.2.2.1.8 neq 1
cond_if_name_match_eth false .1.3.6.1.2.1.31.1.1.1.1 match eth.*
cond_if_status_if_eth true cond_if_name_match_eth && cond_if_status_up