SNTP-CLIENT-MIB

All MIBs › SNTP-CLIENT-MIB

Organization: Quanta Computer Inc.

Last Updated: 2011-08-31

Category: GPS and Network Timing

Description: Manages Quanta Computer SNTP client time synchronization configuration, server selection, and clock status.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is SNTP-CLIENT-MIB?

SNTP-CLIENT-MIB is a vendor-specific MIB published under the Quanta Computer Inc. enterprise OID, defining SNTP (Simple Network Time Protocol) client configuration and status objects for time synchronization on Quanta-based network devices, commonly white-box switches. It exposes the client's supported/configured SNTP modes, version, port, configured server addresses and their stratum/reference-clock information, and status of the client's most recent synchronization attempts. In monitoring terms this MIB is a software/clock-health module: it lets an operator confirm the device's clock is being kept in sync by comparing the last successful update time against the last attempt time and status, catching cases where time sync has silently failed, which can cause log-timestamp and certificate-validation problems elsewhere on the device. It builds on the IETF SNTP/NTP protocol concepts (RFC 4330 and related) it exposes via SNMP. It is deployed on Quanta-manufactured switches/servers where administrators need to verify clock synchronization health via SNMP rather than CLI/logs alone, and administrators referencing the SNTP-CLIENT-MIB MIB can quickly confirm which objects are available for this purpose.

IPNetwork Monitor allows you to monitor SNMP objects defined in SNTP-CLIENT-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Quanta Computer network switch/server
white-box/ODM switching hardware using Quanta's agent

Monitoring Examples

An operator would poll agentSntpClientLastUpdateTime and agentSntpClientLastAttemptStatus to confirm the device successfully synchronized time recently, and check agentSntpClientServerAddress/agentSntpClientServerStratum to verify which time server is in use and its quality. If agentSntpClientLastAttemptStatus reports a failure while agentSntpClientLastUpdateTime grows stale, that indicates the configured SNTP server is unreachable and the device's clock is drifting. Checking agentSntpClientMode and agentSntpClientPort confirms the client is configured correctly, e.g., unicast vs. broadcast mode, to reach its time source. This MIB is essential for catching clock-drift issues before they cause downstream log or authentication problems.

What Can Be Monitored

SNTP client mode and version
configured time server address and stratum
last successful update time
last synchronization attempt status
SNTP client port configuration

Imported Objects

From IF-MIB

InterfaceIndexOrZero

From INET-ADDRESS-MIB

InetAddress
InetAddressType
InetPortNumber

From QUANTA-SWITCH-MIB

quanta	MODULE-IDENTITY
switch	OBJECT-IDENTITY

From RFC1213-MIB

DisplayString
PhysAddress

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Gauge32
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

DateAndTime
RowStatus
TEXTUAL-CONVENTION

How to Use in IPNetwork Monitor

Example using agentSntpClientBroadcastCount OID:

