CENTAURI | Release 5.0 SNMP Updates, New Traps & Alarms

Modified on Fri, 17 Nov 2023 at 03:52 AM

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:  support@transcelestial.com
    "
    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
SYNTAX DISPLAYSTRING
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Get device receive power in dBm"

::= { 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.

	CENTAURI 1G	CENTAURI 10G
Warning Threshold	-30 dBm	-22 dBm
Alarm Threshold	-35 dBm	-25dBm

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
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Get laser link status:
- 0: link is down
- 1: link is up
"
::= { tctSnmpMeasurements 2 }

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:

Tx Power

tctSnmpTxPwr OBJECT-TYPE
SYNTAX DISPLAYSTRING
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Get device transmit power in dBm"
::= { tctSnmpMeasurements 3 }

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
SYNTAX DISPLAYSTRING
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Minimum rx power over previous 1 minute"
::= { tctSnmpMeasurements 4 }

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
SYNTAX DISPLAYSTRING
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Humidity as measured by device"
::= { tctSnmpMeasurements 5 }

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
SYNTAX DISPLAYSTRING
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Temperature of window heater"
::= { tctSnmpMeasurements 6 }

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
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Window heater is turned on"
::= { tctSnmpMeasurements 7 }

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:

Window heater auto on/off status

tctSnmpHeaterAuto OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Window heater automatic on/off is on"
::= { tctSnmpMeasurements 8 }

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:

Laser absolute position

tctSnmpPosition OBJECT-TYPE
SYNTAX DISPLAYSTRING
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Absolute position of laser"
::= { tctSnmpMeasurements 9 }

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
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Device vibration is excessive"
::= { tctSnmpMeasurements 10 }

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:

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
SYNTAX DISPLAYSTRING
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"JSON string containing current level of vibration for the device"
::= { tctSnmpMeasurements 11 }

Reports the measurement of the vibration being experienced by the device at the time of polling as a JSON string. Specifically, it shows:

stdx, stdy, stdz (standard deviation on x, y, z)
mmrx, mmry, mmrz (min-max range on x, y, z)

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
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Device correction vector for laser pointing is excessive"
::= { tctSnmpMeasurements 12 }

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:

Correction vector value

tctSnmpCorrectionValue OBJECT-TYPE
SYNTAX DISPLAYSTRING
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"JSON string containing current correction vector"
::= { tctSnmpMeasurements 13 }

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 -- Note: 2 OID's get added to this trap prior to it being sent -- SNMPv2-MIB::sysName and TCT-SNMP-MIB::tctSnmpRxPwr STATUS current DESCRIPTION "Centauri laser link down notification" ::= { tctTraps 1 }	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 -- Note: Deprecated - no longer in use STATUS deprecated DESCRIPTION "Centauri monitor event triggered" ::= { tctTraps 2 }	No longer in use.
Link Up	tctLaserLinkUp NOTIFICATION-TYPE -- Note: 2 OID's get added to this trap prior to it being sent -- SNMPv2-MIB::sysName and TCT-SNMP-MIB::tctSnmpRxPwr STATUS current DESCRIPTION "Centauri laser link up notification" ::= { tctTraps 3 }	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 -- Note: Centauri has detected device movement affecting the laser link STATUS current DESCRIPTION "Centauri device vibration is excessive" ::= { tctTraps 4 }	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 STATUS current DESCRIPTION "Centauri device vibration has returned to normal operating range" ::= { tctTraps 5 }	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 -- Note: Trap is triggered when the main Centauri filesystem is critically low on free space STATUS current DESCRIPTION "Centauri filesystem space is low" ::= { tctTraps 6 }	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 -- Note: CPU utilisation is critically high and may impact laser link performance STATUS current DESCRIPTION "Centauri CPU utilisation is high" ::= { tctTraps 7 }	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 -- Note: Trap is triggered when size and frequency of corrections to laser pointing is excessive STATUS current DESCRIPTION "Centauri correction vector changes are excessive" ::= { tctTraps 8 }	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 STATUS current DESCRIPTION "Centauri correction vector changes have returned to normal operating range" ::= { tctTraps 9 }	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.