SNMPDSC Not Respecting Timeout Setting

[SCUR0]

Is there an existing issue for this?

• I have searched the existing open and closed issues and I checked the docs https://jokob-sk.github.io/NetAlertX/

The issue occurs in the following browsers. Select at least 2.

• Firefox
• Chrome
• Edge
• Safari (unsupported) - PRs welcome
• N/A - This is an issue with the backend

Current Behavior

Returns output:

15:43:45 ['[plugin_helper] reading config file\n15:43:34 [\'[SNMPDSC] In script \']\n15:43:34 [\'[SNMPDSC] Router snmpwalk command: \', \'snmpwalk -CommunityPassword -v 1 10.1.1.1 .1.3.6.1.2.1.3.1.1.2\']\nTraceback (most recent call last):\n  File "/app/front/plugins/snmp_discovery/script.py", line 127, in <module>\n    main()\n  File "/app/front/plugins/snmp_discovery/script.py", line 67, in main\n    output = subprocess.check_output (snmpwalkArgs, universal_newlines=True, stderr=subprocess.STDOUT, timeout=(timeoutSec ))\n             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n  File "/usr/lib/python3.12/subprocess.py", line 466, in check_output\n    return run(*popenargs, stdout=PIPE, timeout=timeout, check=True,\n           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n  File "/usr/lib/python3.12/subprocess.py", line 550, in run\n    stdout, stderr = process.communicate(input, timeout=timeout)\n                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n  File "/usr/lib/python3.12/subprocess.py", line 1209, in communicate\n    stdout, stderr = self._communicate(input, endtime, timeout)\n                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n  File "/usr/lib/python3.12/subprocess.py", line 2116, in _communicate\n    self._check_timeout(endtime, orig_timeout, stdout, stderr)\n  File "/usr/lib/python3.12/subprocess.py", line 1253, in _check_timeout\n    raise TimeoutExpired(\nsubprocess.TimeoutExpired: Command \'[\'snmpwalk\', \'-CommunityPassword\', \'-v\', \'1\', \'10.1.1.1\', \'.1.3.6.1.2.1.3.1.1.2\']\' timed out after 10 seconds\n']
15:43:45 ['[Plugins] No output received from the plugin "SNMPDSC"']

timed out after 10 seconds never changes to higher numbers regardless of input.

I have a very large network (25+ /16)
I want to save time and energy and run SNMP discoveries from the core l3 switch.
Timing the SNMP walks it requires at least 30 seconds.

Expected Behavior

Respecting the input put in timeout

Steps To Reproduce

1. Set timeout higher than 10 seconds
2. Run schedule

app.conf

docker-compose.yml

What installation are you running?

Production (netalertx)

app.log

No response

Debug enabled

• I have read and followed the steps in the wiki link above and provided the required debug logs and the log section covers the time when the issue occurs.

[jokob-sk]

This should be available in the next release. It would be great if you could test this.

You can try mounting and thus replacing the

/app/front/plugins/snmp_discovery/script.py

with:

https://github.com/jokob-sk/NetAlertX/blob/main/front/plugins/snmp_discovery/script.py

Make sure you refresh your browser cache - and click the 🔄 refresh button in the top right corner.

Thanks in advance,
j

[SCUR0]

I copied the file to the path you described.
Still not working.
I truncated the output for the snmpwalk because otherwise it was thousands of IPs

