netbox-discovery
Installation
SKILL.md
NetBox Discovery (Orb Agent)
Your knowledge of Orb Agent may be outdated. Discovery backends, configuration options, and supported platforms change between releases. Prefer retrieval over pre-trained knowledge.
Retrieval Sources
| Source | URL / Method | Use for |
|---|---|---|
| Discovery docs | https://netboxlabs.com/docs/discovery/ |
Product overview, getting started |
| Orb Agent docs | https://netboxlabs.com/docs/orb-agent/ |
Configuration, backends, secrets |
| Config examples | https://netboxlabs.com/docs/orb-agent/config_samples/ |
Sample agent.yaml files |
| Orb Agent repo | https://github.com/netboxlabs/orb-agent |
Source, docs/ (authoritative key names), changelog |
| NetBox MCP server | If configured — verify discovered objects in NetBox | Post-discovery validation |
Introduction
Orb Agent is a Docker-based network discovery agent that automatically discovers infrastructure and ingests it into NetBox via Diode. It ships five discovery backends — network (NMAP), device (NAPALM), SNMP, gNMI, and custom worker — plus observability backends (snmp_telemetry, gnmi_telemetry, pktvisor, OpenTelemetry Infinity) that export metrics over OTLP and ingest nothing into NetBox. All are configured through a single YAML file.
Data flow: Orb Agent → gRPC → Diode Server → Diode NetBox Plugin → NetBox