Network Discovery
Network Discovery scans a range of your network, finds the devices that are actually there, makes a best guess at what each one is, and lets you add them to your inventory in a few clicks. It’s the fastest way to onboard a new site or fill in gaps in your existing inventory.
Network Discovery: pick the collector and what to scan, choose how thorough the probe should be, and start. Results stream in below as hosts answer.
What you can scan
Section titled “What you can scan”Open Explore → Discovery. There are two ways to choose what gets scanned, and both stay inside the networks the collector is already allowed to reach:
| What you pick | How | Scans |
|---|---|---|
| A configured network | The guided flow — pick one of your networks and the collector that serves it, and the range fills in for you. | The whole network. |
| One host | Choose Enter a single host instead and type a single address, either 192.0.2.12 or 192.0.2.12/32. |
That one address. |
Then pick the collector that should run the scan and click Scan.
A scan always runs from a collector, so the collector you pick has to be allowed to reach the target. For a single host, GridNMS checks that the address falls inside one of that collector’s assigned networks before the scan starts — if it doesn’t, the scan is refused rather than run against a network the collector shouldn’t touch. See Networks & Sites to assign one.
Scanning a whole network needs port scanning turned on
Section titled “Scanning a whole network needs port scanning turned on”A whole-network scan runs only on a network that has been allowed to be port-scanned. On Configure → Sites & Networks, open the network and turn on Enable port scanning on this network. That is all discovery needs.
The switch under it, Scheduled scans, is a separate choice: it also scans the network automatically at the interval you pick. Leave it off and nothing is scanned until you start a discovery yourself. Turning port scanning off turns the schedule off too, so turning it back on later does not quietly restart recurring scans.
Networks that were already being scanned automatically keep doing so on the same interval. Scanning a whole network on demand needs a collector updated to version 0.67 or later; scanning one host does not.
What discovery probes
Section titled “What discovery probes”For each address in range, GridNMS checks a series of signals to decide whether something is there and what it might be:
- Ping (ICMP) — is the host alive and reachable?
- Common TCP ports — are well-known ports open (for example SSH, HTTPS, SNMP-adjacent management ports)?
- Service probes — lightweight checks against responding ports to identify the service.
- Reverse DNS — does the address resolve to a hostname? If so, that name is suggested for the device. This only happens for networks that have DNS lookups for hosts turned on (see Hosts); it is off by default.
The combination of these signals lets discovery distinguish a live router from an unused address, and a switch from a server.
Aggressiveness profiles
Section titled “Aggressiveness profiles”Discovery offers three profiles that trade thoroughness against speed and network load. Pick one with the Low / Medium / High selector before scanning.
| Profile | What it does | When to use it |
|---|---|---|
| Low | Minimal probing — mostly ping and a few key ports. Fast and gentle. | Large ranges, sensitive networks, or a quick “what’s alive?” sweep. |
| Medium | A balanced set of port and service probes. The default for most scans. | Day-to-day discovery of a subnet or site. |
| High | The most thorough probing across more ports and services. Slower and chattier. | A new site you’re onboarding from scratch, where you want the richest fingerprints. |
If you need the same non-default probing behavior repeatedly, save it as a Probe Profile and pick it from the dropdown next to the scanner instead of the Low/Medium/High buttons — selecting a saved profile overrides the aggressiveness selector for that scan.
Watching progress
Section titled “Watching progress”Once a scan starts, the page shows live progress — how many addresses have been checked, how many responded, and which devices have been fingerprinted so far. Results stream in as they’re found, so you don’t have to wait for the whole range to finish before reviewing what’s already been discovered.
You can stop a scan early if you’ve already found what you were looking for.
Device fingerprinting
Section titled “Device fingerprinting”For each responding host, discovery makes a best guess at the vendor and device type based on the signals it gathered. These guesses pre-fill the device’s suggested class (Router, Switch, Firewall, Server, and so on) and, where reverse DNS resolved, its suggested name.
Reviewing and adding results
Section titled “Reviewing and adding results”When the scan finishes (or as results arrive), each discovered host appears in a results table with its address, ping result, open ports and UDP services, suggested name, suggested class, and a Known Device column that marks which hosts are already in your inventory and which are new.
To bring new hosts into inventory:
- Review the results and uncheck anything you don’t want to add (unused addresses, third-party gear you don’t manage, and so on).
- Adjust the suggested name or class for any host if the fingerprint guessed wrong, and fill in a Location if you want one. Every selected host needs a class before it can be added.
- Click Add Selected to create the devices in bulk. They are assigned to the collector that ran the scan.
The new devices appear immediately in your device list, and GridNMS begins monitoring them shortly after — though you may still need to add SNMP or SSH credentials before they report detailed metrics.
A typical workflow
Section titled “A typical workflow”- Pick the new site’s network in the Networks panel on the left (add it under Networks & Sites first if it isn’t listed).
- Choose the collector at that site and set the profile to High for the first sweep.
- Click Scan and watch results stream in.
- Review the fingerprints, correct any obvious mis-classifications, and uncheck addresses you don’t manage.
- Click Add Selected to bulk-add.
- Add credentials and let monitoring fill in the detail.
Where to go next
Section titled “Where to go next”- Manage what you discovered in Devices & Inventory.
- See how the new devices connect in Graph Explorer.
- Learn how collectors reach your networks in Collectors.
docs built 2026-11-12 · 945a2dec2