Edge Devices Issues

Troubleshoot common Xyte Edge device issues using the table below.

Scenario or error	Likely meaning	Recommended next steps
Device cannot be added even though Edge is online	The internal container may not have connectivity to the device.	If the device IP is `192.168.1.99`, run these checks: 1. Run `docker ps` 2. Enter the `xyte_edge` container: `docker exec -it xyte_edge bash` 3. Run `docker ps` again from inside the container, if applicable 4. Enter the second container: `docker exec -it container_id bash` 5. Ping the device: `ping 192.168.1.99` You can also ping the device using the ping command in the Edge agent device overview page. #Replace the ip with your own host ip (192.168.1.99 is just an example)
Multiple Edge devices are falling offline at the same time	This usually points to a broader Edge-agent or network issue.	Check in this order: 1. If the Edge agent itself is offline, start here: Edge offline troubleshooting 2. If only a specific device cannot be reached, try using the ping command from the Edge agent

Scenario or error

Likely meaning

Recommended next steps

Device cannot be added even though Edge is online

The internal container may not have connectivity to the device.

If the device IP is 192.168.1.99, run these checks:
1. Run docker ps
2. Enter the xyte_edge container: docker exec -it xyte_edge bash
3. Run docker ps again from inside the container, if applicable
4. Enter the second container: docker exec -it container_id bash
5. Ping the device: ping 192.168.1.99

You can also ping the device using the ping command in the Edge agent device overview page.

#Replace the ip with your own host ip (192.168.1.99 is just an example)

Multiple Edge devices are falling offline at the same time

This usually points to a broader Edge-agent or network issue.

Check in this order:
1. If the Edge agent itself is offline, start here: Edge offline troubleshooting
2. If only a specific device cannot be reached, try using the ping command from the Edge agent