Environmental Monitoring

Querying the Module Temperature Sensor Data

Querying the Module Temperature Sensor Data
GET http://<IP_Address>/api/mo/sys/ch/supslot-1/sup/sensor-1.json
{
  "eqptSensor": {
    "attributes": {
      "childAction": "",
      "descr": "FRONT",
      "dn": "sys/ch/supslot-1/sup/sensor-1",
      "id": "1",
      "majorThresh": "70",
      "mfgTm": "not-applicable",
      "minorThresh": "42",
      "modTs": "2017-06-06T22:11:05.299+00:00",
      "model": "FRONT",
      "monPolDn": "",
      "operSt": "normal",
      "persistentOnReload": "false",
      "rev": "n/a",
      "ser": "n/a",
      "status": "",
      "tempValue": "25",
      "type": "inlet",
      "unit": "Celsius",
      "vendor": "Cisco Systems"
    }
  }
}

Provides sensor data for environmental monitors such as temperature gauges.

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html


CLI Commands

The DME payload is the equivalent of the sensor name (descr), MajorThresh (majorThresh), MinorThres (minorThresh), CurTemp (tempValue), status (operSt), and the temperature scale (unit) given in the first row of the show environment temperature module module output table. Compare the payload with the CLI Output.

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference: http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

CLI Output
 switch# show environment temperature module 1
Temperature:
-----------------------------------------------------------------------
Module Sensor MajorThresh MinorThres CurTemp Status
(Celsius) (Celsius) (Celsius)
----------------------------------------------------------------------- 1 FRONT 70 42 25 Ok
1 BACK 80 70 33 Ok
1 CPU 95 80 34 Ok
1 TH 105 90 50 Ok
1 VRM-1 110 100 50 Ok

Querying the Power Supply Data

Querying the Power Supply Data
GET http://<IP_Address>/api/mo/sys/ch/psuslot-1/psu.json
{
  "eqptPsu": {
    "attributes": {
      "almReg": "0",
      "cap": "54.000000",
      "childAction": "",
      "descr": "NXA-PAC-650W-PI-1",
      "dn": "sys/ch/psuslot-1/psu",
      "drawnCurr": "0.422727",
      "fanOpSt": "ok",
      "hwVer": "V01",
      "id": "1",
      "mfgTm": "not-applicable",
      "modTs": "2017-06-06T22:21:40.321+00:00",
      "model": "NXA-PAC-650W-PI",
      "monPolDn": "",
      "operSt": "ok",
      "persistentOnReload": "false",
      "rev": "A0",
      "ser": "LIT192818FC",
      "status": "",
      "vSrc": "220v",
      "vendor": "Cisco Systems Inc",
      "volt": "12.000000"
    }
  }
}

Provides system inventory power supply information.

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html


CLI Commands

The DME payload provides information on PID (model), VID (hwVer), and SN (ser) numbers given in the show inventory power_supply output and provides the voltage (volt), ampere input (drawnCurr), and status (operSt) given in the show environment power ampere output. Compare the payload with the CLI Output.

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference: http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

CLI Output
 switch# show inventory power_supply
NAME: "Power Supply 1", DESCR:"Nexus3000 C3232C Chassis Power Supply"
PID: NXA-PAC-650W-PI , VID: V01 , SN: LIT192818FC
CLI Output
 switch# show environment power ampere
Power Supply:
Voltage: 12 Volts
Power Actual Actual Total
Supply Model Output Input Capacity Status
(Ampere) (Ampere) (Ampere)
------- ------------------- ---------- ---------- ---------- ------------
1 NXA-PAC-650W-PI 6.58 A 0.42 A 54.16 A Ok
2 NXA-PAC-650W-PI 5.92 A 0.39 A 54.16 A Ok

Querying the Transceiver Data

