Release 5.0 of CENTAURI's software includes a major upgrade to the monitoring and alerting capabilities of our SNMP implementation. To get the latest MIB file for CENTAURI SNMP please go to CENTAURI | Monitoring Performance with SNMP.
The MIB file contains a header section that provides information on resources where you can find out more about SNMP and reference implementations of SNMP, as well as resources to assist you with customising or writing your own MIBs.
TCT-SNMP-MIB DEFINITIONS ::= BEGIN
--
-- https://tools.ietf.org/html/rfc3584
--
-- Example MIB objects for agent module example implementations
-- http://net-snmp.sourceforge.net/wiki/index.php/Writing_your_own_MIBs
-- http://net-snmp.sourceforge.net/docs/mibs/NET-SNMP-MIB.txt
-- http://net-snmp.sourceforge.net/docs/mibs/NET-SNMP-EXAMPLES-MIB.txt
-- Run `snmptranslate -On TCT-SNMP-MIB::tctSnmpRxPwr` to get the address for a measurement
-- This may be helpful to you if you’re curious to find out more about how SNMP works or you need to customise the MIB file for CENTAURI further, to suit your specific needs.
The next two sections of the MIB file provide information on what kind of object the file is, as well as the identify of the organisation and a description of the contents and functionality of the file.
IMPORTS
OBJECT-TYPE, Integer32,
MODULE-IDENTITY, enterprises FROM SNMPv2-SMI;
tctSnmp MODULE-IDENTITY
LAST-UPDATED "202303310000Z"
ORGANIZATION "transcelestial.org"
CONTACT-INFO
"
postal: #06-04 101 Eunos Ave 3,
409835, Singapore
email: [email protected]
"
DESCRIPTION
"MIB objects for Centauri SNMP queries"
REVISION "202303310000Z"
DESCRIPTION
"Released"
::= { enterprises 54505 }The rest of the file contains definitions of all of the metrics - called “Measurements” - and alerts and alarms (a.k.a. “Traps”), which are supported by Transcelestial for CENTAURI devices.
The table below will help you understand what each Measurement and Trap actually does.
Measurements | MIB contents | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Object Identifier | tctSnmpMeasurements OBJECT IDENTIFIER ::= { tctSnmp 1 } | Note that these are measurements reported by the device via SNMP. The base for OID's for Transcelestial monitoring items is .1.3.6.1.4.1.54505.1 | |||||||||
Rx Power | tctSnmpRxPwr OBJECT-TYPE ::= { tctSnmpMeasurements 1 } | Retrieves and reports the amount of laser power being received by the device over the laser link, in dBm. Receive Power and Link Status (below) are the two prime metrics for laser link health.
The recommended SNMP Polling Interval is 1 minute. OID is: .1.3.6.1.4.1.54505.1.1 Example Data is: "-14.10" | |||||||||
Link Status | tctSnmpLinkStatus OBJECT-TYPE | Reports whether the laser link is up (1) or down (0). The recommended SNMP Polling Interval is 1 minute. OID is: .1.3.6.1.4.1.54505.1.2 Example Data is: 1 | |||||||||
Tx Power | tctSnmpTxPwr OBJECT-TYPE | Retrieves and reports the amount of laser power being sent by the device over the laser link, in dBm. The minimum Tx Power for both 1G and 10G is -10 dBm. The recommended SNMP Polling Interval is 1 minute. OID is: .1.3.6.1.4.1.54505.1.3 Example Data is: "2.00" | |||||||||
Rx Min Power | tctSnmpRxMinPwr OBJECT-TYPE | Reports the lowest laser receive power measurement in dBm in the last one (1) minute. As the polling interval for Rx Power (above) is 1 minute, short drops in Rx may not appear. This metric will capture if there was a short drop within the polling interval. The recommended SNMP Polling Interval is 1 minute. OID is: .1.3.6.1.4.1.54505.1.4 Example Data is: "-18.57" | |||||||||
Humidity | tctSnmpHumidity OBJECT-TYPE | Reports the current humidity as a percentage (%), as measured from inside the device. The humidity and window heater status settings below can be used to determine if condensation is potentially an issue affecting the laser signal. The recommended SNMP Polling Interval is 15 minutes. OID is: .1.3.6.1.4.1.54505.1.5 Example Data is: "29.52" | |||||||||
Window Heater Temperature | tctSnmpWindowTemp OBJECT-TYPE | Measures the current temperature in degrees Centigrade (C°) of the window heater The recommended SNMP Polling Interval is 15 minutes. OID is: .1.3.6.1.4.1.54505.1.6 Example Data is: "34.75" | |||||||||
Window heater status | tctSnmpHeaterOn OBJECT-TYPE | Reports whether the window heater is switched “on” (1) or “off” (0). The recommended SNMP Polling Interval is 5 minutes. OID is: .1.3.6.1.4.1.54505.1.7 Example Data is: 1 | |||||||||
Window heater auto on/off status | tctSnmpHeaterAuto OBJECT-TYPE | Indicates whether or not the window heater power is controlled automatically by CENTAURI’s software (1) or not (0) The recommended SNMP Polling Interval is 5 minutes. OID is: .1.3.6.1.4.1.54505.1.8 Example Data is: 1 | |||||||||
Laser absolute position | tctSnmpPosition OBJECT-TYPE | Reports the absolute position of the laser stabilisation platform as a JSON string. The recommended SNMP Polling Interval is 5 minutes. OID is: .1.3.6.1.4.1.54505.1.9 Example Data is: "{\"pitch\" : 0.0989, \"yaw\" : -0.5164}" | |||||||||
Vibration alert | tctSnmpVibrationAlert OBJECT-TYPE | If the device is experiencing excessive vibration this value is 1. If vibration is within normal parameters the value is 0. A value of 1 indicates the vibration may cause degradation or loss of signal. This can be correlated with Rx Power and Link Status to help determine a cause for loss of signal. The recommended SNMP Polling Interval is 5 minutes. OID is: .1.3.6.1.4.1.54505.1.10 Example Data is: 0 | |||||||||
Vibration value OID is: .1.3.6.1.4.1.54505.1.9 Example Data is: "{\"pitch\" : 0.0989, \"yaw\" : -0.5164}" | tctSnmpVibrationValue OBJECT-TYPE | Reports the measurement of the vibration being experienced by the device at the time of polling as a JSON string. Specifically, it shows:
The recommended SNMP Polling Interval is 5 minutes. OID is: .1.3.6.1.4.1.54505.1.11 Example Data is: "{\"datetime\":\"2023-08-08T04:24:40.58Z\",\"state\":577044683, \"stdx\":0.10881336033344269,\"stdy\":0.1302172690629959, \"stdz\":0.15289151668548584,\"mmrx\":0.5283491015434265, \"mmry\":0.680962085723877,\"mmrz\":0.6485652327537537}" | |||||||||
Correction vector alert | tctSnmpCorrectionAlert OBJECT-TYPE | This has a value of 1 if the laser correction vector is excessive or a value of 0 if normal. A value of 1 indicates a large amount of corrections are having to be performed to the laser pointing to maintain a signal. This may cause degradation or loss of signal. This can be correlated with Rx Power and Link Status to help determine a cause for loss of signal. The recommended SNMP Polling Interval is 5 minutes. OID is: .1.3.6.1.4.1.54505.1.12 Example Data is: 0 | |||||||||
Correction vector value | tctSnmpCorrectionValue OBJECT-TYPE | Reports the current correction vector (CV) value at the time of polling as a JSON string. The CV indicates how much CENTAURI’s stabilisation platform needs to compensate for vibrations caused by pole/tower sway, scintillation, and rain. The recommended SNMP Polling Interval is 5 minutes. OID is: .1.3.6.1.4.1.54505.1.13 Example Data is: "{\"datetime\":\"2023-08-07T05:40:53.083Z\",\"hcv\":false,\"x\":2.324981689453125, \"y\":-1.4189453125}" | |||||||||
| External Rx Power | tctSnmpSfpRx OBJECT-TYPE SYNTAX DISPLAYSTRING MAX-ACCESS read-only STATUS current DESCRIPTION "The receive power in Dbm for the external Sfp" ::= { tctSnmpMeasurements 15 } | Retrieves and reports the amount of power being received by the device through the external Sfp in dBm. This is the optical signal that is external to the device. The recommended SNMP Polling Interval is 1 minute. OID is: .1.3.6.1.4.1.54505.1.15 Example Data is: "-11.20" Note this metric is available from Centauri v5.7.1 onwards | |||||||||
| External Tx Power | tctSnmpSfpTx OBJECT-TYPE SYNTAX DISPLAYSTRING MAX-ACCESS read-only STATUS current DESCRIPTION "The transmit power in Dbm for the external Sfp" ::= { tctSnmpMeasurements 16 } | Retrieves and reports the amount of power being sent by the device over the external Sfp link in dBm. This is the optical signal that is external to the device. The recommended SNMP Polling Interval is 1 minute. OID is: .1.3.6.1.4.1.54505.1.16 Example Data is: "3.00" Note this metric is available from Centauri v5.7.1 onwards. |
Traps | MIB Contents | Description |
|---|---|---|
Object Identifier | tctTraps OBJECT IDENTIFIER ::= { tctSnmp 2 } | Denotes that these are alarms (traps) sent by CENTAURI using SNMP. The base OID for Transcelestial traps is: .1.3.6.1.4.1.54505.2 |
Link Down | tctLaserLinkDown NOTIFICATION-TYPE | Sends a notification that the laser link is down. Trap OID is: .1.3.6.1.4.1.54505.2.1 Example Data is: DISMAN-EVENT-MIB::sysUpTimeInstance = 155593112 SNMPv2-MIB::snmpTrapOID.0 = TCT-SNMP-MIB::tctLaserLinkDown SNMPv2-MIB::sysName.0 = CEN010-2022081100707 TCT-SNMP-MIB::tctSnmpRxPwr = "-25.69" |
BA | tctTrigger NOTIFICATION-TYPE | No longer in use. |
Link Up | tctLaserLinkUp NOTIFICATION-TYPE | Sends a notification that the link is up, after recovering from “link down.” Trap OID is: .1.3.6.1.4.1.54505.2.3 Example Data is: DISMAN-EVENT-MIB::sysUpTimeInstance = 155593012 SNMPv2-MIB::snmpTrapOID.0 = TCT-SNMP-MIB::tctLaserLinkUp SNMPv2-MIB::sysName.0 = CEN010-202208110707 TCT-SNMP-MIB::tctSnmpRxPwr = "-10.73" |
High vibration | tctHighVibration NOTIFICATION-TYPE | Sends a notification that device is experiencing excessive vibration. This may cause degradation and loss of laser signal. Trap OID is: .1.3.6.1.4.1.54505.2.4 Example Data is: DISMAN-EVENT-MIB::sysUpTimeInstance = 60022558 SNMPv2-MIB::snmpTrapOID.0 = TCT-SNMP-MIB::tctHighVibration SNMPv2-MIB::sysName.0 = CEN010-20221160707 TCT-SNMP-MIB::tctSnmpVibrationValue = "{"datetime":"2023-08-08T05:29:45.845Z", "state":577044682,"stdx":0.1345088928937912, "stdy":0.1716584712266922,"stdz":0.4648973345756531, "mmrx":0.6035639643669128,"mmry":1.1300928592681885,"mmrz":3.3235011100769043}" |
Normal vibration | tctNormalVibration NOTIFICATION-TYPE | Sends a notification that vibration has subsided and returned to a normal operating range. Trap OID is: .1.3.6.1.4.1.54505.2.5 Example Data is: DISMAN-EVENT-MIB::sysUpTimeInstance = 60021958 SNMPv2-MIB::snmpTrapOID.0 = TCT-SNMP-MIB::tctNormalVibration SNMPv2-MIB::sysName.0 = CEN010-202211160707 TCT-SNMP-MIB::tctSnmpVibrationValue = "{"datetime":"2023-08-08T05:29:39.841Z","state":577044683,"stdx":0.12468241900205612, "stdy":0.12943097949028015,"stdz":0.18748143315315247, "mmrx":0.6285136938095093,"mmry":0.6514159440994263,"mmrz":0.9068710207939148}" |
Low disk space | tctLowDiskSpace NOTIFICATION-TYPE | Sends a notification that device disk space is low. This trap is sent once free disk space falls below 30%. Trap OID is: .1.3.6.1.4.1.54505.2.6 Example Data is: DISMAN-EVENT-MIB::sysUpTimeInstance = 276030 SNMPv2-MIB::snmpTrapOID.0 = TCT-SNMP-MIB::tctLowDiskSpace SNMPv2-MIB::sysName.0 = CEN010-202208080707 UCD-SNMP-MIB::dskPath.1 = / UCD-SNMP-MIB::dskErrorMsg.1 = /: less than 30% free (= 29%) |
CPU Utilisation | tctHighCPU NOTIFICATION-TYPE | Sends a notification that CPU utilisation on the device is high, which may affect laser link performance. Trap OID is: .1.3.6.1.4.1.54505.2.7 Example Data is: DISMAN-EVENT-MIB::sysUpTimeInstance = 1588518 SNMPv2-MIB::snmpTrapOID.0 = TCT-SNMP-MIB::tctHighCPU SNMPv2-MIB::sysName.0 = CEN010-202208230707 UCD-SNMP-MIB::laNames.3 = Load-15 UCD-SNMP-MIB::laErrMessage.3 = 15 min Load Average too high (= 5.03) |
High correction vector | tctHighCorrection NOTIFICATION-TYPE | Sends a notification that the size and frequency of corrections to laser pointing are out of bounds. This may cause degradation and loss of laser signal. Trap OID is: .1.3.6.1.4.1.54505.2.8 Example Data is: DISMAN-EVENT-MIB::sysUpTimeInstance = 1030 SNMPv2-MIB::snmpTrapOID.0 = TCT-SNMP-MIB::tctHighCorrection SNMPv2-MIB::sysName.0 = CEN010-202111010707 TCT-SNMP-MIB::tctSnmpCorrectionValue = "{"datetime":"2023-07-25T03:13:30.508Z","hcv":true,"x":-17.57208251953125,"y":-6.8432769775390625}" |
Normal correction vector | tctNormalCorrection NOTIFICATION-TYPE | Sends a notification that correction vector readings have returned to normal Trap OID is: .1.3.6.1.4.1.54505.2.9 Example Data is: DISMAN-EVENT-MIB::sysUpTimeInstance = 292 SNMPv2-MIB::snmpTrapOID.0 = TCT-SNMP-MIB::tctNormalCorrection SNMPv2-MIB::sysName.0 = CEN010-202212080707 TCT-SNMP-MIB::tctSnmpCorrectionValue = "{"hcv":false,"x":0,"y":0}" |
Get the latest MIB file for CENTAURI SNMP at CENTAURI | Monitoring Performance with SNMP.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article