Select a Quanta Computer network switch/server, white-box/ODM switching hardware (SNTP client sync status) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type agentSntpClientBroadcastCount into the Find box to locate it in the OID tree, then select it and click OK. The number of unsolicited broadcast SNTP messages that have been received and processed by the SNTP client. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
agentSntpClientMIB	1.3.6.1.4.1.7244.2.17			This MIB module defines a portion of the SNMP MIB under the Quanta Computer Inc. enterprise OID pertaining to SNTP client configuration and statistical collection.
agentSntpClientObjects	1.3.6.1.4.1.7244.2.17.1
agentSntpClient	1.3.6.1.4.1.7244.2.17.1.1
INT agentSntpClientVersion	1.3.6.1.4.1.7244.2.17.1.1.1	INTEGER	read-only	The highest SNTP version this client supports. Per RFC 2030, higher versions are required to be backwards compatible with all lower versions with the exception of version 0.
SNT agentSntpClientSupportedMode	1.3.6.1.4.1.7244.2.17.1.1.2	SntpClientAdminMode	read-only	The SNTP client administrative modes that this device supports. A client may support more than one administrative mode.
INT agentSntpClientMode	1.3.6.1.4.1.7244.2.17.1.1.3	INTEGER	read-write	The current administrative mode of the SNTP client. A SET of this object will cause the SNTP client to change administrative modes. A SET request MUST have only 1 bit set since is not possible to operate in multiple modes simultaneously. SETs of this object are limited to values supported by the device as specified by agentSntpClientSupportedMode.
INE agentSntpClientPort	1.3.6.1.4.1.7244.2.17.1.1.4	InetPortNumber	read-write	The local port number used to listen for broadcasts and responses from servers.
DAT agentSntpClientLastUpdateTime	1.3.6.1.4.1.7244.2.17.1.1.5	DateAndTime	read-only	The local date and time that the SNTP client last updated the system time on the device since agent reboot. This time is updated for all non-disabled administrative modes of the SNTP client. If the SNTP client has not updated the time then the client MUST return '00000000'H.
DAT agentSntpClientLastAttemptTime	1.3.6.1.4.1.7244.2.17.1.1.6	DateAndTime	read-only	The local date and time of the last SNTP request or unsolicited SNTP message for this SNTP client since agent reboot. This value is a timestamp for the agentSntpClientLastAttemptStatus object. When the agentSntpClientLastAttemptStatus has a value of success(2), this object's value should be equal to the value returned by agentSntpClientLastUpdateTime. If no SNTP frames have been processed by the SNTP client then the client MUST return '00000000'H. This object is updated for all non-disabled administrative modes of the SNTP client.
SNT agentSntpClientLastAttemptStatus	1.3.6.1.4.1.7244.2.17.1.1.7	SntpClientUpdateStatus	read-only	The status of the last SNTP request or unsolicited SNTP message for this SNTP client since agent reboot. The status is updated for all non-disabled administrative modes of the SNTP client.
IPt agentSntpClientServerAddressType	1.3.6.1.4.1.7244.2.17.1.1.8	InetAddressType	read-only	The address type of the SNTP server as identified by the last received packet. Support for all address types is NOT REQUIRED.
IP agentSntpClientServerAddress	1.3.6.1.4.1.7244.2.17.1.1.9	InetAddress	read-only	The encoded address of the SNTP server as identified by the last received packet.
U32 agentSntpClientServerMode	1.3.6.1.4.1.7244.2.17.1.1.10	Unsigned32	read-only	This is a 3-bit integer identifying the mode of the server as indicated in the last received packet with values defined as follows: Mode Meaning ------------------------------------ 0 reserved 1 symmetric active 2 symmetric passive 3 client 4 server 5 broadcast 6 reserved for NTP control message 7 reserved for private use
U32 agentSntpClientServerStratum	1.3.6.1.4.1.7244.2.17.1.1.11	Unsigned32	read-only	This is an 8-bit integer identifying the stratum of the server as indicated in the last received packet with values defined as follows: Stratum Meaning ------------------------------------ 0 unspecified 1 primary reference 2-15 secondary reference 16-255 reserved
OCT agentSntpClientServerRefClkId	1.3.6.1.4.1.7244.2.17.1.1.12	OCTET STRING	read-only	This is the value of the Reference Identifier in the last received packet defined as follows. Reference Identifier: This is a 32-bit bitstring identifying the particular reference source. In the case of NTP Version 3 or Version 4 stratum-0 (unspecified) or stratum-1 (primary) servers, this is a four-character ASCII string, left justified and zero padded to 32 bits. In NTP Version 3 secondary servers, this is the 32-bit IPv4 address of the reference source. In NTP Version 4 secondary servers, this is the low order 32 bits of the latest transmit timestamp of the reference source.
U32 agentSntpClientPollInterval	1.3.6.1.4.1.7244.2.17.1.1.13	Unsigned32	read-write	The minimum number of seconds between successive SNTP polls of the server in seconds as a power of two. This polling interval is used for SNTP requests in unicast(1) or broadcast(2) administrative mode.
NUM agentSntpClientSourceInterface	1.3.6.1.4.1.7244.2.17.1.1.14	InterfaceIndexOrZero	read-write	A source-interface selection on an Interface Index (like vlan based routing interface, port based routing interface, loopback interface, tunnel interface). A non-zero value indicates ifIndex for the corresponding interface entry in the ifTable is selected. A zero value indicates the source-interface un-selection.
agentSntpClientTimeZone	1.3.6.1.4.1.7244.2.17.1.2
STR agentSNTPConfigTimeZoneName	1.3.6.1.4.1.7244.2.17.1.2.1	DisplayString	read-write	Name of timezone in which the SNTP client locates, usually an acronym.
INT agentSNTPConfigTimeZoneTimeOffsetHour	1.3.6.1.4.1.7244.2.17.1.2.2	INTEGER	read-write	Time offset of the timezone in which the SNTP client locates.
U32 agentSNTPConfigTimeZoneTimeOffsetMinute	1.3.6.1.4.1.7244.2.17.1.2.3	Unsigned32	read-write	Time offset of the timezone in which the SNTP client locates.
INT agentSNTPConfigTimeZoneUTCArea	1.3.6.1.4.1.7244.2.17.1.2.4	INTEGER	read-write	UTC timezone of the SNTP client.
agentSntpClientUnicast	1.3.6.1.4.1.7244.2.17.1.3
U32 agentSntpClientUnicastPollInterval	1.3.6.1.4.1.7244.2.17.1.3.1	Unsigned32	read-write	The minimum number of seconds between successive SNTP polls of the server in seconds as a power of two. This polling interval is used for SNTP requests in unicast(1) administrative mode.
U32 agentSntpClientUnicastPollTimeout	1.3.6.1.4.1.7244.2.17.1.3.2	Unsigned32	read-write	The number of seconds to wait for a response from a SNTP server before considering the attempt to have 'timed out'. This timeout is used for SNTP requests in unicast(1) administrative mode.
U32 agentSntpClientUnicastPollRetry	1.3.6.1.4.1.7244.2.17.1.3.3	Unsigned32	read-write	The number of times to retry a request to the same SNTP server that has 'timed out.'. This retry count is used for directed SNTP requests in unicast(1) administrative mode. For example, assume this object has been SET to a value of 2. When the SNTP client queries a given server it will send 1 SNTP request frame. If that original attempt fails, the client will retry up to a maximum of 2 more times before declaring the unicast poll unsuccessful and attempting the next server.
U32 agentSntpClientUcastServerMaxEntries	1.3.6.1.4.1.7244.2.17.1.3.4	Unsigned32	read-only	The maximum number of server entries that are allowed in the agentSntpClientUcastServerTable.
G32 agentSntpClientUcastServerCurrEntries	1.3.6.1.4.1.7244.2.17.1.3.5	Gauge32	read-only	The current number of server entries in the agentSntpClientUcastServerTable.
agentSntpClientUcastServerTable	1.3.6.1.4.1.7244.2.17.1.3.6		not-accessible	A table containing configuration and statistical information for unicast SNTP servers. Each server entry is represented by single conceptual row in this table.
agentSntpClientUcastServerEntry	1.3.6.1.4.1.7244.2.17.1.3.6.1		not-accessible	Information for a particular unicast SNTP server.
U32 agentSntpClientUcastServerIndex	1.3.6.1.4.1.7244.2.17.1.3.6.1.1	Unsigned32	not-accessible	This object uniquely identifies the entry in the table.
IPt agentSntpClientUcastServerAddressType	1.3.6.1.4.1.7244.2.17.1.3.6.1.2	InetAddressType	read-create	This object specifies how agentSntpClientUcastServerAddr is encoded. Support for all possible enumerations defined by InetAddressType is NOT REQUIRED.
IP agentSntpClientUcastServerAddress	1.3.6.1.4.1.7244.2.17.1.3.6.1.3	InetAddress	read-create	The encoded internet address of an SNTP server. Unicast SNTP requests will be sent to this address. If this address is a DNS hostname, then that hostname SHOULD be resolved into an IP address each time a SNTP request is sent to it.
INE agentSntpClientUcastServerPort	1.3.6.1.4.1.7244.2.17.1.3.6.1.4	InetPortNumber	read-create	The port number on the server to which poll requests are sent. A set request MUST NOT use a value of 0 for this object.
INT agentSntpClientUcastServerVersion	1.3.6.1.4.1.7244.2.17.1.3.6.1.5	INTEGER	read-create	The SNTP version this server supports. This is the value that will be encoded in NTP polls when operating in unicast(1) administrative mode.
U32 agentSntpClientUcastServerPrecedence	1.3.6.1.4.1.7244.2.17.1.3.6.1.6	Unsigned32	read-create	The precedence that this server has in relation to its peers in the determining the sequence of servers to which SNTP requests will be sent. The client continues sending requests to different servers until a successful response is received or all servers are exhausted. This object indicates the order in which to query the servers. A server entry with a precedence of 1 will be queried before a server with a precedence of 2, and so forth. If more than one server has the same precedence then the request order will follow the lexicographical ordering of the entries in this table.
DAT agentSntpClientUcastServerLastUpdateTime	1.3.6.1.4.1.7244.2.17.1.3.6.1.7	DateAndTime	read-only	The local date and time that the response from this server was used to update the system time on the device since agent reboot. If the SNTP client has not updated the time using a response from this server then this object MUST return '00000000'H.
DAT agentSntpClientUcastServerLastAttemptTime	1.3.6.1.4.1.7244.2.17.1.3.6.1.8	DateAndTime	read-only	The local date and time that this SNTP server was last queried since agent reboot. Essentially, this value is a timestamp for the agentSntpClientUcastServerLastAttemptStatus object. If this server has not been queried then this object MUST return '00000000'H.
SNT agentSntpClientUcastServerLastAttemptStatus	1.3.6.1.4.1.7244.2.17.1.3.6.1.9	SntpClientUpdateStatus	read-only	The status of the last SNTP request to this server since agent reboot. If no requests have been made then this object should return 'other'.
C32 agentSntpClientUcastServerNumRequests	1.3.6.1.4.1.7244.2.17.1.3.6.1.10	Counter32	read-only	The number of SNTP requests made to this server since the last agent reboot. This includes retry attempts to the server.
C32 agentSntpClientUcastServerNumFailedRequests	1.3.6.1.4.1.7244.2.17.1.3.6.1.11	Counter32	read-only	The number of SNTP requests made to this server that did not result in a successful response since the last agent reboot. This includes retry attempts to the server.
ROW agentSntpClientUcastServerRowStatus	1.3.6.1.4.1.7244.2.17.1.3.6.1.12	RowStatus	read-create	The row status of this conceptual row in the table. active - The server is available for use in SNTP client operations. Other writable leaves in this table MAY be modified while the row is in the active state. notInService - The entry is fully configured but is not available for use in SNTP client operations. The agent MAY transition a row from the active to notInService upon receipt of a kiss of death packet from the server. createAndGo - This is the preferred mechanism for creating conceptual rows in this table. This value can never be read as the row will always transition immediately to either active or notInService. destroy - This will remove the conceptual row from the table and make it unavailable for SNTP client operations.
agentSntpClientBroadcast	1.3.6.1.4.1.7244.2.17.1.4
C32 agentSntpClientBroadcastCountEx	1.3.6.1.4.1.7244.2.17.1.4.1	Counter32	read-only	The number of unsolicited broadcast SNTP messages that have been received and processed by the SNTP client. Unsolicited SNTP broadcast frames will not be counted unless the SNTP agent is operating in broadcast(3) mode, as specified by agentSntpClientMode.
U32 agentSntpClientBroadcastInterval	1.3.6.1.4.1.7244.2.17.1.4.2	Unsigned32	read-write	The number of seconds the client will wait before processing another broadcast packet expressed as a power of two. Packets received during the wait interval are silently discarded.
agentSntpClientMulticast	1.3.6.1.4.1.7244.2.17.1.5
C32 agentSntpClientMulticastCount	1.3.6.1.4.1.7244.2.17.1.5.1	Counter32	read-only	The number of unsolicited multicast SNTP messages that have been received and processed by the SNTP client. Unsolicited SNTP multicast frames will not be counted unless the SNTP agent is operating in multicast(4) mode, as specified by agentSntpClientMode.
U32 agentSntpClientMulticastInterval	1.3.6.1.4.1.7244.2.17.1.5.2	Unsigned32	read-write	The number of seconds the client will wait before processing another multicast packet expressed as a power of two. Packets received during the wait interval are silently discarded.
agentSntpClientConformance	1.3.6.1.4.1.7244.2.17.2
agentSntpClientGroups	1.3.6.1.4.1.7244.2.17.2.1
agentSntpClientDeviceGroup	1.3.6.1.4.1.7244.2.17.2.1.1			A collection of objects providing device level control of an SNTP client on enabled devices.
agentSntpClientUnicastGroup	1.3.6.1.4.1.7244.2.17.2.1.2			A collection of objects providing control and statistics for an SNTP client capable of operating in unicast mode.
agentSntpClientBroadcastGroup	1.3.6.1.4.1.7244.2.17.2.1.3			A collection of objects providing control and statistics for an SNTP client capable of operating in broadcast mode.
agentSntpClientCompliances	1.3.6.1.4.1.7244.2.17.2.2
agentSntpClientCompliance	1.3.6.1.4.1.7244.2.17.2.2.1			The compliance statement for devices that support agentSntpClient.

RFC description

SNTP client configuration and statistics for NTP time synchronization on network devices.

Start monitoring Quanta Computer network switch/server, white-box/ODM switching hardware (SNTP client sync status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download SNTP-CLIENT-MIB