Querying the Transceiver Data
GET http://<IP_Address>/api/mo/sys/intf/phys-[eth2/2]/phys/fcot.json
{
 "ethpmFcot": {
    "attributes": {
      "baseResvd1": "0",
      "baseResvd2": "0",
      "baseResvd3": "0",
      "baseResvd4": "7,208,70",
      "brIn100MHz": "103",     
      "brMaxMargin": "15",     
      "brMinMargin": "222",    
      "ccex": "162",           
      "ccid": "104",           
      "connectType": "12",     
      "dateCode": "49,50,48,50,49,50,32,32",
      "description": "0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0",
      "diagMonType": "10",                                       
      "distIn100mFor9u": "50",                                   
      "distIn10mFor50u": "30",                                   
      "distIn10mFor60u": "0",                                    
      "distIn1mForCu": "0",                                      
      "distInKmFor9u": "0",                                      
      "dn": "sys/intf/phys-[eth2/2]/phys/fcot",                  
      "encoding": "5",                                           
      "enhOption": "0",                                          
      "extOption": "0,0",                                        
      "fCTxType": "1",                                           
      "fcotNum": "98",                                           
      "fcotStatus": "0",                                         
      "fcotType": "19",                                          
      "flags": "ok",                                             
      "gigEthCC": "0",                                           
      "guiCiscoEID": "unknown",                                  
      "guiCiscoPID": "",                                         
      "guiCiscoPN": "",                                          
      "guiName": "CISCO           ",                             
      "guiPN": "AFBR-79EIPZ-CS1 ",                               
      "guiRev": "02Bh",                                          
      "guiSN": "AVP1606S381     ",                               
      "isFcotPresent": "yes",                                    
      "maxSpeed": "5",                                           
      "minSpeed": "5",                                           
      "partNumber": "0,0,0,0,0,0,0,0,0,0,0",                     
      "sff8472Compl": "0",                                       
      "state": "inserted",                                       
      "type": "qsfp",                                            
      "typeName": "",                                            
      "vendorData": "0,0,6,172,8,168,10,138,172,124,181,114,234,190,127,49,181,208,56,0,0,0,0,0,0,0,0,0,142,50,241,121",
      "vendorId": "0,23,106",                                                                                           
      "vendorName": "67,73,83,67,79,32,32,32,32,32,32,32,32,32,32,32",                                                  
      "vendorPn": "65,70,66,82,45,55,57,69,73,80,90,45,67,83,49,32",                                                    
      "vendorRev": "48,50,66,104",                                                                                      
      "vendorSn": "65,86,80,49,54,48,54,83,51,56,49,32,32,32,32,32",                                                    
      "versionId": "0,0,0,0,0",                                                                                         
      "xcvrCode": "4,0,0,0,0,0,0,0",                                                                                    
      "xcvrExtId": "16",                                                                                                
      "xcvrId": "13" 
    }
  }
}

Provides transceiver interface information.

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html


CLI Commands

The DME payload provides the slot and port numbers (dn: sys/intf/phys-{[id]}...), interface name (guiName), part number (guiPN), serial number (guiSN), link length (distIn10mFor50u), and the Cisco extended ID number (xcvrExtId) given in the show interface ethernet slot/port transceiver output. Compare the payload with the CLI Output.

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference: http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

CLI Output
 switch# show interface e2/2 transceiver
Ethernet2/2
transceiver is present
type is QSFP-40G-SR4
name is CISCO
part number is AFBR-79EIPZ-CS1
revision is 02
serial number is AVP1606S381
nominal bitrate is 10300 MBit/sec per channel
Link length supported for 50/125um OM2 fiber is 30 m
Link length supported for 50/125um OM3 fiber is 100 m
cisco id is 13
cisco extended id number is 16

Querying the Transceiver Sensor Data

Querying the Transceiver Sensor Data
GET http://<IP_Address>/api/mo/sys/intf/phys-[eth2/2]/phys/fcot/lane-1-sensor-2.json
{                                                                                                                 
"eqptFcotSensor": {                                                                                             
  "attributes": {                                                                                               
    "description": "XCVR Lane-1 Sensor-2 Voltage Sensor",                                                       
    "dn": "sys/intf/phys-[eth2/2]/phys/fcot/lane-1-sensor-2",                                                   
    "highAlarm": "3.630000",                                                                                    
    "highWarning": "3.465000",                                                                                  
    "laneId": "1",                                                                                              
    "laneType": "basic",                                                                                        
    "lowAlarm": "2.970000",                                                                                     
    "lowWarning": "3.100000",                                                                                   
    "sensorId": "2",                                                                                            
    "unit": "V",                                                                                                
    "value": "3.403700"
  }
}
},