11:10:42 ['[', datetime.datetime(2025, 10, 27, 11, 10, 42, tzinfo=<DstTzInfo 'America/Los_Angeles' PDT-1 day, 17:00:00 DST>), '] START Run: ', 'SNMPDSC']
11:10:42 ['[Plugins] Executing: ', 'python3 /app/front/plugins/snmp_discovery/script.py routers={s-quote}{routers}{s-quote}']
11:10:42 ['[SNMPDSC] In script ']
11:10:42 ['[SNMPDSC] Router snmpwalk command: ', 'snmpwalk -c Password -v 1 10.1.1.1 .1.3.6.1.2.1.4.22.1.2']
11:11:07 ["[Plugins] Output: [plugin_helper] reading config file\n11:10:42 ['[SNMPDSC] In script ']\n11:10:42 ['[SNMPDSC] Router snmpwalk command: ', 'snmpwalk -c Password -v 1 10.1.1.1 .1.3.6.1.2.1.4.22.1.2']\n11:11:07 ['[SNMPDSC] output: ', 'IP-MIB::ipNetToMediaPhysAddress.67.10.0.0.1 = STRING: 0:8:e3:ff:fc:4\\nIP-MIB::ipNetToMediaPhysAddress.90.10.2.1.1 = STRING: 0:8:e3:ff:fc:4\\n']\n11:11:07 ['[SNMPDSC] Entries found: ', 0]\n"]
11:11:07 ['[Plugins] Processed and deleted file: /app/log/plugins/last_result.SNMPDSC.log ']
11:11:07 ['[Plugins] No output received from the plugin "SNMPDSC"']
11:11:07 ['[', datetime.datetime(2025, 10, 27, 11, 11, 7, tzinfo=<DstTzInfo 'America/Los_Angeles' PDT-1 day, 17:00:00 DST>), '] END Run: ', 'SNMPDSC']
11:11:07 ['[UserEventsQueueInstance] Processed event: ', 'run']
11:11:07 ['[check_and_run_user_event] INFO: Executed events: ', 'run with param SNMPDSC']

I changed log level to debug but I don't get any other details.
I tried a snmp v2 walk, same error.
snmpwalk -v2c -Oxsq -c Password 10.1.1.1 .1.3.6.1.2.1.4.22.1.2
I tried running my exact snmpwalks to terminal and it is generating output. It looks like the following:

ipNetToMediaPhysAddress[382][10.0.6.1] 0:8:e3:ff:fc:4
ipNetToMediaPhysAddress[382][10.0.6.2] 0:15:5d:1:53:3
ipNetToMediaPhysAddress[382][10.0.6.3] 4a:43:72:59:7d:a3

[SCUR0]

Here the related sections in app.conf

