F5 Logo MyF5
Search
  1. MyF5 Home
  2. Knowledge Centers
  3. BIG-IP LTM
  4. F5 Platforms: Essentials
  5. Digital Diagnostics Monitoring DDM
Manual Chapter : Digital Diagnostics Monitoring DDM

Applies To:

Show Versions Show Versions
Manual Chapter
Table of Contents | << Previous Chapter | Next Chapter >>

Digital Diagnostics Monitoring (DDM)

About Digital Diagnostics Monitoring (DDM)

Digital Diagnostics Monitoring (DDM) is a feature used in optical transceiver modules that enables you to view real-time information about transceivers, such as optical output and input power.

For information about which F5® transceiver modules support DDM, see F5® Platforms: Accessories.

Supported platforms

Digital Diagnostics Monitoring (DDM) is available on these platforms, when running BIG-IP® software version 12.1.0 or later, for transceiver modules that support DDM.

  • BIG-IP 5000 Series
  • BIG-IP 6900 Series
  • BIG-IP 7000 Series
  • BIG-IP 8900 Series
  • BIG-IP 10000 Series
  • BIG-IP 11000 Series
  • BIG-IP 12000 Series
  • VIPRION® B2100
  • VIPRION B2150
  • VIPRION B2250
  • VIPRION B4300
  • VIPRION B4450

Enabling DDM on a system

You can use the Traffic Management Shell (tmsh) to enable Digital Diagnostics Monitoring (DDM) information about interfaces in your system. DDM is disabled by default.
  1. Connect to the system using the serial console or by opening an SSH session to the management IP address.
  2. Log on to the command line of the system using an account with root access.
  3. Enable DDM.
    tmsh modify sys db ddm.bcm56xxd.enable value <enable | disable>

Viewing DDM state on a system

You can use the Traffic Management Shell (tmsh) to verify whether Digital Diagnostics Monitoring (DDM) is enabled.
  1. Connect to the system using the serial console or by opening an SSH session to the management IP address.
  2. Log on to the command line of the system using an account with root access.
  3. View the state of DDM on the system.
    tmsh list sys db ddm.bcm56xxd.enable
    This is an example of the output that you might see when you run this command, and DDM is enabled: 
                                  
sys db ddm.bcm56xxd.enable {
    value "enable"
}

Viewing DDM information for optical tranceiver modules

You can use the Traffic Management Shell (tmsh) to view Digital Diagnostics Monitoring (DDM) information about optical transceiver modules installed in your system.
  1. Connect to the system using the serial console or by opening an SSH session to the management IP address.
  2. Log on to the command line of the system using an account with root access.
  3. View DDM information for an interface.
    tmsh show net interface-ddm <interface_key>
    This command sequence always shows four power levels. For 40GbE and 100GbE, all four power levels are filled. 10GbE interfaces only transmit and receive one power level. For 10GbE interface, you can ignore the other lanes, which contain 0mW and -1000000dBm. These indicate invalid or no readings. Only the first values are valid.
    Note: If you do not specify an <interface_key>, you see information for all interfaces.
    This is an example of the output that you might see when you run this command on interface 2.6, a four lane 40GbE transceiver that reports four lanes of DDM information (note that power values are within power thresholds, so all alarms and warnings are false): 
                                  
---------------------------------------------------------------
Digital Diagnostic Monitoring Interface:2.6
Laser Transmit and Receive Power Value
Transmit Power1                    1.3242mW    1.22dBm
Transmit Power2                    1.1495mW    0.61dBm
Transmit Power3                    1.0103mW    0.04dBm
Transmit Power4                    1.1381mW    0.56dBm
Receive Power1                     1.2567mW    0.99dBm
Receive Power2                     1.2439mW    0.95dBm
Receive Power3                     1.4072mW    1.48dBm
Receive Power4                     1.3279mW    1.23dBm
Transmit and Receive Power Thresholds
Transmit Low Alarm Threshold       0.0794mW  -10.99dBm
Transmit High Alarm Threshold      3.3884mW    5.30dBm
Transmit Low Warning Threshold     0.1995mW   -6.99dBm
Transmit High Warning Threshold    1.9953mW    3.00dBm
Receive Low Alarm Threshold        0.0170mW  -17.69dBm
Receive High Alarm Threshold       2.1380mW    3.30dBm
Receive Low Warning Threshold      0.0427mW  -13.69dBm
Receive High Warning Threshold     1.6982mW    2.30dBm
Transmit Low Alarm               false
Transmit High Alarm              false
Receive Low Alarm                false
Receive High Alarm               false
Transmit Low Warning             false
Transmit Hi Warning              false
Receive Low Warning              false
Receive High Warning             false

