Get device health requests using SNMP

Retrieve the health statistics defined by Management Information Base (MIB).

Pull the MIB from Trellix ESM. For more information, see Pull the MIB from Trellix ESM topic.

To get the device health requests against the Trellix ESM (using Device ID):
1. From the MIB list, get the object ID (OID) for the device.
  Example:
```
Name OBJECT-TYPE
SYNTAX OCTET STRING
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Receiver name"
– 1.3.6.1.4.1.23128.1.3.3.1
::= { healthReceiver 1 }
```
  Where, OID is 1.3.6.1.4.1.23128.1.3.3.1.
2. Under SNMP Requests tab, click View Device IDs.
  The Device ID List window opens.
3. Get the Device ID for the device and click Close.
4. Open the Command line and enter the command:
  - Using snmp v1
    snmpget -v 1 -c <Community> -t <Timeout_in_seconds. -t is an optional parameter> <IP_Address of ESM>:<Port> <OID looked up from MIB>.<Device_ID>
    Example:
    If device ID is 8
```
# snmpget -v 1 -c public -t 60 192.168.90.9:161 1.3.6.1.4.1.23128.1.3.3.1.8
SNMPv2-SMI::enterprises.23128.1.3.3.1.8 = STRING: "RECEIVER-TEST"
```
  - Using snmp v3
    snmpget -v3 -l <Security level> -u <ESM username> -a <Authentication protocol> -A <Password from the screenshot below> -x <Privacy protocol> -X <Password from the screenshot below> -t <Timeout in seconds is option. This parameter is optional> <IP Address of ESM>:<Port> <OID looked up from MIB>.<Device ID>
    Note
    To get the authentication and privacy protocol passwords, go to the system navigation tree, select the device, and click → SNMP Requests.
    Note
    The snmp v3 passwords are generated per user, so that each user has their own unique password.
    Example:
    If device ID is 8
```
snmpget -v3 -l authPriv -u NGCP -a SHA -A "55874813D567D6F4021E6F108BFE5778BF2A545884045EE071B3500C63E77D56CE3B7342D8A3019433C2503D5138164E5B046EE282CCE6B182F48E2BB36F22FE" -x AES -X "55874813D567D6F4021E6F108BFE5778BF2A545884045EE071B3500C63E77D56CE3B7342D8A3019433C2503D5138164E5B046EE282CCE6B182F48E2BB36F22FE" -t 60 192.168.90.9:161 1.3.6.1.4.1.23128.1.3.3.1.8
SNMPv2-SMI::enterprises.23128.1.3.3.1.8 = STRING: "RECEIVER-TEST"
```
To get the device health requests against a device (using Device ID as 0):
1. From the MIB list, get the OID for the device.
  Example:
```
deviceStatus OBJECT-TYPE
  SYNTAX  OCTET STRING
  MAX-ACCESS read-only
  STATUS  current
  DESCRIPTION
    "Indicates the current status of the device"
  -- 1.3.6.1.4.1.23128.1.3.30.1
  ::= { devicehealth 1 }
```
  Where, OID is 1.3.6.1.4.1.23128.1.3.30.1.
2. Open the Command line and enter the command:
  Note
  If there is no Device ID to reference the receiver, use 0 as the device ID at end of the OID.
  - Using snmp v1
    snmpget -v 1 -c <Community> -t <Timeout_in_seconds. -t is an optional parameter> <IP_Address of DEVICE>:<Port> <OID looked up from MIB>.0
    Example:
```
# snmpget -v 1 -c public -t 60 192.168.90.9:161 1.3.6.1.4.1.23128.1.3.30.1.0

SNMPv2-SMI::enterprises.23128.1.3.30.1.0 = STRING: "Ok"
```
  - Using snmp v3
    snmpget -v3 -l <Security level> -u <ESM username> -a <Authentication protocol> -A <Password from the screenshot below> -x <Privacy protocol> -X <Password from the screenshot below> -t <timeout in seconds is option. This parameter is optional> <IP Address of DEVICE>:<Port> <OID looked up from MIB>.0
    Note
    To get the authentication and privacy protocol passwords, go to the system navigation tree, select the device, and click → SNMP Requests.
    Note
    The snmp v3 passwords are generated per user, so that each user has their own unique password.
    Example:
```
snmpget -v3 -l authPriv -u NGCP -a SHA -A "55874813D567D6F4021E6F108BFE5778BF2A545884045EE071B3500C63E77D56CE3B7342D8A3019433C2503D5138164E5B046EE282CCE6B182F48E2BB36F22FE" -x AES -X "55874813D567D6F4021E6F108BFE5778BF2A545884045EE071B3500C63E77D56CE3B7342D8A3019433C2503D5138164E5B046EE282CCE6B182F48E2BB36F22FE" -t 60 192.168.90.9:161 1.3.6.1.4.1.23128.1.3.30.1.0

SNMPv2-SMI::enterprises.23128.1.3.30.1.0 = STRING: "Ok"
```