# General
#---------------------------
LOADED_PLUGINS=['ARPSCAN','AVAHISCAN','CSVBCKP','DBCLNP','DIGSCAN','INTRNT','MAINT','NEWDEV','NBTSCAN','NSLOOKUP','NTFPRCS','SETPWD','SMTP','SYNC','VNDRPDT','WORKFLOWS','UI','CUSTPROP','DHCPSRVS','SNMPDSC','ICMP']
LOADED_PLUGINS__metadata="{}"
DISCOVER_PLUGINS=True
DISCOVER_PLUGINS__metadata="{}"
SCAN_SUBNETS=['--localnet','10.1.0.0/16 --interface=eth1']
SCAN_SUBNETS__metadata="{}"
LOG_LEVEL='verbose'
LOG_LEVEL__metadata="{}"
TIMEZONE='America/Los_Angeles'
TIMEZONE__metadata="{}"
PLUGINS_KEEP_HIST=250
PLUGINS_KEEP_HIST__metadata="{}"
REPORT_DASHBOARD_URL='http://netalertx-dov1.domain.net'
REPORT_DASHBOARD_URL__metadata="{}"
DAYS_TO_KEEP_EVENTS=90
DAYS_TO_KEEP_EVENTS__metadata="{}"
HRS_TO_KEEP_NEWDEV=0
HRS_TO_KEEP_NEWDEV__metadata="{}"
HRS_TO_KEEP_OFFDEV=0
HRS_TO_KEEP_OFFDEV__metadata="{}"
CLEAR_NEW_FLAG=0
CLEAR_NEW_FLAG__metadata="{}"
REFRESH_FQDN=False
REFRESH_FQDN__metadata="{}"
API_CUSTOM_SQL='SELECT * FROM Devices WHERE devPresentLastScan = 0'
API_CUSTOM_SQL__metadata="{}"
VERSION='1760739635'
VERSION__metadata="{}"
NETWORK_DEVICE_TYPES=['AP','Access Point','Gateway','Firewall','Hypervisor','Powerline','Switch','WLAN','PLC','Router','USB LAN Adapter','USB WIFI Adapter','Internet']
NETWORK_DEVICE_TYPES__metadata="{}"
GRAPHQL_PORT=20212
GRAPHQL_PORT__metadata="{}"
API_TOKEN='t_f5miy86YkcL71uyt07n3'
API_TOKEN__metadata="{}"
# SNMPDSC
#---------------------------
SNMPDSC_RUN='disabled'
SNMPDSC_RUN__metadata="{\"function\": \"RUN\", \"events\": [\"run\"], \"type\": {\"dataType\": \"string\", \"elements\": [{\"elementType\": \"select\", \"elementOptions\": [], \"transformers\": []}]}, \"default_value\": \"disabled\", \"options\": [\"disabled\", \"once\", \"schedule\", \"always_after_scan\", \"on_new_device\"], \"localized\": [\"name\", \"description\"], \"name\": [{\"language_code\": \"en_us\", \"string\": \"When to run\"}, {\"language_code\": \"es_es\", \"string\": \"Cu\\u00e1ndo ejecutar\"}], \"description\": [{\"language_code\": \"en_us\", \"string\": \"Enable import of devices from a SNMP enabled device. If you select <code>schedule</code> the scheduling settings from below are applied. If you select <code>once</code> the scan is run only once on start of the application (container) or after you update your settings. \\u26a0 Use the same schedule if you have multiple <i class=\\\"fa-solid fa-magnifying-glass-plus\\\"></i> Device scanners enabled.\"}, {\"language_code\": \"es_es\", \"string\": \"Habilite la importaci\\u00f3n de dispositivos desde un dispositivo habilitado para SNMP. Si selecciona <code>schedule</code>, se aplican las configuraciones de programaci\\u00f3n de abajo. Si selecciona <code>once</code>, el an\\u00e1lisis se ejecuta solo una vez al inicio de la aplicaci\\u00f3n (contenedor) o despu\\u00e9s de actualizar su configuraci\\u00f3n.\"}]}"
SNMPDSC_CMD='python3 /app/front/plugins/snmp_discovery/script.py routers={s-quote}{routers}{s-quote}'
SNMPDSC_CMD__metadata="{\"function\": \"CMD\", \"type\": {\"dataType\": \"string\", \"elements\": [{\"elementType\": \"input\", \"elementOptions\": [], \"transformers\": []}]}, \"default_value\": \"python3 /app/front/plugins/snmp_discovery/script.py routers={s-quote}{routers}{s-quote}\", \"options\": [], \"localized\": [\"name\", \"description\"], \"name\": [{\"language_code\": \"en_us\", \"string\": \"Command\"}, {\"language_code\": \"es_es\", \"string\": \"Comando\"}], \"description\": [{\"language_code\": \"en_us\", \"string\": \"Command to run. Not recommended to change.\"}, {\"language_code\": \"es_es\", \"string\": \"Comando para ejecutar. No se recomienda cambiar.\"}]}"
SNMPDSC_routers=['snmpwalk -c Password -v 1 10.1.1.1 .1.3.6.1.2.1.4.22.1.2']
SNMPDSC_routers__metadata="{\"function\": \"routers\", \"type\": {\"dataType\": \"array\", \"elements\": [{\"elementType\": \"input\", \"elementOptions\": [{\"placeholder\": \"Enter value\"}, {\"suffix\": \"_in\"}, {\"cssClasses\": \"col-sm-10\"}, {\"prefillValue\": \"null\"}], \"transformers\": []}, {\"elementType\": \"button\", \"elementOptions\": [{\"sourceSuffixes\": [\"_in\"]}, {\"separator\": \"\"}, {\"cssClasses\": \"col-xs-12\"}, {\"onClick\": \"addList(this, false)\"}, {\"getStringKey\": \"Gen_Add\"}], \"transformers\": []}, {\"elementType\": \"select\", \"elementHasInputValue\": 1, \"elementOptions\": [{\"multiple\": \"true\"}, {\"readonly\": \"true\"}, {\"editable\": \"true\"}], \"transformers\": []}, {\"elementType\": \"button\", \"elementOptions\": [{\"sourceSuffixes\": []}, {\"separator\": \"\"}, {\"cssClasses\": \"col-xs-6\"}, {\"onClick\": \"removeAllOptions(this)\"}, {\"getStringKey\": \"Gen_Remove_All\"}], \"transformers\": []}, {\"elementType\": \"button\", \"elementOptions\": [{\"sourceSuffixes\": []}, {\"separator\": \"\"}, {\"cssClasses\": \"col-xs-6\"}, {\"onClick\": \"removeFromList(this)\"}, {\"getStringKey\": \"Gen_Remove_Last\"}], \"transformers\": []}]}, \"default_value\": [\"snmpwalk -v 2c -c public -OXsq 192.168.1.1 .1.3.6.1.2.1.3.1.1.2\"], \"options\": [], \"localized\": [\"name\", \"description\"], \"name\": [{\"language_code\": \"en_us\", \"string\": \"Routers\"}, {\"language_code\": \"es_es\", \"string\": \"Routers\"}], \"description\": [{\"language_code\": \"en_us\", \"string\": \"A list of <code>snmpwalk</code> commands to execute against IP addresses of roputers/switches with SNMP turned on. <br/> <br/> Example with the router on the IP <code>192.168.1.1</code>: <br/> <code>snmpwalk -v 2c -c public -OXsq 192.168.1.1 .1.3.6.1.2.1.3.1.1.2</code> <br/><br/> Only IPv4 supported. Authentication is not supported. More info on the plugin <a href='https://github.com/jokob-sk/NetAlertX/tree/main/front/plugins/snmp_discovery' target='_blank'>here</a>.\"}, {\"language_code\": \"es_es\", \"string\": \"Una lista de comandos <code>snmpwalk</code> para ejecutar en direcciones IP de computadoras/conmutadores con SNMP activado. <br/> <br/> Ejemplo con el enrutador en la IP <code>192.168.1.1</code>: <br/> <code>snmpwalk -v 2c -c public -OXsq 192.168.1.1 .1.3.6.1. 2.1.3.1.1.2</code> <br/><br/> Solo se admite IPv4. No se admite la autenticaci\\u00f3n. M\\u00e1s informaci\\u00f3n sobre el complemento <a href='https://github.com/jokob-sk/NetAlertX/tree/main/front/plugins/snmp_discovery' target='_blank'>aqu\\u00ed</a>.\"}]}"
SNMPDSC_RUN_SCHD='*/10 * * * *'
SNMPDSC_RUN_SCHD__metadata="{\"function\": \"RUN_SCHD\", \"type\": {\"dataType\": \"string\", \"elements\": [{\"elementType\": \"span\", \"elementOptions\": [{\"cssClasses\": \"input-group-addon validityCheck\"}, {\"getStringKey\": \"Gen_ValidIcon\"}], \"transformers\": []}, {\"elementType\": \"input\", \"elementOptions\": [{\"onChange\": \"validateRegex(this)\"}, {\"base64Regex\": \"Xig/OlwqfCg/OlswLTldfFsxLTVdWzAtOV18WzAtOV0rLVswLTldK3xcKi9bMC05XSspKVxzKyg/OlwqfCg/OlswLTldfDFbMC05XXwyWzAtM118WzAtOV0rLVswLTldK3xcKi9bMC05XSspKVxzKyg/OlwqfCg/OlsxLTldfFsxMl1bMC05XXwzWzAxXXxbMC05XSstWzAtOV0rfFwqL1swLTldKykpXHMrKD86XCp8KD86WzEtOV18MVswLTJdfFswLTldKy1bMC05XSt8XCovWzAtOV0rKSlccysoPzpcKnwoPzpbMC02XXxbMC02XS1bMC02XXxcKi9bMC05XSspKSQ=\"}], \"transformers\": []}]}, \"default_value\": \"0 2 * * *\", \"options\": [], \"localized\": [\"name\", \"description\"], \"name\": [{\"language_code\": \"en_us\", \"string\": \"Schedule\"}, {\"language_code\": \"es_es\", \"string\": \"Schedule\"}], \"description\": [{\"language_code\": \"en_us\", \"string\": \"Only enabled if you select <code>schedule</code> in the <a href=\\\"#SNMPDSC_RUN\\\"><code>SNMPDSC_RUN</code> setting</a>. Make sure you enter the schedule in the correct cron-like format (e.g. validate at <a href=\\\"https://crontab.guru/\\\" target=\\\"_blank\\\">crontab.guru</a>). For example entering <code>0 4 * * *</code> will run the scan after 4 am in the <a onclick=\\\"toggleAllSettings()\\\" href=\\\"#TIMEZONE\\\"><code>TIMEZONE</code> you set above</a>. Will be run NEXT time the time passes. <br/> It's recommended to use the same schedule interval for all plugins responsible for discovering new devices. \"}, {\"language_code\": \"es_es\", \"string\": \"Solo est\\u00e1 habilitado si selecciona <code>schedule</code> en la configuraci\\u00f3n <a href=\\\"#SNMPDSC_RUN\\\"><code>SNMPDSC_RUN</code></a>. Aseg\\u00farese de ingresar la programaci\\u00f3n en el formato similar a cron correcto (por ejemplo, valide en <a href=\\\"https://crontab.guru/\\\" target=\\\"_blank\\\">crontab.guru</a>). Por ejemplo, ingresar <code>0 4 * * *</code> ejecutar\\u00e1 el escaneo despu\\u00e9s de las 4 a.m. en el <a onclick=\\\"toggleAllSettings()\\\" href=\\\"#TIMEZONE\\\"><code>TIMEZONE</ c\\u00f3digo> que configur\\u00f3 arriba</a>. Se ejecutar\\u00e1 la PR\\u00d3XIMA vez que pase el tiempo.\"}]}"
SNMPDSC_RUN_TIMEOUT=180
SNMPDSC_RUN_TIMEOUT__metadata="{\"function\": \"RUN_TIMEOUT\", \"type\": {\"dataType\": \"integer\", \"elements\": [{\"elementType\": \"input\", \"elementOptions\": [{\"type\": \"number\"}], \"transformers\": []}]}, \"default_value\": 5, \"options\": [], \"localized\": [\"name\", \"description\"], \"name\": [{\"language_code\": \"en_us\", \"string\": \"Run timeout\"}, {\"language_code\": \"es_es\", \"string\": \"Tiempo de espera de ejecuci\\u00f3n\"}, {\"language_code\": \"de_de\", \"string\": \"Wartezeit\"}], \"description\": [{\"language_code\": \"en_us\", \"string\": \"Maximum time in seconds to wait for the script to finish. If this time is exceeded the script is aborted.\"}, {\"language_code\": \"es_es\", \"string\": \"Tiempo m\\u00e1ximo en segundos para esperar a que finalice el script. Si se excede este tiempo, el script se cancela..\"}]}"
SNMPDSC_WATCH=['Watched_Value1']
SNMPDSC_WATCH__metadata="{\"function\": \"WATCH\", \"type\": {\"dataType\": \"array\", \"elements\": [{\"elementType\": \"select\", \"elementOptions\": [{\"multiple\": \"true\"}], \"transformers\": []}]}, \"default_value\": [\"Watched_Value1\"], \"options\": [\"Watched_Value1\", \"Watched_Value2\", \"Watched_Value3\", \"Watched_Value4\"], \"localized\": [\"name\", \"description\"], \"name\": [{\"language_code\": \"en_us\", \"string\": \"Watched\"}, {\"language_code\": \"es_es\", \"string\": \"Visto\"}], \"description\": [{\"language_code\": \"en_us\", \"string\": \"Send a notification if selected values change. Use <code>CTRL + Click</code> to select/deselect. <ul> <li><code>Watched_Value1</code> is Hostname (not discoverable) </li><li><code>Watched_Value2</code> is Router IP </li><li><code>Watched_Value3</code> is not used </li><li><code>Watched_Value4</code> is not used </li></ul>\"}, {\"language_code\": \"es_es\", \"string\": \"Env\\u00ede una notificaci\\u00f3n si los valores seleccionados cambian. Utilice <code>CTRL + clic</code> para seleccionar/deseleccionar. <ul> <li><code>Watched_Value1</code> es el nombre de host (no detectable) </li><li><code>Watched_Value2</code> es la IP del enrutador </li><li><code>Watched_Value3< /code> no se utiliza </li><li><code>Watched_Value4</code> no se utiliza </li></ul>\"}]}"
SNMPDSC_REPORT_ON=['new','watched-changed']
SNMPDSC_REPORT_ON__metadata="{\"function\": \"REPORT_ON\", \"type\": {\"dataType\": \"array\", \"elements\": [{\"elementType\": \"select\", \"elementOptions\": [{\"multiple\": \"true\"}], \"transformers\": []}]}, \"default_value\": [\"new\", \"watched-changed\"], \"options\": [\"new\", \"watched-changed\", \"watched-not-changed\", \"missing-in-last-scan\"], \"localized\": [\"name\", \"description\"], \"name\": [{\"language_code\": \"en_us\", \"string\": \"Report on\"}, {\"language_code\": \"es_es\", \"string\": \"Informar sobre\"}], \"description\": [{\"language_code\": \"en_us\", \"string\": \"Send a notification only on these statuses. <code>new</code> means a new unique (unique combination of PrimaryId and SecondaryId) object was discovered. <code>watched-changed</code> means that selected <code>Watched_ValueN</code> columns changed.\"}, {\"language_code\": \"es_es\", \"string\": \"Env\\u00ede una notificaci\\u00f3n solo en estos estados. <code>new</code> significa que se descubri\\u00f3 un nuevo objeto \\u00fanico (una combinaci\\u00f3n \\u00fanica de PrimaryId y SecondaryId). <code>watched-changed</code> significa que las columnas <code>Watched_ValueN</code> seleccionadas cambiaron.\"}]}"

