Skip to main content

Agent troubleshooting

Get help resolving common agent issues.

Bootstrap failures​

When experiencing bootstrap failures, verify that the enrollment token remains valid and has not expired while checking network connectivity to NetFoundry infrastructure. Ensure the system has adequate resources and permissions for agent operation, and review agent logs for specific error messages that can guide troubleshooting efforts.

Connection problems​

Address connection problems by verifying outbound network connectivity on required ports and checking firewall and proxy configurations that might block communications. Validate system time synchronization and monitor agent status, restarting the service if necessary to restore connectivity.

Performance issues​

Monitor system resources including CPU, memory, and network utilization to identify potential bottlenecks while checking for bandwidth limitations or network congestion. Consider the agent's placement relative to backend services, as proximity can significantly impact performance and response times.

General diagnostic steps​

  1. Agent Status Verification: Check agent status through management APIs to verify connectivity and operation.

  2. Network Connectivity Testing: Validate outbound connectivity to NetFoundry infrastructure endpoints.

  3. Log Analysis: Review agent logs for error messages, warnings, and diagnostic information.

  4. Resource Monitoring: Monitor system resources to ensure adequate capacity for agent operation.