SNMP Discovery but assigned network range by site.

[giffordj]

Enhancement: Support Network Range Configuration for SNMP Targets in Orb-Agent

Summary

Currently, the orb-agent only supports individual SNMP target configuration. This creates operational overhead when managing multiple devices within the same network segment. We should enhance the orb-agent to support network range assignment based on site configuration.

Current Behavior

• Orb-agent requires individual IP addresses for each SNMP target
• Each device must be manually configured and maintained
• Configuration becomes unwieldy for sites with many network devices

Proposed Enhancement

Enable orb-agent to accept network ranges (CIDR notation) assigned to sites, allowing automatic discovery and monitoring of SNMP-enabled devices within the specified range.

Proposed Implementation

1. Configuration Schema Update:

   sites:
     - name: "datacenter-1"
       snmp_ranges:
         - "192.168.1.0/24"
         - "10.0.100.0/26"

2. Discovery Mechanism:

   • Periodic network scanning within defined ranges
   • SNMP availability checks before adding targets
   • Configurable discovery intervals

3. Device Management:

   • Automatic addition of responsive SNMP devices
   • Graceful handling of offline/unreachable devices
   • Optional device filtering based on SNMP system descriptions

This enhancement aligns with common network monitoring patterns where devices are logically grouped by network segments corresponding to physical sites or organizational boundaries.

[leoparente]

hi @giffordj we have partially implemented that:
now target supports iprange/subnets see https://github.com/netboxlabs/orb-agent/blob/develop/docs/backends/snmp_discovery.md#scope-section

If you specify subnet/range, we will test connection once, and for each responding snmp service, we spinup a job based on the defined scheduler.

To test it, pull the latest develop image with

docker pull netboxlabs/orb-agent:develop

and run discovery using it. We expect the feature to be in snmp discovery version 1.13.0, you can check in the container logs like below

{"time":"2025-12-22T15:54:08.07429322Z","level":"INFO","msg":"snmp-discovery readiness ok, got version ","backend":"snmp_discovery","snmp_discovery_version":"1.13.0"}

Please, your feedback/validation in that ticket would be really appreciated.

[leoparente]

hi @giffordj the changes were released as well and the latest docker tag can be used. Orb-agent should show version 2.6.0 in logs. Your feedback on that is appreciated.