inSITE Multi Path Packet Merge Collector

The Multi Path Packet Merge (MPPM) collector is a data collection module that gathers MPPM settings and status from edge devices in a SDVN network. The poller script uses the cfgjsonrpc webeasy program to gather information.

The data collection module has the below distinct abilities and features:

1. Collects Main, Backup, and Hitless input information like bit rate and dropped packets
2. Collects the playout status and link select status.
3. Collects from multiple decoders for a device at the same time.
4. Multi-threaded for multiple devices for non blocking capability.
5. Texutal status values for easy use with the Intelligence notifications.

Minimum Requirements:

• inSITE Version 10.3 and service pack 6
• Python3.7 (already installed on inSITE machine)
• Python3 Requests library (already installed on inSITE machine)

Installation:

Installation of the status monitoring module requires copying two scripts into the poller modules folder:

1. Copy packet_merge.py script to the poller python modules folder:

    cp scripts/process_monitor.py /opt/evertz/insite/parasite/applications/pll-1/data/python/modules
   

2. Restart the poller application

Configuration:

To configure a poller to use the module start a new python poller configuration outlined below

1. Click the create a custom poller from the poller application settings page

2. Enter a Name, Summary and Description information

3. Enter the host value in the Hosts tab

4. From the Input tab change the Type to Python

5. From the Input tab change the Metric Set Name field to packetmerge

6. From the Python tab select the Advanced tab and enable the CPython Bindings option

7. Select the Script tab, then paste the contents of scripts/poller_config.py into the script panel.

8. Locate the below section of the script for custom modifcations:

        params = {"hosts": hosts, "decoders": [1, 2, 3, 4, 5, 6, 7, 8, 9]}
   

   Update the decoder list with the number of decoders the device has or uses.

9. Save changes, then restart the poller program.

Testing:

The process_monitor script can be ran manually from the shell using the following command

python packet_merge.py

Below is the sample json file created:

 {
  "fields": {
   "link_select": "Auto Packet Merge",
   "i_decoder": 1,
   "as_ids": [
    "361.0@i",
    "364.0@i",
    "301.0.0@i",
    "302.0.0@i",
    "301.0.1@i",
    "302.0.1@i",
    "301.0.2@i",
    "302.0.2@i"
   ],
   "playout_status": "Merged",
   "l_main_packet_drop": 32845644,
   "l_main_packet_rate": 250757000,
   "l_backup_packet_drop": 1363,
   "l_backup_packet_rate": 250757000,
   "l_hitless_packet_drop": 631,
   "l_hitless_packet_rate": 250757000
  },
  "host": "192.168.0.16",
  "name": "merged"
 }