About the units uWatts and dBm

The transceiver modules supply optical power in units of .1 uWatts. Per SFF-8472, the measured Tx and Rx power is in mW. The power is provided as a 16 bit unsigned integer with the power defined as the full 16 bit value (0-65535) with LSB equal to 0.1uW, yielding a total range of 0 to 6.5535 mW (~ -40 to +8.2 dBm).

Most displays of optical power are in dBm (deciBels/milliwatts). Decibels is a ratio of two power levels, one of which is considered the reference value. The db is a logarithmic scale. The m in dBm refers to the reference power which is 1 milliwatt.

To convert between the raw hardware readings of .1 uWatts and dBm, use this formula:

10 * log10f(raw_power/10000.0)

Viewing DDM log messages

You can see messages specific to Digital Diagnostics Monitoring (DDM) in the /var/log/ltm log file.
  1. Connect to the system using the serial console or by opening an SSH session to the management IP address.
  2. Log on to the command line of the system using an account with root access.
  3. Use grep to search the log for messages that are specific to DDM.
    zgrep -i ddm /var/log/ltm*

About DDM monitoring with SNMP

For the Digital Diagnostic Monitoring (DDM) capability available on F5® platforms, you can use the industry-standard System Management Network Protocol (SNMP) protocol to read information collected from optical transceiver modules, when available. This information is in BIG-IP® Core Statistics. You can then use SNMP and the F5-BIG-IP-SYSTEM-MIB file to access this information.

When you use SNMP to access the information that DDM collects, note this F5 DDM behavior:

  • F5 interface rows are indexed by interface name.
  • Information in the F5-BIG-IP-SYSTEM-MIB file is read-only. SNMP objects cannot modify or configure DDM information.
  • SNMP can monitor all transceivers that support DDM.
  • The thresholds that SNMP monitors are the vendor-specified thresholds read from the transceivers.
  • The F5 MIB file monitors optical receive and transmit level power.
  • If a threshold is exceeded, the F5 DDM notification message contains the value that exceeded the threshold.
  • SNMP sends traps when a DDM-monitored transmit or receive power reading crosses a warning or alarm threshold.

For more information about setting up SNMP monitoring, see External Monitoring of BIG-IP® Systems: Implementations.

Configuring SNMP access from remote hosts using tmsh

You can use the Traffic Management Shell (tmsh) to configure your BIG-IP® system to allow SNMP access from remote hosts.
  1. Connect to the system using the serial console or by opening an SSH session to the management IP address.
  2. Log on to the command line of the system using an account with root access.
  3. Configure the default entry to allow access from specified hosts.
    tmsh modify sys snmp allowed-addresses replace-all-with { <IP_addresses_or_IP_address_range> }

Monitoring DDM information using SNMP

You can use the industry-standard System Management Network Protocol (SNMP) to monitor information that Digital Diagnostic Monitoring (DDM) collects about optical transceiver modules from a remote host.
  1. Log in to the command-line interface of the remote host.
  2. Read the information using SNMP.
    This example collects data about laser optical output power, where public is the community name and bigip is the host name of the BIG-IP® system: snmpget -c public <bigip> sysSwitchDdmStatTxPwr1.
  3. Configure SNMP to receive notifications using tmsh:
    1. Connect to your BIG-IP® system using the serial console or by opening an SSH session to the management IP address.
    2. Log on to the command line of the system using an account with root access.
    3. Configure your BIG-IP system to add an SNMP trap receiver.
      The BIG-IP system sends trap notifications to the designated trap receiver.
      This example adds an SNMP version 2c trap, tv2, to the system, where <trap_receiver_IP_address> is the destination IP address of tv2, the port is 162, and where <community_string> is the community that has access to tv2.
      tmsh modify sys snmp traps add {tv2 {version 2c community <community_string> host <trap_receiver_IP_address> port 162}}
Table of Contents | << Previous Chapter | Next Chapter >>
Contact Support Contact Support

Have a Question?

Support and Sales >

About F5

Education

F5 Sites

Support Tasks




©2023 F5 Networks, Inc. All rights reserved.


Trademarks Policies Privacy California Privacy Do Not Sell My Personal Information