CodingBox Documentation

Monitoring and management: DDM, OSC, OCM, RFTS, alarms

Passive plant is silent; the active infrastructure around it is the only source of live information about a fibre link. Every transceiver measures its own light, every amplifier reports its pumps and gain, ROADM nodes watch the spectrum, supervisory channels carry it all between sites, and remote test systems fire OTDR pulses into the fibre while it carries traffic. This page sets out the layers of visibility, the alarms they raise and what each one means, how to keep baselines and trends, the protocols and tools that collect the data, how to correlate module data with fibre data to find the fault, and the practical rules for a monitoring setup that catches problems before customers do.

Layers of visibility

LayerSourceWhat it seesDetail
Transceiver diagnostics (DDM/DOM)the module's monitor photodiodes and sensors, read by the hostTx and Rx power, laser bias, temperature, supply voltage; on 400G+ and coherent modules also pre-FEC BER, chromatic dispersion, DGD, OSNR (VDM)DDM basics, VDM & FEC metrics
Host port countersMAC/PCS of the switch, router or NIClink state and flaps, FEC corrected and uncorrected blocks, CRC errors, PCS errored blocksManagement & monitoring
Amplifier telemetryEDFA and Raman unitsinput and output power, gain, pump current and temperature, loss of input, APR stateAmplifiers & regeneration
Optical channel monitor (OCM)spectrum analyzer built into ROADM and terminal nodesper-channel power and presence, OSNR estimate, tiltTransport & access equipment
Optical supervisory channel (OSC)a dedicated wavelength (1 510 or 1 610 nm) between line sitesspan loss, remote alarms, management connectivity to unmanned sitessame
Remote fibre test system (RFTS)OTDR units coupled at 1 625 or 1 650 nm to live fibresnew events, loss changes, break location on the fibre itselfMaintenance & restoration
Environmental sensorscabinets, closures, hutsdoor, temperature, humidity, water, mains and battery statesame
Records and baselinescommissioning tests and the link passportwhat "normal" is for every fibre and moduleDocumentation & labelling

Alarms and what they mean

AlarmRaised byMeaningFirst check
Loss of signal (LOS)receiver: no lightfibre cut, far-end transmitter off, wrong wavelength or channel, disconnected cordfar-end Tx power and link state (No link)
Loss of lock, loss of frame (LOL, LOF)CDR, PCS, OTN framerlight present but unusable: speed or FEC mismatch, dispersion or noise beyond tolerance, very low powerRx power against sensitivity, speed and FEC settings
Rx power low warning or alarmmodule thresholdsplant loss grew or far Tx fell; typical thresholds a few dB above sensitivitytrend of far Tx and near Rx (Thresholds & alarms)
Rx power highmodule thresholdstoo little loss for ER/ZR or amplified output into a receiverattenuator
Tx power low, laser bias highmodulelaser ageing or failurebias trend (Tx bias & laser ageing)
Temperature highmodule or equipmentblocked airflow, failed fan, hot site, module above its classsite environment (Temperature & voltage)
Pre-FEC BER rising, uncorrectable blockshost or module FEC statisticsthe margin is being consumed — by power, dispersion, PMD, reflections or a dirty connector — before the link failscorrelate with Rx power and OSNR
Link flappinghostintermittent contact, reflections, marginal power, thermal cyclingLink flapping
Module not present or unsupportedhostseating, coding, incompatible typeVendor lock
Amplifier loss of input, APR activeamplifierupstream fibre cut; pumps shut down for safetydo not defeat APR; locate the cut (Safety & handling)
Span loss increased (OSC)line systemfibre degradation, bend, water, dirty connector in the spanRFTS or OTDR the span (Reading an OTDR trace)
RFTS new event or loss changeremote OTDRa new bend, splice degradation, water or a cut at a located distanceconvert to route position, dispatch
Door open, water, mains failed, battery lowenvironmentalthe site is about to become a fibre cutdispatch before the batteries end