and my docker compose:

services:
  netalertx:
    container_name: netalertx-dv1
    # use the below line if you want to test the latest dev image
    # image: "ghcr.io/jokob-sk/netalertx-dev:latest" 
    image: "ghcr.io/jokob-sk/netalertx:latest"      
    networks:
      10.1.1.1_net:
        ipv4_address: 10.1.3.102
      10.255.1.1_net:
        ipv4_address: 10.255.0.10
    restart: unless-stopped
    volumes:
      - ./netalertx-dv1/config:/app/config
      - ./netalertx-dv1/db:/app/db      
      # (optional) useful for debugging if you have issues setting up the container
      - ./netalertx-dv1/logs:/app/log
      # (API: OPTION 1) use for performance
      - type: tmpfs
        target: /app/api
      # (API: OPTION 2) use when debugging issues 
      # -  local_path/api:/app/api
    environment:
      - TZ=America/Los_Angeles      
      - PORT=80
networks:
  10.1.1.1_net:
    external: true
    name: 10.1.1.1_net
  10.255.1.1_net:
    external: true
    name: 10.255.1.1_net

Once I get SNMP working I plan to remove the 10.255 network

[SCUR0]

As an update I finally got it to work using -OXsq.
Any other format and it fails to parse properly.

[jokob-sk]

Thanks for the follow-up, adding "(the -OXsq is a required parameter)" to the description.