Zabbix Documentation 4.4

3.04.04.24.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.4Guidelines

User Tools

Site Tools


manual:config:items:itemtypes:snmp

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:config:items:itemtypes:snmp [2015/04/29 13:37]
martins-v updating field names and instructions a bit
manual:config:items:itemtypes:snmp [2019/04/02 06:04] (current)
Line 1: Line 1:
-==== - #2 SNMP agent ====+==== 2 SNMP agent ====
  
 === Overview === === Overview ===
Line 70: Line 70:
 So, now go back to Zabbix and click on //Items// for the SNMP host you created earlier. Depending on whether you used a template or not when creating your host, you will have either a list of SNMP items associated with your host or just an empty list. We will work on the assumption that you are going to create the item yourself using the information you have just gathered using snmpwalk and snmpget, so click on //Create item//. In the new item form, enter the item '​Name'​. Make sure the 'Host interface'​ field has your switch/​router in it and change the '​Type'​ field to "​SNMPv* agent"​. Enter the community (usually public) and enter the textual or numeric OID that you retrieved earlier into the 'SNMP OID' field, for example: .1.3.6.1.2.1.2.2.1.10.3 So, now go back to Zabbix and click on //Items// for the SNMP host you created earlier. Depending on whether you used a template or not when creating your host, you will have either a list of SNMP items associated with your host or just an empty list. We will work on the assumption that you are going to create the item yourself using the information you have just gathered using snmpwalk and snmpget, so click on //Create item//. In the new item form, enter the item '​Name'​. Make sure the 'Host interface'​ field has your switch/​router in it and change the '​Type'​ field to "​SNMPv* agent"​. Enter the community (usually public) and enter the textual or numeric OID that you retrieved earlier into the 'SNMP OID' field, for example: .1.3.6.1.2.1.2.2.1.10.3
  
-Enter the SNMP '​Port'​ as 161 and the '​Key'​ as something meaningful, e.g. SNMP-InOctets-Bps. Choose a custom multiplier if you want one and enter an '​Update interval'​ and '​History storage period'​ if you want them to be different from the default. Set the 'Type of information'​ to //Numeric (float)// and the 'Store value' to Delta (important, otherwise you will get cumulative values from the SNMP device instead of the latest change).+Enter the SNMP '​Port'​ as 161 and the '​Key'​ as something meaningful, e.g. SNMP-InOctets-Bps. Set the 'Type of information'​ to //Numeric (float)// and the preprocessing step as //Change per second// ​(important, otherwise you will get cumulative values from the SNMP device instead of the latest change). Choose a custom multiplier if you want one and enter an '​Update interval'​ and '​History storage period'​ if you want them to be different from the default.\\ 
 + 
 +{{:​manual:​config:​items:​itemtypes:​snmpv3_item.png|}} 
 + 
 +All mandatory input fields are marked with a red asterisk
  
 Now save the item and go to //​Monitoring//​ -> //Latest data// for your SNMP data! Now save the item and go to //​Monitoring//​ -> //Latest data// for your SNMP data!
  
-<note>​Since ​Zabbix 2.2, SHA and AES protocols are supported for SNMPv3 authentication ​and privacy, in addition ​to MD5 and DES supported before that.</​note>​+Take note of specific options available for SNMPv3 items: 
 + 
 +^Parameter^Description^ 
 +|//Context name// ​ |Enter context name to identify item on SNMP subnet.\\ //Context name// is supported for SNMPv3 items since Zabbix 2.2.\\ User macros are resolved in this field. ​ |   
 +|//Security name// ​ |Enter security name.\\ User macros are resolved in this field. ​ |  
 +|//Security level// |Select security level:\\ **noAuthNoPriv** - no authentication nor privacy protocols are used\\ **AuthNoPriv** - authentication protocol is usedprivacy protocol is not\\ **AuthPriv** - both authentication ​and privacy ​protocols are used  |  
 +|//​Authentication protocol// ​ |Select authentication protocol - //MD5// or //​SHA//​. ​ |  
 +|//​Authentication passphrase// ​ |Enter authentication passphrase.\\ User macros are resolved in this field. ​ |  
 +|//Privacy protocol// ​ |Select privacy protocol - //DES// or //​AES//​. ​ |  
 +|//Privacy passphrase// ​ |Enter privacy passphrase.\\ User macros are resolved in this field. ​ |  
 + 
 +In case of wrong SNMPv3 ​credentials (security name, authentication ​protocol/​passphrase, ​privacy ​protocol) Zabbix receives an ERROR from net-snmpexcept for wrong //Privacy passphrase// ​in which case Zabbix receives a TIMEOUT error from net-snmp. 
 + 
 +<note warning>​Server/​proxy restart is required for changes in //​Authentication protocol//, //​Authentication passphrase//,​ //Privacy protocol// or //Privacy passphrase// ​to take effect.</​note>​
  
 == Example 1 == == Example 1 ==
Line 107: Line 124:
  
   * regular SNMP items;   * regular SNMP items;
-  * [[manual:config:items:itemtypes:snmp:dynamicindex|SNMP items with dynamic indexes]];​ +  * [[:manual/config/items/itemtypes/snmp/dynamicindex|SNMP items with dynamic indexes]];​ 
-  * [[manual:discovery:low_level_discovery#​discovery_of_snmp_oids|SNMP low-level discovery rules]].+  * [[:manual/discovery/low_level_discovery/snmp_oids|SNMP low-level discovery rules]].
  
 All SNMP items on a single interface with identical parameters are scheduled to be queried at the same time. The first two types of items are taken by pollers in batches of at most 128 items, whereas low-level discovery rules are processed individually,​ as before. All SNMP items on a single interface with identical parameters are scheduled to be queried at the same time. The first two types of items are taken by pollers in batches of at most 128 items, whereas low-level discovery rules are processed individually,​ as before.