Add PTP monitoring to collectd

This update adds Precision Time Protocol (PTP) monitoring
to the current list of inhouse developed collectd plugins.

Refer to the ptp.py header for a description of the monitoring
service algorithm and inline comments for detailed behavior.

Test Plan: see depends update commit message

Depends-On: https://review.openstack.org/#/c/647524
Change-Id: I3bf3dff7d6524764d745fe22ae80483c7d8a8b03
Story: 2002823
Task: 29492
Signed-off-by: Eric MacDonald <eric.macdonald@windriver.com>

fm-doc/fm_doc/events.yaml

@@ -407,6 +407,34 @@
     Management_Affecting_Severity: none
     Degrade_Affecting_Severity: none
 
+100.119:
+    Type: Alarm
+    Description:
+        major: "PTP configuration or out-of-tolerance timestamping conditions"
+        minor: "PTP out-of-tolerance timestamping condition"
+    Entity_Instance_ID: |-
+        host=<hostname>.ptp
+        OR
+        host=<hostname>.ptp=no-lock
+        OR
+        host=<hostname>.ptp=<interface>.unsupported=hardware-timestamping
+        OR
+        host=<hostname>.ptp=<interface>.unsupported=software-timestamping
+        OR
+        host=<hostname>.ptp=<interface>.unsupported=legacy-timestamping
+        OR
+        host=<hostname>.ptp=out-of-tolerance
+    Severity: [major, minor]
+    Proposed_Repair_Action: "Monitor and if condition persists, contact next level of support."
+    Maintenance_Action: none
+    Inhibit_Alarms:
+    Alarm_Type: communication
+    Probable_Cause: unknown
+    Service_Affecting: False
+    Suppression: False
+    Management_Affecting_Severity: none
+    Degrade_Affecting_Severity: none
+
 #---------------------------------------------------------------------------
 #   MAINTENANCE
 #---------------------------------------------------------------------------