Fleet Management
Fleet Management
Register, credential, and monitor the Orb agents that perform NetBox Discovery, from the NetBox Labs Console.
Available inCommunityCloudEnterprise
Fleet Management is where you deploy and look after the Orb agents that perform Discovery. Agents are registered in the NetBox Labs Console, started with one command on your own infrastructure, and monitored from the Fleet management section of the Console navigation, alongside the credentials they use.
Public Preview - Fleet Management is in Public Preview for NetBox Cloud customers. It is included with NetBox Assurance. Contact your account team to enable it for your organization.
Key concepts
| Concept | What it is |
|---|---|
| Orb agent | A container you run on your own infrastructure that performs discovery and reports back. |
| Provisioning command | The command the Console generates when you register an agent. Running it on your host starts that agent and connects it to your organization. |
| Heartbeat | The signal an agent sends every 5 seconds. Five minutes of silence is what moves an agent to a stale state. |
| Label | A key and value you attach to an agent, for organizing and filtering your fleet. |
| Credential | A device username and password, held as a reference to your own vault and delivered to agents only when a job runs. |
| Discovery job | What an agent should look at, and how often. Jobs live under Assurance → Discovery jobs. |
How the pieces fit together
- You register an Orb agent in the Console and start it on your own infrastructure.
- You create credentials that point at secrets in your vault, and bind them to devices.
- You create a Discovery job, choosing targets, agents, and a schedule.
- The Console generates the agent policy and distributes it to the agents you chose.
- Agents run discovery and report what they find.
- What they find arrives as deviations for review in Assurance, where you decide what reaches NetBox.
Get started
- Register and start your first Orb agent, or follow the quickstart
- Add a device credential
- Create a Discovery job
Getting help
Contact your account team or NetBox Labs support.