Edge Agent Issues
Troubleshoot common Xyte Edge agent errors, offline states, invalid host names, and proxy ID conflicts.
Diagnose common Xyte Edge agent issues using the table below.
| Scenario or error | Likely meaning | Recommended next steps |
|---|---|---|
| Edge agent is in error | Host offline, device offline, or required traffic is blocked. | Check: 1. Docker container status (running, restarting, exited) 2. Network connectivity from the host 3. Network connectivity from inside the container: telnet eu1.edge.xyte.io 4434. Restart the Docker container If it still fails: 1. Remove Docker and reinstall it 2. Reinstall the Edge software again (fresh install) |
| Edge agent: Invalid params: invalid host name | The Edge ID format is wrong, or the value includes a hidden character or quote. | Try this: 1. Re-enter the Edge ID manually 2. Remove any extra quotes or hidden characters 3. Try the request again |
| Edge agent is offline | Start with offline troubleshooting, then verify outbound connectivity. | Start here: - Review the guide: Edge offline troubleshooting Then run these checks: 1. Run docker ps2. Enter the xyte_edge container: docker exec -it xyte_edge bash3. Run docker ps again from inside the container, if applicable4. Enter the second container: docker exec -it [container_id] bash5. Run telnet eu1.edge.xyte.io 443 |
| Edge agent: Proxy ID already exists | The proxy ID is already attached to another Edge device. | Next steps: 1. Delete the Edge agent in the UI that is currently using this proxy ID 2. After the old ID is released, add the Edge again with the same proxy ID |
Updated about 3 hours ago
What’s Next