EdgeSwitch-SNTP-CLIENT-MIB

All MIBs › EdgeSwitch-SNTP-CLIENT-MIB

Organization: Broadcom Inc

Last Updated: 2011-12-14

Category: Protocol: SNTP/NTP, Technology: Time Synchronization, Vendor: EdgeSwitch/Ubiquiti

Description: Ubiquiti EdgeSwitch SNTP client MIB for managing Simple Network Time Protocol client configuration and synchronization 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 EdgeSwitch-SNTP-CLIENT-MIB?

EdgeSwitch-SNTP-CLIENT-MIB is a MIB for Ubiquiti EdgeSwitch devices (built on Broadcom's switch software stack) covering SNTP (Simple Network Time Protocol) client configuration and synchronization status, letting the switch keep its clock synchronized to an external time source. It exposes configuration data (client mode, port, supported modes, and configured server address/mode) alongside operational status data such as the last update time, last synchronization attempt time and its outcome, and details of the configured time server including its stratum and reference clock identifier. This is directly useful for monitoring the software status of the time-synchronization function on the switch: an administrator can confirm the switch's clock is actually synchronizing, catch repeated failed synchronization attempts, and verify which upstream time server and stratum the switch is using, which matters for accurate log timestamps and certificate validation across the network. It depends conceptually on the IETF SNTP/NTP protocol standards (RFC 4330/5905) that it is configuring a client for. It is typically deployed on Ubiquiti EdgeSwitch access/aggregation switches in SMB and campus network deployments. Engineers can download the EdgeSwitch-SNTP-CLIENT-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in EdgeSwitch-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

Ubiquiti EdgeSwitch

Monitoring Examples

An administrator would poll agentSntpClientLastUpdateTime and agentSntpClientLastAttemptStatus to confirm the switch's clock was recently and successfully synchronized, and would check agentSntpClientServerAddress, agentSntpClientServerStratum, and agentSntpClientServerRefClkId under agentSntpClientUnicast to see which time server it is using and how authoritative that source is. A stale agentSntpClientLastUpdateTime combined with a failed agentSntpClientLastAttemptStatus would reveal that the switch has lost contact with its configured SNTP server and its clock may be drifting. agentSntpClientMode and agentSntpClientPort would confirm the client is configured for the expected operating mode and port.

What Can Be Monitored

SNTP client mode/status
last synchronization time
last sync attempt result
configured time server address and stratum

Imported Objects

From EdgeSwitch-REF-MIB

fastPath

OBJECT-IDENTITY

From IF-MIB

InterfaceIndexOrZero

From INET-ADDRESS-MIB

InetAddress
InetAddressType
InetPortNumber

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 an Ubiquiti EdgeSwitch (Broadcom FastPath-based) switch (SNTP time synchronization) 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.4413.1.1.17			This MIB module defines a portion of the SNMP MIB under the Broadcom Inc enterprise OID pertaining to SNTP client configuration and statistical collection.
agentSntpClientObjects	1.3.6.1.4.1.4413.1.1.17.1
agentSntpClient	1.3.6.1.4.1.4413.1.1.17.1.1
INT agentSntpClientVersion	1.3.6.1.4.1.4413.1.1.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.4413.1.1.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.4413.1.1.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.4413.1.1.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.4413.1.1.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.4413.1.1.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.4413.1.1.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.4413.1.1.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.4413.1.1.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.4413.1.1.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.4413.1.1.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.4413.1.1.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.4413.1.1.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.4413.1.1.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.
agentSntpClientUnicast	1.3.6.1.4.1.4413.1.1.17.1.2
U32 agentSntpClientUnicastPollInterval	1.3.6.1.4.1.4413.1.1.17.1.2.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.4413.1.1.17.1.2.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.4413.1.1.17.1.2.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.4413.1.1.17.1.2.4	Unsigned32	read-only	The maximum number of server entries that are allowed in the agentSntpClientUcastServerTable.
G32 agentSntpClientUcastServerCurrEntries	1.3.6.1.4.1.4413.1.1.17.1.2.5	Gauge32	read-only	The current number of server entries in the agentSntpClientUcastServerTable.
agentSntpClientUcastServerTable	1.3.6.1.4.1.4413.1.1.17.1.2.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.4413.1.1.17.1.2.6.1		not-accessible	Information for a particular unicast SNTP server.
U32 agentSntpClientUcastServerIndex	1.3.6.1.4.1.4413.1.1.17.1.2.6.1.1	Unsigned32	not-accessible	This object uniquely identifies the entry in the table.
IPt agentSntpClientUcastServerAddressType	1.3.6.1.4.1.4413.1.1.17.1.2.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.4413.1.1.17.1.2.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.4413.1.1.17.1.2.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.4413.1.1.17.1.2.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.4413.1.1.17.1.2.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.4413.1.1.17.1.2.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.4413.1.1.17.1.2.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.4413.1.1.17.1.2.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.4413.1.1.17.1.2.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.4413.1.1.17.1.2.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.4413.1.1.17.1.2.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.4413.1.1.17.1.3
C32 agentSntpClientBroadcastCountEx	1.3.6.1.4.1.4413.1.1.17.1.3.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.4413.1.1.17.1.3.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.
agentSntpClientConformance	1.3.6.1.4.1.4413.1.1.17.2
agentSntpClientGroups	1.3.6.1.4.1.4413.1.1.17.2.1
agentSntpClientDeviceGroup	1.3.6.1.4.1.4413.1.1.17.2.1.1			A collection of objects providing device level control of an SNTP client on EdgeSwitch enabled devices.
agentSntpClientUnicastGroup	1.3.6.1.4.1.4413.1.1.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.4413.1.1.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.4413.1.1.17.2.2
agentSntpClientCompliance	1.3.6.1.4.1.4413.1.1.17.2.2.1			The compliance statement for devices that support agentSntpClient.

RFC description

SNTP (Simple Network Time Protocol) client configuration for EdgeSwitch, managing time synchronization with NTP servers.

Start monitoring Ubiquiti EdgeSwitch (Broadcom FastPath-based) switch (SNTP time synchronization) 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 EdgeSwitch-SNTP-CLIENT-MIB