OpenWrt uCentral state schema
1 The unique ID of the configuration. This is the unix timestamp of when the config was created.
The unique serial number of the device.
This section describes the current state of the OS running on the device.
This array hold 3 values describing the average system load for the last 1, 5 and 15 minutes.
No Additional ItemsThis array hold the total and per core load in percentage.
No Additional ItemsThis property contains the current unix time of the device.
This section describes the current memory uasge of the device.
The amount of free memory.
The total amount of memory.
The total amount of cached memory.
The total amount of buffered memory.
The number of seconds since the unit last booted.
The average and maximum thermal reading from the CPU.
No Additional ItemsThis section describes the current state of the PoE unit on the device
Reports the total power available (power budget) (in watts, W) device's Power sourcing equipment is able to source.
Reports configured power alarm threshold value for the Power sourcing equipment (in milliwatts, mW).
Reports a total power Powered Devices are draining from the device's Power sourcing equipment (in milliwatts, mW).
Reports power status of the device's Power sourcing equipment.
"ON"
"OFF"
This section describes the global (device-wise) 802.1X (port access control) state and config applied.
This section describes the GPS location of the device.
The latitude in WGS84.
The longitude in WGS84.
The elevation above sea level in meters.
An array containing the runtime state of all logical interfaces.items
No Additional ItemsThe json-schema path within the configuration where this logical interface is located.
The number of seconds since the interface was brought up.
The administrative name of this logical interface. This field is freetext
VLAN-ID of the logical interface
Value must be lesser or equal to 4094
The upstream NTP server being used by this interface.
The list of remote DNS servers that this logical interface uses for domain name resolution.
No Additional ItemsThe list of IPv4 addresses being used by this logical interface.
No Additional ItemsAn IPv4 addreess.
The public IP address of internet connection.
This is the leasetime if the IPv4 address of this logical interface was acquired via DHCPv4.
The IPv4 address of the DHCPv4 server that assigned the active lease.
This section describes an IPv4 lease that we have served
The IPv4 that has been assigned to the networking client.
The unix time stamp when this lease was assigned.
The hostname that the client included in his request.
The MAC address of the client that this lease was assigned to.
An IPv6 address assigned to this logical interface.
The actual IPv6 address/mask
How much longer this delegation is valid for.
This section describes an IPv6 lease that we have served.
No Additional ItemsAn object, that describes a single served IPv6 address.
A list of all IPv6 addresses that were assigned to this host.
No Additional ItemsThe hostname that the client sent in its solicit message.
This section describes a network neighbour.
The MAC address of the neighbour.
The IPv4 addresses that the neighbour is known to use.
No Additional ItemsThe IPv4 addresses that the neighbour is known to use.
No Additional ItemsThe physical network devices that that the neighbour has been seen on.
No Additional ItemsHow long along was traffic from this neighbour last seen.
This section contains the traffic counters of the logical interface.
The number of bytes received.
The number of packets received.
The number of receive errors.
The number of received packets that were dropped.
The number of bytes transmitted.
The number of packets transmitted.
The number of transmit errors.
The number of transmitted packets that were dropped.
This section contains the traffic counters of the logical interface.
Same definition as countersThis section contains info about connected mesh nodes.
Detailed information about all multicast-related data (groups joined, src address used etc)
Detailed information about IGMP configured / joined multicast groups, outgoing interfaces etc.
List of joined IGMP multicast groups.
No Additional ItemsAddress of single group this interface is member of.
"225.0.0.1"
List of ports where multicast traffic of this group is being replicated to.
No Additional ItemsMVR statistics on interface
Shows if MVR traffic is being forwarded or discarded.
The number of IGMP membership reports received on this interface.
The number of leave messages received on this interface.
The number of general query messages received on this interface.
The number of group specific or group-and-source specific query messages received on this interface.
The number of times a report, leave, or query was dropped.
The number of times a multicast group was successfully joined.
The number of MVR groups active on this interface.
Represents the overall statistics for ACLs on the OLS device.
A list of ACL-related statistics, each corresponding to a specific interface or port.
No Additional ItemsThe identifier for the interface or port to which the ACL statistics apply.
Type of the access control list.
Indicates the action (permit or deny) taken when an ACL rule is matched.
The number of times an ACL rule has been matched by traffic.
Shows the percentage of this user-configured ACL rule as a percentage of total ACL rules.
Value must be greater or equal to 0 and lesser or equal to 100
Represents the overall resource utilization statistics for ACLs.
Percentage of total ACL consumed resources amongst the resources available.
Value must be greater or equal to 0 and lesser or equal to 100
State message entry to show the binding table for DHCP Snooping
List of DHCP Snooping binding entries
No Additional ItemsMAC address of the DHCP client in the DHCP Snooping binding table
IP address assigned to the MAC address in the DHCP Snooping binding table
This indicates the lease time in seconds for the IP address assigned to the DHCP client, after which the IP address may be reassigned
Specifies the type of binding entry, such as dynamic or static, indicating how the IP address was assigned to the client
VLAN ID associated with the DHCP client’s IP address, which helps in managing network segments
Value must be greater or equal to 1 and lesser or equal to 4094
Identifies the interface through which the DHCP client is connected, aiding in network topology management
"Ethernet1"
"Unit-1/Port-2"
"1-2"
"Trunk 1"
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^(eth|lan|wan)[0-9]*$ A list of all LLDP peers that this logical interface is connected to.
The device capabilities that our neighbour is announcing.
No Additional ItemsThe chassis description that our neighbour is announcing.
The chassis ID/MAC that our neighbour is announcing.
The management IPs that our neighbour is announcing.
No Additional ItemsThe physical network port that we see this neighbour on.
Provides information about the remote port, such as the interface name and its operational status on the neighboring device.
The identifier for the remote port connected to the local port, often displayed as a string or number representing the remote interface.
Specifies the type of identifier used for the remote port, such as MAC address, interface name, or ifIndex.
Shows the time-to-live (TTL) value for LLDP advertisements from the remote device. This is the duration (in seconds) the LLDP information remains valid before expiring."
Provides a textual description of the remote port, typically describing the interface or its purpose.
Displays the maximum transmission unit (MTU) size that the remote port supports, indicating the largest packet size the port can handle.
A textual description of the remote system, including the device model, software version, or any user-configured description.
Indicates the system capabilities advertised by the remote device, such as whether it supports routing, switching, bridging, etc.
No Additional ItemsDisplays the capabilities that are actually enabled on the remote device, such as routing, switching, or bridging functionality.
No Additional ItemsThe management IP address of the remote device, used to access the device for administrative purposes.
Shows the VLAN ID associated with the remote port, which could indicate the native VLAN or the port's trunk configuration.
Identifies any protocol-specific information (in HEX) advertised by the remote device, such as VLAN, Spanning Tree, or Link Aggregation protocol.
Displays the physical layer status of the remote port.
Indicates whether the remote port supports auto-negotiation of link parameters like speed and duplex settings.
Shows whether auto-negotiation is enabled on the remote port.
Lists the capabilities (in HEX) the remote port is advertising during auto-negotiation, such as supported speeds and duplex modes.
Displays the Media Access Unit (MAU) type, describing the port's physical characteristics (e.g., copper or fiber, 10/100/1000Base-T, etc.).
Provides detailed PoE information.
Indicates if the device is a PSE or a PD.
Indicates whether the remote device supports Media Dependent Interface (MDI) power supply, allowing power to be supplied through the Ethernet cable.
Shows whether MDI power is currently enabled on the remote port.
Displays whether the remote device has control over which wire pairs in the Ethernet cable provide power (important for PoE).
Displays the PoE class of the remote device, indicating its power consumption classification.
Provides information about the remote port’s involvement in Link Aggregation Groups (LAG), if applicable.
Indicates whether the remote port supports Link Aggregation (static or LACP).
Shows whether Link Aggregation is enabled on the remote port.
Displays the identifier of the Link Aggregation Group (LAG) that the remote port belongs to.
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^(eth|lan|wan)[0-9]*$ This section contains the traffic counters of the logical interface.
The number of bytes received.
The number of packets received.
The number of bytes transmitted.
The number of packets transmitted.
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^(eth|lan|wan)[0-9]*$ A list of all LLDP peers that this logical interface is connected to.
The physical interfaces carrier state.
The speed of the physical link.
The physical links duplex mode.
This section contains the traffic counters of the logical interface.
Same definition as countersThis section contains the traffic counters of the logical interface.
Same definition as countersThis section describes the ethernet poe-port link-state object (statistics + PD info). Present only in case if port has any Power sourcing capabilities.
Reports which PoE power class PD requested.
Reports which PoE power class PD has been assigned by the Power sourcing equipment.
Reports the power-value (in milliwatts, mW) poe-port's Powered Device is currently draining.
Reports the current value (in milliamps, mA) poe-port's Powered Device is currently draining.
Reports the operational voltage-level-value of poe-port's Power sourcing equipment (in Volts, V).
"54.14"
Reports the operational temperature of poe-port's Power sourcing equipment (in Celsius, C).
"22.5"
Reports the operational status of poe-port's Power sourcing equipment. Searching option - the poe-port's PSE is trying to detect a Powered Device. Delivering option - the poe-port's PSE is delivering power to a Powered Device. Disabled option - the poe-port's PSE is either disabled or PoE power is enabled but the PoE module does not have enough power available to supply the port's power needs. Fault option - the poe-port's PSE detects a problem with the Powered Device. Other Fault option - the PSE has detected an internal fault that prevents it from supplying power on that port.
"DELIVERING_POWER"
"DISABLED"
Reports the fault status of poe-port's PSE (in case if any).
"NO_ERROR"
PoE-related descriptive statistics (counters).
Displays the total number of power overload occurrences. (Powered Device is consuming more power than the maximum limit of a port)
Displays the total number of power shortage occurrences.
Displays the number of times that the powered device was denied power. (possible cause could be that Requested power exceeds PSE capability)
Displays the number of times that the power was stopped to the powered device because the powered device was no longer detected.
Displays the times that an invalid signature was received. Signatures are the means by which the powered device identifies itself to the PSE. Signatures are generated during powered device detection, classification, or maintenance.
This section describes the per-port specific 802.1X (port access control) link-state object (authenticated clients). Present only in case if port has enabled EAP processing and has any authenticated clients.
List of authenticated clients and (their) authentication data.
No Additional ItemsAuthentication method used by client for it's authentication.
MAC address of authenticated client.
Client session time.
Client username.
Vlan type of authenticated client (Authorization status of the client).
Vlan type of authenticated client (Authorization status of the client).
Value must be lesser or equal to 4095
Object holds information about underlying SFP module currently inserted into port's cage. Some of information is read directly from module's EEPROM, while other data is measured in runtime by device's hardware (vcc for example).
Vendor (name) identifier
Form-factor of the module itself (For example - QSFP28, QSFP56-DD etc)
Reports supported link modes of inserted module
No Additional ItemsModule's part number (vendor's specific)
Serial number of connected module
Module's HW revision (same part number can have multiple revisions)
Current module's temperature
Current module's transmit optical level (power)
Current module's receive optical level (power)
Max power (in Watts) module can drain.
Status and protocol information for loop detection or prevention mechanisms active on this interface. Includes STP/xSTP/MSTP, Loopback Detection (LBD), etc.
Spanning Tree Protocol (IEEE 802.1D/RSTP/MSTP) state on the port.
Variant of STP running (e.g., STP, RSTP, MSTP, RPVST+).
"RSTP"
"MSTP"
STP state of the port.
Role of the port in STP topology.
STP Bridge ID
STP Root Bridge ID for the instance.
Whether the port is operating as an edge port (no BPDU expected).
Operational path cost of the port.
Cost advertised by the designated port.
Number of STP state transitions (forwarding/discarding) on this port.
Loopback Detection (LBD) status on this port.
Whether LBD is enabled on this port.
Current loop detection status.
Action taken when loop is detected (e.g., block, shutdown).
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^(eth|lan|wan)[0-9]*$ A list of all LLDP peers that this logical interface is connected to.
Same definition as link-state_upstream_pattern1This section describes the global (device-wise) mac-address-list (FDB table / wired clients).
{
"overflow": true,
"Ethernet1": {
"1": [
"AABBCCDDEEFF",
"112233445566"
]
},
"Ethernet2": {
"10": [
"11BBCCDDEEFF",
"332233445566"
]
}
}
Flag indicates that device could report an amount of FDB entries, which is bigger than what cloud had requested.
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: array of stringVID (vlan id) identifier
No Additional ItemsList of statically created trunks.
Logical identifier for the trunk.
Value must be greater or equal to 1 and lesser or equal to 64
List of member ports under this static trunk.
No Additional ItemsList of dynamically created trunks.
Logical identifier for the trunk.
Value must be greater or equal to 1 and lesser or equal to 64
List of member ports under this trunk.
LACP System priority.
LACP port priority.
Port state.
Number of LACP Data Units (PDUs) sent.
Number of LACP Data Units (PDUs) received.
Number of Marker PDUs sent.
Number of Marker PDUs received.
Number of unknown packets received.
Number of illegal packets received.
Operational key for the port.
Operational key for the partner.
Operational state.
Operational state of the partner.
Current interface that serves as the Uplink. Example Ethernet2.
Statistics related to ARP Inspection activity in the switch.
Total number of ARP packets received.
Number of ARP packets dropped due to rate limiting.
Total number of ARP packets processed by ARP Inspection.
Number of ARP packets dropped due to source MAC address validation failures.
Number of ARP packets dropped due to destination MAC address validation failures.
Number of ARP packets dropped due to IP address validation failures."
Number of ARP packets dropped due to ARP ACL rules.
Number of ARP packets dropped due to DHCP snooping validation failures.
Represents the configuration and state of IP Source Guard.
Displays a list of entries that are currently blocked by IP Source Guard (IPSG).
No Additional ItemsThe MAC address that has been blocked by IP Source Guard.
The IP address that has been blocked by IP Source Guard.
The VLAN ID associated with the blocked IP/MAC entry.
Value must be greater or equal to 1 and lesser or equal to 4095
The interface (e.g., port) where the blocked entry was detected.
Global status and configuration of the Spanning Tree Protocol (STP) across the switch. Supports variants like STP, RSTP, MSTP. Includes bridge-wide parameters and protocol behavior.
Whether STP is enabled globally on the switch.
Operational STP mode used across the switch.
Maximum number of BPDUs that can be transmitted per hello time.
Indicates whether "Short" or "Long" path cost method is in use.
Maximum hop count used in MSTP.
List of STP instances (e.g., MSTP instances).
No Additional ItemsInstance number (for MSTP or multiple-instance support).