Alarm hierarchies matter: a fibre cut raises LOS on every wavelength, loss of input on the amplifier, span loss on the OSC and a dozen service alarms — the root cause is the one lowest in the stack.

PracticeRule
Link passport at commissioningfar Tx, near Rx, bias and temperature of both modules; OTDR both directions; loss at all wavelengths
Alert on deltas, not on absolute thresholds alone2 dB below the baseline Rx is a call to look, long before the module's own low-power alarm
Poll interval1–5 minutes for power values; counters per minute; RFTS scans hourly to daily
Seasonal behaviour±1 dB swings on aerial and outdoor plant are normal — document them
Re-baseline after every changenew module, re-splice, re-patch
AccuracyDDM is ±1–2 dB absolute but ±0.1 dB repeatable — perfect for trends, not for certification (Accuracy & limits)
Retentionkeep at least a year of power history to see slow degradation and seasonality (Monitoring)

Protocols and tools

MechanismWhat it deliversNotes
CLI (show interface transceiver and equivalents)DDM values per port on demandscripting-friendly; syntax per NOS (Reading DDM tools)
SNMP polling and trapsDDM, counters, equipment alarmsvendor MIBs for optical values; ENTITY-SENSOR-MIB on some platforms
Streaming telemetry (gNMI, OpenConfig, NETCONF)DDM and counters every few secondsopenconfig-platform-transceiver models; best for trends
ethtool, mlxlink and NIC toolsDDM from server NICsNIC tools & diagnostics
Line-system EMS/NMSamplifier, OCM, OSC data and optical-layer alarmsTL1 or NETCONF northbound
RFTS softwaretrace comparison, event alarms, GIS mapping of distancesneeds the route records to map distance to place
Umbrella NMS, time-series database and dashboardscorrelation of fibre, module, service and environmental datathe place where root-cause analysis happens

Correlating module and fibre data

ObservationLikely causeConfirm
Near Rx fell, far Tx and bias unchangedplant loss increased: bend, connector, water, closureOTDR or RFTS; inspect connectors
Far Tx fell, its bias rosefar-end laser ageingreplace module (Tx bias & laser ageing)
Both directions degrade togethercommon-path problem: a shared closure, duct, cabinet temperaturesite check
Rx normal, pre-FEC BER risingdispersion, PMD, reflections, non-linear or noise — not powerOSNR (coherent VDM), reflectance, characterization (Fibre characterization)
Rx swings daily by 1–2 dBtemperature on outdoor plant or a marginal connectorcorrelate with weather; inspect
Flaps with good average powerreflections, intermittent contact, dirty endfacereflectance on OTDR, endface inspection (Endface inspection & cleaning)
Temperature high with normal trafficairflow or fansite
Everything down at one sitepowerenvironmental alarms, batteries
One wavelength down, others finethat module, its patch cord, or a ROADM channel settingswap module, check channel plan

Practical rules

RuleWhy
Monitor both ends of every linkplant loss is far Tx minus near Rx; one end tells you nothing about which side degraded
Read DDM through the host, and keep the bench valuethe host's reading is the operational truth; the bench value is the baseline before the plant (DDM in the app)
Alarm thresholds per link, not per module typethe module's factory thresholds are wide; the link's margin is specific
Test the protection pathsa standby path with no traffic still needs its Rx power watched, or it fails silently
Monitor the monitorsRFTS units, OSC terminals and sensors fail too
Keep the records currentan alarm at "12.3 km" is useless without a route map (Documentation & labelling)
Separate the management networkan outage must not take down the ability to see it

In CodingBox

The bench is the first monitoring point: CodingBox reads a module's DDM, thresholds and VDM capabilities before installation, so the link passport starts with known-good values for the module alone — Tx power, bias, temperature — and the host's later readings can be judged against them (DDM in the app, Check transceiver, Monitoring).