Uploaded image for project: 'ZABBIX BUGS AND ISSUES'
  1. ZABBIX BUGS AND ISSUES
  2. ZBX-26587

Incomplete SNMP OID usage help in Zabbix UI while creating SNMP agent item

XMLWordPrintable

    • Icon: Incident report Incident report
    • Resolution: Won't fix
    • Icon: Trivial Trivial
    • None
    • 7.0.15
    • None

      Steps to reproduce:

      1. Configure SNMP on your test machine so that it responds to 1.3.6.1.2.1.2.2.1.2.
      2. Check it like so from Linux command line:
        snmpwalk -v2c -c public 127.0.0.1 1.3.6.1.2.1.2.2.1.2
        iso.3.6.1.2.1.2.2.1.2.1 = STRING: "lo"
        iso.3.6.1.2.1.2.2.1.2.2 = STRING: "enp0s3"
        iso.3.6.1.2.1.2.2.1.2.3 = STRING: "enp0s8"
        
      1. Add SNMP interface to a Zabbix host.
      2. Open dialog for creating a Zabbix item on the host.
      3. Enter arbitrary item name.
      4. Choose type SNMP agent type.
      5. Enter arbitrary item key.
      6. Select the SNMP host interface.
      7. Set SNMP OID:
        discovery[{#IF.DESCR},1.3.6.1.2.1.2.2.1.2]
      8. Set update interval you wish.
      9. Finish creating the item.
      10. Go to latest data and make sure it is operational and collects data like so:
        2025-06-19 05:41:51 PM	
        
        [{"{#SNMPINDEX}":"1","{#IF.DESCR}":"lo"},{"{#SNMPINDEX}":"2","{#IF.DESCR}":"enp0s3"},{"{#SNMPINDEX}":"3","{#IF.DESCR}":"enp0s8"}]
        

      Result:

      1. If you go back to the item creation edit dialog and hover the mouse over the sign near the SNMP OID field, there are walk[], get[] and OID options described. However, discovery[] option is not described.
        See screenshot
      2. The documentation page https://www.zabbix.com/documentation/7.0/en/manual/discovery/low_level_discovery/examples/snmp_oids_walk does not describe the discovery[] option. However, it looks like it used to describe it https://www.zabbix.com/documentation/3.4/en/manual/discovery/low_level_discovery/snmp_oids. It was described for a discovery rule, not for an item, but I failed to find a similar description anywhere in modern documentation.

      Expected:

      1. The help in Zabbix fronted should display possibility to use discovery[] in SNMP OID field.
      2. discovery[] syntax of SNMP OID field should be documented.

      Note:
      Observed at Zabbix 7.0. Other versions were not checked (yet).

            zabbix.dev Zabbix Development Team
            mprihodko Mihails Prihodko
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: