Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation  Back up to About Overview 
ContentIndex
  
[+] Expand All
[-] Collapse All

No index entries found.

Related Documentation

    User-Defined SNMP Collection

    The User-Defined SNMP Collection task allows users to collect raw data via SNMP from selected devices for a user specified MIB OID. The raw data collected can then be processed into the User Collected Data Report.

    Note: This feature requires a license. Please contact your Juniper representative for more details on this feature.

    1. To run the User-Defined SNMP Collection task, open the Task Manager from Admin > Task Manager.
    2. Click New Task, and select the User-Defined SNMP Collection task.
    3. Select the devices to be collected.
    4. Under the Collection section, the following entries marked with * are required.

      Field

      Description

      *Data dir

      The directory path where the collected data is stored. The path uses naming convention <data_dir>/YYMMDD/filename

      *File ext

      The file extension which will be used in the filename above. The filename follows the naming convention: devicename.<file_extension>

      *Main MIB OID

      The main MIB OID to be collected.

      Main MIB value

      A short description of the main MIB being collected.

      Key MIB OID

      An optional MIB OID that is used to correlate or identify the main MIB OID. For example, if the Main MIB OID is ifInOctets, the Key MIB OID is ifDescr. See example below.

      Key MIB value

      A short description of the key MIB being collected.

      MIB OID of denominator for Util

      An optional MIB OID that is used for the Utilization field in the user collected data report. See example below.

      MIB value of denominator for Util

      A short description of the denominator MIB being collected.

      Identifying the proper OIDs to collect is important. The format of the user collected data report is:

      Key_OID(1) ^^^ Denominator_OID(1) Main_OID(1) Main_OID(2) ...
      Main_OID(intervalX)
      ...
      • The Main OID is collected at the interval frequency scheduled in the Task Manager. This can result in interval 1, 2, and so on through X. For example, if the frequency collection is per hour, then there will be 24 intervals.
      • The Key OID identifies what the Main_OIDs relate to. For example, if the Main_OID is ifInOctets (the interface byte counter), then the Key OID is ifDescr (the interface name).
      • The Denominator OID can be used for utilization calculations.

      Field

      Description

      Report Name

      This is the title of the report, and this field is required.

      Column Name

      Required only if the Key MIB OID is specified. This is the column name associated to the Key MIB, and is placed after the Router column (Column 2 field in the web report).

      Column Name of denominator for Util

      Required only if MIB OID of denominator for Util is used. This is the column name associated to the denominator MIB, and is placed in the Util column (Calculate Util field in the web report).

      Show Delta

      If checked, the report displays the subtracted difference between collection intervals for the Main MIB OID collected. For example, for traffic data collection, the value of interest is not the byte counter itself, but the delta between successive byte counter values, from which the traffic can be calculated (see also the option Calculate Rate to divide the delta by the time interval). If not checked, the report displays the raw data of the main MIB OID collected.

      Calculate Rate

      If checked, the report displays the divided time difference between intervals for the main MIB OID collected. This is used to calculate traffic by dividing the traffic data by the time between collections. If not checked, the report will not peform this calculation. To display reports showing traffic/time (iBytes/s), typically Show Delta and Calculate Rate are both checked.

      Unit

      This simply applies a unit label to the report fields. It does not affect any report calculations.

    5. Click Next to proceed to the scheduling parameters, to specify the collection interval at which to collect the MIB OID.
    6. Click Finish to schedule the task.

    The following screen shot provides an example configuration of the User-Defined SNMP Collection task to collect for ingress traffic.

    Figure 52: User-Defined SNMP Collection Task

    User-Defined SNMP Collection Task

    Explanation for Collection fields:

    • Data dir—Uses path /u/wandl/data/userCollection/interface. The data collected goes to this path.
    • File ext—Uses intfin. This is short for “interface ingress” and the filenames created will be device_name.intfin.
    • Main MIB OID—This OID corresponds to the entry in the ifMIB > ifTable > ifInOctets. The value returned will be a traffic counter. The counter information alone is not enough to correlate which interface the traffic belongs to. Thus we’ll use the Key MIB OID to perform the correlation.
    • Main MIB value—The MIB description is ifInOctets. The value returned is the total number of octets received on the interface.
    • Key MIB OID—This OID corresponds to the entry in the ifMIB > ifTable > ifDescr. The Key MIB OID is used to correlate the interface name to the traffic counter.
    • Key MIB value—This MIB description is ifDescr. The value returned will be the interface name.
    • MIB OID of denominator for Util—This OID corresponds to the entry in the ifMIB > ifTable > ifSpeed. This will be used as the utilization denominator for interface traffic/time calculation.
    • MIB value of denominator for Util—This MIB description is ifSpeed.The value is the interface bandwidth.

    Explanation for User Collected Data Report Option fields in Figure 52:

    • Report Name—The report title is Interface Ingress Traffic.
    • Column Name—The column name is Interface to identify the grouping of traffic is done per interface name.
    • Column Name of denominator for Util—The name is Bandwidth to identify the bandwidth of the interface.
    • Show Delta—This is selected to subtract the traffic counter values to provide the traffic amount between each interval.
    • Calculate Rate—This is selected to divide Show Delta / interval time to provide the traffic amount in units / time.
    • Unit. Bytes/s is selected because the ifInOctets means the raw data collected is in units of Bytes and we have both Show Delta and Calculate Rate selected meaning we are trying to display traffic in units / time.

    Modified: 2015-12-29