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:

1

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:

1

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:

1

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:

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
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:

0

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.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article