This topic describes how to configure SNMP.
SNMP is a standard protocol for managing devices on IP networks. The Delphix Engine can be configured to provide basic system level status via SNMP, and send alerts to an external SNMP manager.
There are no prerequisites for enabling SNMP to provide system status. The following are prerequisites for sending alerts to an external SNMP manager.
- At least one SNMP manager must be available and must be configured to accept SNMPv2 InformRequest notifications.
Delphix's MIB (Management Information Base) files must be installed on the SNMP manager or managers. These MIB files describe the information that the Delphix Engine will send out. They are attached to this topic.
- On the Delphix Engine login screen, select Delphix Setup.
- In the Delphix Setup login screen, enter the sysadmin username and password.
- Click Log In.
- From the Delphix Setup, select Preferences.
- Select SNMP Configuration.
- Select Use SNMP.
- OPTIONAL: change the following settings:
- Community String – The string that SNMP clients must provide in order to be authorized to retrieve SNMP information from the Delphix Engine.
- Authorized Network – The set of client IP addresses (in CIDR notation) authorized to retrieve SNMP information from the Delphix Engine. To allow all clients, set this to 0.0.0.0/0 (the default). To prevent all clients from connecting, set this to the loopback address, 127.0.0.1/32.
- System Location – A free-form text description of the Delphix Engine's physical location. This is provided as the value for MIB-II OID
- If you do not want to send alerts to SNMP managers, then skip to step 14 to save the configuration.
- If you wish to send alerts using SNMP in addition, set the severity level of the messages you want to be sent to the SNMP manager(s).
- Click the + icon.
- Enter an SNMP Manager hostname / IP address.
Provide a community string and adjust the port number if necessary.
- Click Save.
The newly-entered manager will appear in the list.
- The Delphix Engine will attempt to connect with the SNMP manager by transmitting an informational level message. If the Delphix Engine receives a response from the manager within 20 seconds, a checkmark will appear along with the manager entry. If not, a red X will appear – check your settings and try again.
- Click Save to commit the SNMP configuration.
The Delphix software can be configured to send SNMP traps when Delphix alerts are generated as described in the procedure above. In order to process these traps in your SNMP manager software, you will need the base Delphix MIB, and the Delphix Alert MIB.
In addition to generating traps, the Delphix Engine supports read-only access to the following MIBs for basic system monitoring purposes.
- The following MIB-II object hierarchies defined in RFC 1213:
- system (OID .126.96.36.199.2.1.1): Provides basic system identity information
- interfaces (OID .188.8.131.52.2.1.2): Provides network interface information including I/O statistics
- ip (OID .184.108.40.206.2.1.4): IP protocol information including IP addresses configured, routes, and IP statistics
- The following UCD objects defined in http://www.net-snmp.org/docs/mibs/ucdavis.html
- memory usage (OID .220.127.116.11.4.1.2021.4)
- CPU usage (OID .18.104.22.168.4.1.2021.11)
- Disk I/O statistics (OID .22.214.171.124.4.1.2021.13.15)
The following examples assume that you have enabled SNMP on a Delphix Engine named example.company.com, and have set the community string to "public".
Walking the MIB-II objects using the net-snmp snmpwalk tool:
$ snmpwalk -v 2c -c public example.company.com SNMPv2-MIB::sysDescr.0 = STRING: Delphix Engine 126.96.36.199 DelphixOS 5.1.2017.03.24 SNMPv2-MIB::sysObjectID.0 = OID: SNMPv2-SMI::enterprises.41028 DISMAN-EVENT-MIB::sysUpTimeInstance = Timeticks: (476432) 1:19:24.32 SNMPv2-MIB::sysContact.0 = STRING: email@example.com SNMPv2-MIB::sysName.0 = STRING: example.company.com SNMPv2-MIB::sysLocation.0 = STRING: VM Host ...
Walking Disk read and write I/O statistics:
$ snmpwalk -v 2c -c public example.company.com .188.8.131.52.4.1.2021.13.15.1.1.12 UCD-DISKIO-MIB::diskIONReadX.1 = Counter64: 11310593921 UCD-DISKIO-MIB::diskIONReadX.2 = Counter64: 334 UCD-DISKIO-MIB::diskIONReadX.3 = Counter64: 334 UCD-DISKIO-MIB::diskIONReadX.4 = Counter64: 865912605 UCD-DISKIO-MIB::diskIONReadX.5 = Counter64: 867599133 UCD-DISKIO-MIB::diskIONReadX.6 = Counter64: 865339677 UCD-DISKIO-MIB::diskIONReadX.7 = Counter64: 11309258752 UCD-DISKIO-MIB::diskIONReadX.8 = Counter64: 0 UCD-DISKIO-MIB::diskIONReadX.9 = Counter64: 1822880256 seb-laptop:~$ snmpwalk -v 2c -c public example.company.com .184.108.40.206.4.1.2021.13.15.1.1.13 UCD-DISKIO-MIB::diskIONWrittenX.1 = Counter64: 22337830400 UCD-DISKIO-MIB::diskIONWrittenX.2 = Counter64: 0 UCD-DISKIO-MIB::diskIONWrittenX.3 = Counter64: 0 UCD-DISKIO-MIB::diskIONWrittenX.4 = Counter64: 45118203392 UCD-DISKIO-MIB::diskIONWrittenX.5 = Counter64: 45137660928 UCD-DISKIO-MIB::diskIONWrittenX.6 = Counter64: 45139064320 UCD-DISKIO-MIB::diskIONWrittenX.7 = Counter64: 22337830400 UCD-DISKIO-MIB::diskIONWrittenX.8 = Counter64: 0 UCD-DISKIO-MIB::diskIONWrittenX.9 = Counter64: 33023515648
Retrieving the system uptime:
$ snmpget -v 2c -c public example.company.com .220.127.116.11.18.104.22.168.0 DISMAN-EVENT-MIB::sysUpTimeInstance = Timeticks: (1453172) 4:02:11.72