Description
Template to monitor Cisco NTP Peers statistics like Peer OFFSET, Round-trip DELAY and DISPERSION irrespective of local clock and ROOT DELAY, ROOT DISPERSION irrespective of primary reference source at the root of the synchronization subnet. Metric details, 1. cisco.ntp.peer.offset – The estimated offset of the peer clock relative to the local clock, in seconds. 2. cisco.ntp.peer.delay – The estimated round-trip delay of the peer clock relative to the local clock over the network path between them, in seconds. 3. cisco.ntp.peer.dispersion – The estimated maximum error of the peer clock relative to the local clock over the network path between them, in seconds. 4. cisco.ntp.peer.root.delay – A signed fixed-point number indicating the total round-trip delay in seconds, from the peer to the primary reference source at the root of the synchronization subnet. 5. cisco.ntp.peer.root.dispersion – The maximum error in seconds, of the peer clock relative to the primary reference source at the root of the synchronization subnet. 6. cisco.ntp.peer.mode – The association mode of the NTP server. Possible mode values 0 - unspecified, 1 - symmetricActive, 2 - symmetricPassive, 3 - client, 4 - server, 5 - broadcast, 6 - reservedControl, 7 - reservedPrivate. 7. cisco.ntp.peer.mode.change – It represents whether NTP Peer mode changed or not. Defined some custom states to alert when NTP Peer mode changed from one state to another state. Here are those custom states, 0 - MODE_NOT_CHANGED, 1 - MODE_CHANGED. And here are actual NTP Peer modes, 0 - unspecified, 1 - symmetricActive, 2 - symmetricPassive, 3 - client, 4 - server, 5 - broadcast, 6 - reservedControl, 7 - reservedPrivate. 8. cisco.ntp.peer.org.time – The local time at the peer, when its latest NTP message was sent. This time is in seconds relative to 00:00 on 1 January 1900. If the peer becomes unreachable the value is set to zero.
Prerequisites
Device should support CISCO-NTP-MIB OIDs and proper SNMP credentials should be assigned against to the device in portal.
NOTE: Implemented this template by taking CISCO-NTP-MIB as a reference. And that MIB was defined by referring to: D.L. Mills, ‘Network Time Protocol (Version 3)’, RFC-1305, March 1992, Sections 2, 3.2.1
Metric Parameters
| Parameter | Description |
|---|---|
| Frequency | Warning Threshold | If the metric value satisfies the condition defined along with Warning Threshold value, then a notification is sent to the user. |
| Critical Threshold | If the metric value satisfies the condition defined along with Critical Threshold value, then a notification is sent to the user. |
| Alert | The alert value can be set to either Yes or No. If it is Yes, then an alert message is sent to the user. |
Metrics
cisco.ntp.peer.offset
Metric Details
| Applicable for | Device |
| SNMP OID | NULL |
| Expression | NULL |
| Description | The estimated offset of the peer clock relative to the local clock, in seconds. [CISCO-NTP-MIB::cntpPeersPeerAddress - 1.3.6.1.4.1.9.9.168.1.2.1.1.3, cntpPeersOffset - 1.3.6.1.4.1.9.9.168.1.2.1.1.23, cntpPeersPeerName - 1.3.6.1.4.1.9.9.168.1.2.1.1.31] |
| Category | SNMP Extended |
| Collector Type | Gateway |
| Monitor Name | Cisco NTP Peer Stats - Ext |
| Unit | s |
Possible Inputs
| Metric | Input Value | Range of Values |
|---|---|---|
| Frequency | 5 | 1 – 1440 (mins) |
| Filter | ||
| Warning Operator | ||
| Warning Threshold | ||
| Warning Repeat Count | ||
| Critical Operator | ||
| Critical Threshold | ||
| Critical Repeat Count | ||
| Alert | No | Yes/No |
| Graph (Yes/No) | Yes | Yes/No |
Sample Output
No graph
cisco.ntp.peer.delay
Metric Details
| Applicable for | Device |
| SNMP OID | NULL |
| Expression | NULL |
| Description | The estimated round-trip delay of the peer clock relative to the local clock over the network path between them, in seconds. [CISCO-NTP-MIB::cntpPeersPeerAddress - 1.3.6.1.4.1.9.9.168.1.2.1.1.3, cntpPeersDelay - 1.3.6.1.4.1.9.9.168.1.2.1.1.24, cntpPeersPeerName - 1.3.6.1.4.1.9.9.168.1.2.1.1.31] |
| Category | SNMP Extended |
| Collector Type | Gateway |
| Monitor Name | Cisco NTP Peer Stats - Ext |
| Unit | s |
Possible Inputs
| Metric | Input Value | Range of Values |
|---|---|---|
| Frequency | 5 | 1 – 1440 (mins) |
| Filter | ||
| Warning Operator | ||
| Warning Threshold | ||
| Warning Repeat Count | ||
| Critical Operator | ||
| Critical Threshold | ||
| Critical Repeat Count | ||
| Alert | No | Yes/No |
| Graph (Yes/No) | Yes | Yes/No |
Sample Output
No graph
cisco.ntp.peer.dispersion
Metric Details
| Applicable for | Device |
| SNMP OID | NULL |
| Expression | NULL |
| Description | The estimated maximum error of the peer clock relative to the local clock over the network path between them, in seconds. [CISCO-NTP-MIB::cntpPeersPeerAddress - 1.3.6.1.4.1.9.9.168.1.2.1.1.3, cntpPeersDispersion - 1.3.6.1.4.1.9.9.168.1.2.1.1.25, cntpPeersPeerName - 1.3.6.1.4.1.9.9.168.1.2.1.1.31] |
| Category | SNMP Extended |
| Collector Type | Gateway |
| Monitor Name | Cisco NTP Peer Stats - Ext |
| Unit | s |
Possible Inputs
| Metric | Input Value | Range of Values |
|---|---|---|
| Frequency | 5 | 1 – 1440 (mins) |
| Filter | ||
| Warning Operator | ||
| Warning Threshold | ||
| Warning Repeat Count | ||
| Critical Operator | ||
| Critical Threshold | ||
| Critical Repeat Count | ||
| Alert | No | Yes/No |
| Graph (Yes/No) | Yes | Yes/No |
Sample Output
No graph
cisco.ntp.peer.root.delay
Metric Details
| Applicable for | Device |
| SNMP OID | NULL |
| Expression | NULL |
| Description | The total round-trip delay in seconds, from the peer to the primary reference source at the root of the synchronization subnet. [CISCO-NTP-MIB::cntpPeersPeerAddress - 1.3.6.1.4.1.9.9.168.1.2.1.1.3, cntpPeersRootDelay - 1.3.6.1.4.1.9.9.168.1.2.1.1.13, cntpPeersPeerName - 1.3.6.1.4.1.9.9.168.1.2.1.1.31] |
| Category | SNMP Extended |
| Collector Type | Gateway |
| Monitor Name | Cisco NTP Peer Stats - Ext |
| Unit | s |
Possible Inputs
| Metric | Input Value | Range of Values |
|---|---|---|
| Frequency | 5 | 1 – 1440 (mins) |
| Filter | ||
| Warning Operator | ||
| Warning Threshold | ||
| Warning Repeat Count | ||
| Critical Operator | ||
| Critical Threshold | ||
| Critical Repeat Count | ||
| Alert | No | Yes/No |
| Graph (Yes/No) | Yes | Yes/No |
Sample Output
No graph
cisco.ntp.peer.root.dispersion
Metric Details
| Applicable for | Device |
| SNMP OID | NULL |
| Expression | NULL |
| Description | The maximum error in seconds, of the peer clock relative to the primary reference source at the root of the synchronization subnet. [CISCO-NTP-MIB::cntpPeersPeerAddress - 1.3.6.1.4.1.9.9.168.1.2.1.1.3, cntpPeersRootDispersion - 1.3.6.1.4.1.9.9.168.1.2.1.1.14, cntpPeersPeerName - 1.3.6.1.4.1.9.9.168.1.2.1.1.31] |
| Category | SNMP Extended |
| Collector Type | Gateway |
| Monitor Name | Cisco NTP Peer Stats - Ext |
| Unit | s |
Possible Inputs
| Metric | Input Value | Range of Values |
|---|---|---|
| Frequency | 5 | 1 – 1440 (mins) |
| Filter | ||
| Warning Operator | ||
| Warning Threshold | ||
| Warning Repeat Count | ||
| Critical Operator | ||
| Critical Threshold | ||
| Critical Repeat Count | ||
| Alert | No | Yes/No |
| Graph (Yes/No) | Yes | Yes/No |
Sample Output
No graph
cisco.ntp.peer.mode
Metric Details
| Applicable for | Device |
| SNMP OID | NULL |
| Expression | NULL |
| Description | The association mode of the NTP server. Possible values and their descriptions are 0 - unspecified, 1 - symmetric active (A host operating in this mode sends periodic messages regardless of the reachability state or stratum of its peer. By operating in this mode the host announces its willingness to synchronize and be synchronized by the peer), 2 - symmetric passive (This type of association is ordinarily created upon arrival of a message from a peer operating in the symmetric active mode and persists only as long as the peer is reachable and operating at a stratum level less than or equal to the host; otherwise, the association is dissolved. However, the association will always persist until at least one message has been sent in reply. By operating in this mode the host announces its willingness to synchronize and be synchronized by the peer), 3 - client (A host operating in this mode sends periodic messages regardless of the reachability state or stratum of its peer. By operating in this mode the host, usually a LAN workstation, announces its willingness to be synchronized by, but not to synchronize the peer), 4 - server (This type of association is ordinarily created upon arrival of a client request message and exists only in order to reply to that request, after which the association is dissolved. By operating in this mode the host, usually a LAN time server, announces its willingness to synchronize, but not to be synchronized by the peer), 5 - broadcast (A host operating in this mode sends periodic messages regardless of the reachability state or stratum of the peers. By operating in this mode the host, usually a LAN time server operating on a high-speed broadcast medium, announces its willingness to synchronize all of the peers, but not to be synchronized by any of them), 6 - reserved for NTP control messages, 7 - reserved for private use. [CISCO-NTP-MIB::cntpPeersMode - 1.3.6.1.4.1.9.9.168.1.2.1.1.8] |
| Category | SNMP Extended |
| Collector Type | Gateway |
| Monitor Name | Cisco NTP Peer Stats - Ext |
| Unit |
Possible Inputs
| Metric | Input Value | Range of Values |
|---|---|---|
| Frequency | 5 | 1 – 1440 (mins) |
| Filter | ||
| Warning Operator | ||
| Warning Threshold | ||
| Warning Repeat Count | ||
| Critical Operator | ||
| Critical Threshold | ||
| Critical Repeat Count | ||
| Alert | No | Yes/No |
| Graph (Yes/No) | Yes | Yes/No |
Sample Output
No graph
cisco.ntp.peer.mode.change
Metric Details
| Applicable for | Device |
| SNMP OID | NULL |
| Expression | NULL |
| Description | It represents whether NTP Peer mode changed or not. Defined some custom states to alert when NTP Peer mode changed from one state to another state. Here are those custom states, 0 - MODE_NOT_CHANGED, 1 - MODE_CHANGED. And here are actual NTP Peer modes, 0 - unspecified, 1 - symmetricActive, 2 - symmetricPassive, 3 - client, 4 - server, 5 - broadcast, 6 - reservedControl, 7 - reservedPrivate. [CISCO-NTP-MIB::cntpPeersMode - 1.3.6.1.4.1.9.9.168.1.2.1.1.8] |
| Category | SNMP Extended |
| Collector Type | Gateway |
| Monitor Name | Cisco NTP Peer Stats - Ext |
| Unit |
Possible Inputs
| Metric | Input Value | Range of Values |
|---|---|---|
| Frequency | 5 | 1 – 1440 (mins) |
| Filter | ||
| Warning Operator | EQUAL | Ends with, ==, !=, >=, <=, >, <, In Range, Out of range, Equals, Not equals, Equals Ignore Case, Not Equals Ignore Case, Contains, Not contains, Regex match, Regex no match, In string list, Not in string list, In List, Not in list, Starts with |
| Warning Threshold | 1 | [{"0":"MODE_NOT_CHANGED"},{"1":"MODE_CHANGED"}] |
| Warning Repeat Count | 1 | 1-12 |
| Critical Operator | ||
| Critical Threshold | ||
| Critical Repeat Count | ||
| Alert | Yes | Yes/No |
| Graph (Yes/No) | Yes | Yes/No |
Sample Output
No graph
cisco.ntp.peer.org.time
Metric Details
| Applicable for | Device |
| SNMP OID | NULL |
| Expression | NULL |
| Description | The local time at the peer, when its latest NTP message was sent. This time is in seconds relative to 00:00 on 1 January 1900. If the peer becomes unreachable the value is set to zero. [CISCO-NTP-MIB::cntpPeersOrgTime - 1.3.6.1.4.1.9.9.168.1.2.1.1.17] |
| Category | SNMP Extended |
| Collector Type | Gateway |
| Monitor Name | Cisco NTP Peer Stats - Ext |
| Unit | s |
Possible Inputs
| Metric | Input Value | Range of Values |
|---|---|---|
| Frequency | 5 | 1 – 1440 (mins) |
| Filter | ||
| Warning Operator | ||
| Warning Threshold | ||
| Warning Repeat Count | ||
| Critical Operator | ||
| Critical Threshold | ||
| Critical Repeat Count | ||
| Alert | No | Yes/No |
| Graph (Yes/No) | Yes | Yes/No |
Sample Output
No graph