Provides transceiver sensor information.

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html


CLI Commands

The DME payload provides the lane number and voltage (description), curent measurement (value), alarms (highAlarm and lowAlarm), warnings (highWarning and lowWarning), and the sensor unit (unit) given in the show interface ethernet slot/port transceiver output. Compare the payload with the CLI Output.

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference: http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

CLI Output
 switch# show interface e2/2 transceiver details
Ethernet2/2
transceiver is present
type is QSFP-40G-SR4
name is CISCO
part number is AFBR-79EIPZ-CS1
revision is 02
serial number is AVP1606S381
nominal bitrate is 10300 MBit/sec per channel
Link length supported for 50/125um OM2 fiber is 30 m
Link length supported for 50/125um OM3 fiber is 100 m
cisco id is 13
cisco extended id number is 16
CLI Output
 Lane Number:1 Network Lane
SFP Detail Diagnostics Information (internal calibration)
----------------------------------------------------------------------------
Current Alarms Warnings
Measurement High Low High Low
----------------------------------------------------------------------------
Temperature 24.65 C 75.00 C -5.00 C 70.00 C 0.00 C
Voltage 3.40 V 3.63 V 2.97 V 3.46 V 3.09 V
Current N/A N/A N/A N/A N/A
Tx Power N/A N/A N/A N/A N/A
Rx Power N/A N/A N/A N/A N/A
Transmit Fault Count = 0
----------------------------------------------------------------------------
Note: ++ high-alarm; + high-warning; -- low-alarm; - low-warning
...

Querying the Temperature Details for the Sensor

Querying the Temperature Details for the Sensor
GET http://<IP_Address>/api/mo/sys/intf/phys-[eth2/2]/phys/fcot/lane-1-sensor-1.json
{
  "totalCount": "1",
  "imdata": [
    {
      "eqptFcotSensor": {
        "attributes": {
          "description": "XCVR Lane-1 Sensor-1 Temperature Sensor",
          "dn": "sys/intf/phys-[eth2/2]/phys/fcot/lane-1-sensor-1",
          "highAlarm": "75.000000",
          "highWarning": "70.000000",
          "laneId": "1",
          "laneType": "basic",
          "lowAlarm": "-5.000000",
          "lowWarning": "0.000000",
          "sensorId": "1",
          "unit": "C",
          "value": "25.058001"
        }
      }
    }
  ]
}

Provides transceiver sensor information.

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html


CLI Commands

The DME payload provides the lane number and voltage (description), current measurement (value), alarms (highAlarm and lowAlarm), warnings (highWarning and lowWarning), and the sensor unit (unit) given in the show interface ethernet slot/port transceiver output. Compare the payload with the CLI Output.

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference: http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

CLI Output
  switch# show interface e2/2 transceiver details
Ethernet2/2
transceiver is present
type is QSFP-40G-SR4
name is CISCO
part number is AFBR-79EIPZ-CS1
revision is 02
serial number is AVP1606S381
nominal bitrate is 10300 MBit/sec per channel
Link length supported for 50/125um OM2 fiber is 30 m
Link length supported for 50/125um OM3 fiber is 100 m
cisco id is 13
cisco extended id number is 16
Lane Number:1 Network Lane
SFP Detail Diagnostics Information (internal calibration)
----------------------------------------------------------------------------
Current Alarms Warnings
Measurement High Low High Low
----------------------------------------------------------------------------
Temperature 24.65 C 75.00 C -5.00 C 70.00 C 0.00 C
Voltage 3.40 V 3.63 V 2.97 V 3.46 V 3.09 V
Current N/A N/A N/A N/A N/A
Tx Power N/A N/A N/A N/A N/A
Rx Power N/A N/A N/A N/A N/A
Transmit Fault Count = 0
----------------------------------------------------------------------------
Note: ++ high-alarm; + high-warning; -- low-alarm; - low-warning
...