RMM Auto-Discovery

CMDB integrates with RMM to automatically discover and import enrolled devices as configuration items. This eliminates manual data entry and ensures your asset inventory stays current as devices are added or removed from client environments.

How Discovery Works

1. RMM pushes device data to CMDB via the integration API
2. CMDB creates a discovery result for each device in pending status
3. You review pending results and either match to an existing CI or create a new CI
4. Matched/created CIs maintain a link to the RMM device via rmm_device_id

Configuring Discovery

1. Navigate to Discovery in the sidebar
2. Configure the following settings:

Setting	Description	Default
Enabled	Master toggle for all discovery	Off
RMM Sync	Enable RMM device import	Off
Network Scan	Enable network-based discovery	Off
Scan Interval	Hours between automatic syncs	6 hours
Auto-Create CIs	Automatically create CIs from new devices (skip manual approval)	Off
Default CI Type	CI type assigned to auto-created items	—

3. Click Save Configuration

💡

Start with auto-create disabled so you can review the first batch of discovered devices. Once you're confident in the mapping, enable auto-create to reduce manual work.

What Gets Discovered

Each RMM sync captures:

Field	Description
Hostname	Device network name
IP Addresses	All detected IP addresses
MAC Address	Network interface MAC
Operating System	OS name (Windows 11, macOS, Ubuntu)
OS Version	Specific version/build
Manufacturer	Hardware manufacturer
Model	Hardware model
Serial Number	Manufacturer serial
Installed Software	List of installed applications

Reviewing Discovery Results

1. Navigate to Discovery
2. The results table shows all discovered devices with their current status:
   • Pending — awaiting review
   • Matched — linked to an existing CI
   • New — CI was created from this discovery
   • Ignored — manually dismissed
3. For each pending result, you can:
   • Match to Existing CI — link this device to a CI already in your inventory
   • Create New CI — create a new configuration item from the discovered data
   • Ignore — dismiss this result (it won't appear again unless re-discovered)

Manual Sync

To trigger a sync outside the scheduled interval:

1. Navigate to Discovery
2. Click Sync Now
3. CMDB sends a request to RMM and processes the response
4. New discovery results appear in the table within seconds

Handling Sync Conflicts

When a discovered device matches an existing CI but has different data (e.g., hostname changed, IP changed):

• Discovery creates a new pending result showing the updated information
• Review the changes and decide whether to update the existing CI or ignore the difference
• If auto-create is enabled, changes to known devices do not create duplicate CIs — they update the existing matched record

⚠️Duplicate Prevention:

CMDB matches discovered devices to existing CIs using the rmm_device_id field. If you manually create CIs without RMM links, auto-discovery may create duplicates. Always link CIs to their RMM device ID when possible.

Discovery Sources

Source	Status
RMM	Fully operational — devices sync on configured interval
Network Scan	Configuration available — agent-based network scanning planned
Manual	Always available — create CIs directly
Import	Always available — CSV/JSON/IT Glue import

Next Steps

• Configuration Items — Managing discovered CIs
• Defend Integration — Security context for discovered devices
• Integrations — Full integration details