Getting Started
Sync data from your devices
Learn how ITVA collects data from your devices, and sync a device manually from its device page.
In this guide, you sync data from a device by hand and confirm that the sync worked. You also learn how ITVA collects data, so you know when to use a schedule.
Before you begin
- You have a probe that shows as online. See Add your first probe.
- You have added at least one device. See Add your first device.
How syncing works
A sync collects data from a device and saves it in ITVA. The probe connects to the device with the device's protocol, port, and credentials. Then the probe sends the results to ITVA.
Devices that you add through a controller, such as Cisco Meraki and Ubiquiti, are different. For these devices, the ITVA platform calls the controller's API directly, not through the probe.
A sync can collect system info, device metrics, interfaces, VRFs, ARP and MAC tables, VLANs, LLDP and CDP neighbors, and IS-IS, OSPF, and BGP entries. It can also run a health check and back up the device's configuration.
ITVA does not sync a device when you add it. A new device has no data until you sync it by hand or a schedule syncs it.
Sync a device manually
- In the portal, open the device.
- Open the actions menu dropdown next to Test Connection.
- Select Sync Data.
- In Checks, select the data to collect. To change all checks at once, select All or None next to Select.
- Select Sync.
Keep the dialog open while the sync runs. The dialog shows the progress and the log.
Check that it worked
- While the sync runs, make sure the dialog shows Syncing with the device name.
- When the sync is done, read the Log. Each check has a line such as
[Interfaces] sync succeeded. - Make sure the log ends with the start time, the completion time, and the duration.
- Close the dialog and open the device's tabs, such as Interfaces, to see the new data.
Troubleshooting
If a line in the log shows sync failed with an error, the probe could not collect that data. Do these checks:
- Open the actions menu and select Test Connection.
- If the test fails, make sure the probe host can reach the device on the management port.
- Make sure the device's credentials are correct.
- Make sure the device uses the protocol and port in Supported vendors.
If only one check fails, the device might not support that data. For example, a switch has no firewall objects.
Keep your data up to date
A manual sync runs only when you start it. To sync your devices automatically, create your first schedule.