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